JSON 格式化工具

為什麼需要格式化 JSON？

JSON 檔案為了在網路傳輸時節省流量，通常會被移除所有不必要的空白與換行（這個過程稱為 Minify）。雖然機器讀起來沒問題，但當人類想要閱讀或修改這些「單行天書」時，會非常痛苦。

這款 JSON 格式化工具 (又稱為 JSON Prettifier) 的作用，就是將這些緊湊的字串「展開」。它會根據大括號 {} 與中括號 [] 的層級關係，自動補上換行與縮排，讓資料結構一目了然。

核心功能：縮排與標準化

格式化的核心在於「視覺階層」。

• 自動換行： 遇到逗號 , 或括號結束時自動換行。

• 層級縮排： 每一層巢狀結構 (Nested Object) 都會向右縮排，讓您可以清楚看出誰是父層、誰是子層。

• 高亮顯示： 區分 Keys (鍵) 與 Values (值) 的顏色，方便識別。

常見的應用場景

1. 整理設定檔 (Config Files)

許多現代化工具（如 VS Code, Sublime Text, npm package.json）都使用 JSON 作為設定檔。

• 如果您從網路複製了一段設定碼，貼進去後發現格式亂七八糟，使用此工具可以瞬間將其標準化，保持專案整潔。

2. API 文件撰寫

後端工程師在撰寫 API 文件（如 Swagger/OpenAPI）時，需要提供「範例回傳值 (Example Response)」。

• 直接貼上壓縮的 JSON 對閱讀者很不友善。

• 先透過工具美化後再貼上，能大幅提升文件的可讀性。

3. 資料比對 (Diff)

如果您有兩個看似一樣、但比對結果卻不同的 JSON 檔。

• 往往是因為其中一個被壓縮過，另一個有換行。

• 先將兩者都「格式化」成統一標準，再進行比對，就能精準找出差異之處。

常見問題 (People Also Ask)

Q1：縮排應該用 Tab 還是 Space (空白鍵)？

這取決於您的團隊規範，本工具都支援。

• 2 Spaces： JavaScript/JSON 社群最常見的標準（如 Google, Airbnb 規範），因為 JSON 巢狀通常很深，2 格縮排比較不占空間。

• 4 Spaces： Python 或傳統後端開發者較習慣，層次感更明顯。

• Tab： 檔案體積最小，且開發者可以在編輯器自訂 Tab 寬度。

Q2：格式化會改變資料內容嗎？

不會，只改變外觀。

• JSON 格式化只是增加了「空白字元 (Whitespace)」，這對 JSON 解析器來說是無意義的。

• 資料的內容 (Values)、順序與邏輯完全不會改變。

Q3：為什麼輸入後顯示 Parse Error？

這代表您的原始資料有語法錯誤。常見原因：

1. 字串沒加雙引號： { name: "John" } 是錯的，必須是 { "name": "John" }。

2. 使用了單引號： JSON 標準規定字串必須用雙引號 "，不能用單引號 '。

3. 多餘的逗號： 最後一個屬性後面不能有逗號。

Q4：這跟 JSON Viewer 有什麼不同？

• JSON Formatter (本工具)： 重點在產生**「純文字」**。適合複製貼上到 IDE 或文件中。

• JSON Viewer： 重點在產生**「互動介面」**。適合點擊展開/摺疊，用來探索未知的資料結構。