JSON 格式化

什麼是 JSON？

JSON（JavaScript Object Notation）是 2001 年由 Douglas Crockford 推廣的輕量資料交換格式，靈感來自 JavaScript 物件字面值。它的優勢是人類可讀、機器易解析、與語言無關——所以 2010 年後成為 Web API 的事實標準（取代過去的 XML）。

JSON 只支援 6 種類型：object（鍵值對 {}）、array（陣列 []）、string（字串，必須雙引號）、number（整數或小數）、boolean（true / false）、null。沒有 comment、沒有 trailing comma、沒有單引號——這是 JSON 「嚴格」的代價。

常見使用情境

• API 除錯：從 Postman / 瀏覽器 DevTools / curl 拿到一行壓縮 JSON，貼進來美化看欄位
• 壓縮成單行：把開發用的 pretty JSON 壓成單行貼進設定檔（package.json、tsconfig.json 等）或 CLI 參數
• 格式檢查：寫好的 JSON 想驗語法，本工具的解析器會在錯誤位置標示行號 + 錯誤原因
• Log 分析：把 server log 中的 JSON 抽出來貼進來，快速定位欄位
• 學習用：看別人的 JSON 結構（如 OpenAPI spec、tsconfig、package-lock）想理清楚層級

JSON 常見錯誤

• 單引號：JSON 字串必須雙引號 "..."，用 ' 會錯。寫 JS / Python 字典習慣的人最常踩
• 結尾多逗號（trailing comma）：{"a": 1, "b": 2,} 在 JS 合法，JSON 不合法
• 沒引號的 key：{a: 1} 是 JS 物件，JSON 要寫{"a": 1}
• 單行註解：JSON 不支援 // 或 /* */。需要註解就用 JSON5 或 JSONC（VS Code 用的格式）
• 未跳脫的特殊字元：字串內的 " 要寫成 \"、換行寫 \n、反斜線 \\

JSON vs YAML vs TOML

• JSON：嚴格、機器友善、所有語言都有原生解析器。API 傳輸首選
• YAML：人類友善（縮排表示層級）、支援 comment。常用於 CI / CD（GitHub Actions、GitLab）與 Kubernetes config。但縮排敏感，容易踩雷
• TOML：人類友善 + 嚴格定義。Rust 的 Cargo.toml、Python 的 pyproject.toml 採用

隱私說明

本工具的所有解析與格式化都在你的瀏覽器內完成，JSON 內容不會傳到任何伺服器。可安心貼上含 API key、token、個資的 JSON，本站不會看到也不會記錄。