JSON Stringify

相關推薦

什麼是 JSON Stringify（JSON 序列化與字串嵌入）？

適用場景

• 把 JSON 物件序列化為字串字面值，直接賦值給 JavaScript / Java / Python / Go 變數
• 把 API 響應中的 JSON 巢狀到另一個 JSON 欄位裡（外層 JSON 內的字串 value）
• 把 JSON 字串存進資料庫 TEXT 欄位、Redis value、訊息佇列 payload 等需要字串的儲存
• 把 JSON 字串作為 URL query 參數或 path 的一部分跨服務傳遞
• 在 Markdown、HTML、LaTeX 等文件中嵌入可讀 JSON 範例程式碼片段
• 把日誌/設定檔中的 JSON 字串反向解析為物件結構便於人工審閱

使用方法

1. 把 JSON 內容（物件 / 陣列 / 值）貼到左側輸入框，或點擊「範例」載入一個典型 JSON，或上傳 .json/.txt 檔案
2. 選擇處理模式：預設 Stringify（物件 → 嵌入字串），如需反向解析可點擊「Parse」切換為字串 → 物件
3. 在 Stringify 模式下根據需要切換 "Pretty"（2 空格縮排）或 "Compact"（單行）格式
4. 右側輸出框會即時顯示結果，確認後點擊「複製」把字串貼到程式碼 / 文件中，或點擊「下載」儲存為 stringified.txt / parsed.json

功能特點

• 雙向模式：支援 Stringify（JSON 物件 → 帶引號可嵌入字串）與 Parse（帶引號字串 → JSON 物件）雙向處理
• 智慧嵌入跳脫：在標準 JSON.stringify 基礎上自動加引號包裹並跳脫 "、\、\n、\r、\t 等特殊字元，可直接貼到程式碼或文字中
• 縮排格式可控：支援 0/2 空格縮排與單行緊湊模式，適配不同語言程式碼風格與體積最佳化需求
• 程式碼嵌入直配：序列化結果可直接賦值給 JavaScript、Java、Python、Go 等主流語言變數，無需手工再跳脫
• URL / 資料庫場景最佳化：輸出的字串可安全塞進 query 參數、HTTP Body、資料庫 TEXT 欄位、Markdown 文件
• Parse 反向完整還原：能正確去掉外層引號並反轉義所有 \n、\t、\"、\\ 等序列，還原為標準 JSON 物件
• 本地處理保護隱私：解析、跳脫、反跳脫、格式化全部在瀏覽器本地完成，輸入內容不發送到任何伺服器
• 可載入檔案與範例：支援上傳 .json/.txt 檔案或一鍵載入範例，便於快速驗證跳脫效果

程式碼範例

// 業務中需要把一段 JSON 作為字串字面值嵌入 JS 源碼
const data = { name: 'Alice', age: 30, tags: ['dev', 'writer'] };

// 標準序列化
const json = JSON.stringify(data, null, 2);

// 嵌入跳脫: 加外層引號 + 跳脫內部 " \ \n \r \t
const embedded = '"' + json
  .replace(/\\/g, '\\\\')
  .replace(/"/g, '\\"')
  .replace(/\n/g, '\\n')
  .replace(/\r/g, '\\r')
  .replace(/\t/g, '\\t') + '"';

// 反向解析
const restored = JSON.parse(embedded);
console.log(restored.name); // 'Alice'

import json

data = {"name": "Alice", "age": 30, "tags": ["dev", "writer"]}

# 序列化並縮排
pretty = json.dumps(data, indent=2, ensure_ascii=False)
print(pretty)

# 嵌入跳脫: 直接用 json.dumps 即可，它會做完整跳脫
embedded = json.dumps(pretty)  # 字串字面值值
print(embedded)  # '"{\\n  \\"name\\": \\"Alice\\",...\\n}"'

# 反向解析
restored = json.loads(json.loads(embedded))
print(restored["name"])  # Alice

# 把 data.json 序列化為帶引號可嵌入的字串
jq -Rs . data.json

# 解釋: -R (raw input) + -s (slurp) 把整個檔案當字串,
#       再用 . 轉為 JSON 字串字面值, 內部 \" \\ \n 自動跳脫

# 反向: 把字串解析回 JSON
echo '"{\"name\":\"Alice\"}"' | jq -r .

常見問題

故障排查

術語表

JSON.stringify

JavaScript 內建方法，把 JS 值序列化為 JSON 字串；返回結果本身仍是合法 JSON，可被 JSON.parse 還原，但預設不含外層引號和額外跳脫。

JSON.parse

JavaScript 內建方法，把符合 RFC 8259 的 JSON 字串解析為 JS 值；遇到任何語法錯誤立即拋 SyntaxError。

Serialize / 序列化

把記憶體中的資料結構（物件/陣列）轉換為可儲存/可傳輸的文字格式（JSON 字串）的過程，JSON Stringify 是最常見的實作。

Deserialize / 反序列化

序列化的逆過程，把 JSON 字串重新還原為記憶體中的物件/陣列；對應 JSON.parse。

Escape / 跳脫

在特殊字元前加反斜線（" → \"、\ → \\、\n → \\n 等），使字串可以安全嵌入到外層程式碼或文字中而不破壞外層語法。

String Literal / 字串字面值

源碼中用一對引號包裹的字串常數；JSON Stringify 的最終輸出形式就是 JS/Java/Python 等語言的字串字面值。

Double-Escape / 雙重跳脫

字串本身已經被跳脫過一次，嵌入到另一層字串時再次被跳脫；如 `\n` 雙重跳脫後變成 `\\n`，常見於日誌和資料庫儲存時手工拼接造成的 bug。

Unicode 跳脫 (\uXXXX)

JSON 規範允許用 `\uXXXX` 表示任意 Unicode 字元；JS 標準函式庫預設不會自動把中文/emoji 轉成 `\uXXXX`（除非明確指定 ensure_ascii=True）。

ensure_ascii (Python)

Python json.dumps 模組的參數；設為 True（預設）會把所有非 ASCII 字元轉成 `\uXXXX`，設為 False 則保留原字元。

URL Encode

把 URL 保留字元（&、=、空格、中文等）轉成 `%XX` 形式；JSON Stringify 只處理 JSON 語法字元，URL 參數還需額外做 encodeURIComponent。

JSON Stringify 字元跳脫對照表

JSON.stringify vs JSON Stringify 嵌入工具 vs JSON Escape

Authoritative References

• MDNJSON.stringify - MDN Web 文件
• MDNJSON.parse - MDN Web 文件
• IETFJSON 官方規範 (RFC 8259)
• WikipediaJSON - 維基百科