如果你曾搜尋過讓 JSON 變得可讀的方法,大概都看過 “JSON viewer” 和 “JSON formatter” 這兩類工具 —— 也好奇過它們是不是同一回事。它們並不相同,只是隨著工具功能變強,兩者的界線變得模糊。理解它們的差別能幫你挑對工具:格式化原始 API 輸出、除錯時探索深層巢狀的回應,或在不迷失位置的情況下瀏覽一個大型設定檔。
什麼是 JSON 格式化器(formatter)?
JSON 格式化器接受原始、未格式化的 JSON —— 通常是一行很長的字串 —— 用一致的縮排與換行重寫它。資料本身不會改變,變動的只有空白。
// 原始輸入
{"user":{"id":42,"name":"Alice","roles":["admin","editor"],"active":true}}
// 格式化之後(2 空格縮排)
{
"user": {
"id": 42,
"name": "Alice",
"roles": [
"admin",
"editor"
],
"active": true
}
}
格式化器是一種文字操作。它讀取 JSON 字串、正規化空白,然後輸出一個新字串。大多數格式化器在副作用上還會驗證 JSON —— 如果 JSON 不合法,格式化器無法正確縮排,就會丟出錯誤。
JSON 格式化器擅長什麼:
- 幾秒內把被壓縮的 API 回應變得可讀
- 在團隊內統一縮排風格(2 空格 vs 4 空格 vs 定位點)
- 產出可用於文件或日誌的美化輸出
- 作為一種快速判斷 JSON 是否合法的檢查
什麼是 JSON 檢視器(viewer)?
JSON 檢視器 —— 有時也稱為 JSON reader 或 JSON explorer —— 走得更遠一步。它不是輸出格式化文字,而是把 JSON 渲染成一個你可以瀏覽的互動式結構。
JSON 檢視器的關鍵特性是 可摺疊節點。每個物件 {} 和陣列 [] 都可以獨立展開或收合。這代表你可以先看一個一萬行回應的頂層,找到你關心的部分,只展開那一支,忽略其他所有內容。
典型的 JSON 檢視器還會提供:
- 語法高亮 —— 鍵、字串、數字、布林值與 null 各自有不同的顏色,結構一目了然
- 可摺疊/展開的節點 —— 摺疊整個子樹以減少視覺雜訊
- 子項目數量 —— 摺疊的節點顯示子項目數量,一眼就知道(例如
[...] 24 items) - 鍵的導覽 —— 不必捲動數千行就能找到特定的鍵
JSON 檢視器擅長什麼:
- 瀏覽大型、深層巢狀的 API 回應
- 在事先不了解資料形狀的情況下除錯
- 檢視只關心其中幾節的設定檔
- 快速理解陌生的 JSON 結構
“JSON 樹狀檢視器” 就是同一件事
你也會看到同樣的功能被稱為 JSON tree viewer、JSON tree,或 collapsible JSON tree。這三個名稱描述的都是把文件渲染為可展開節點構成的互動式階層。如果你想專門搜尋這個詞,請見 JSON Tree Viewer:以可摺疊樹瀏覽 JSON。
你其實已經有一個:瀏覽器 DevTools
值得知道:Chrome、Firefox 和 Edge 在回應的 Content-Type 是 application/json 時,都會內建渲染一個可摺疊的 JSON 檢視器。直接打開該 URL(或從 Network 面板的 Preview 檢視),就能免費獲得一棵樹 —— 不需要任何擴充功能。對快速閱讀非常合適;但面對非常大的負載、需要 “全部摺疊” 控制項或鍵搜尋時,專用檢視器更勝一籌。
核心差別一句話總結
最簡單的理解方式:格式化器改變文字 看起來 的樣子;檢視器改變你與資料 互動 的方式。
| JSON 格式化器 | JSON 檢視器 | |
|---|---|---|
| 輸出 | 格式化文字 | 互動式樹 |
| 可摺疊節點 | 無 | 有 |
| 語法高亮 | 有時有 | 始終有 |
| 可作為文字複製 | 可以 | 通常透過匯出 |
| 最適合 | 整理輸出 | 探索結構 |
何時使用 JSON 格式化器
當你需要 可讀的文字輸出 時使用格式化器 —— 可以貼上、提交、記錄日誌或傳給同事的內容。
在終端機讀 API 回應
你執行 curl https://api.example.com/users/42,得到一大堆壓縮過的 JSON。貼到格式化工具裡,幾秒就能讓它變得可讀。
提交前統一檔案風格
如果你的團隊風格指南要求 2 空格縮排,格式化器可以一致地強制執行這項規則,不必手動修改。
快速合法性檢查
把疑似壞掉的 JSON 貼進格式化器,馬上就能知道它能否解析。看到錯誤代表 JSON 不合法;能乾淨地格式化就表示它合法。
文件與截圖
美化後的 JSON 在文件、README 檔案和 Slack 訊息裡看起來比一行壓縮過的文字好多了。
何時使用 JSON 檢視器
當你需要 瀏覽與探索 時使用檢視器 —— 當你還不確切知道 JSON 裡有什麼或要去哪找。
探索大型 API 回應
你收到一份包含數十個巢狀物件與陣列的回應。把頂層節點摺疊起來就得到結構的地圖。只展開你正在查的那一支。
在不了解 schema 的情況下除錯
第一次使用第三方 API 時,檢視器讓你能在寫任何解析程式碼前,透過點擊樹來理解物件之間的關係。
讀取深層巢狀的設定
Kubernetes manifest、AWS CloudFormation 範本等檔案常常巢狀好幾層。檢視器讓你在五層深的地方找到特定設定變得可行。
比較不同環境的資料形狀
把正式環境與測試環境的回應並排展開。摺疊的節點讓你一眼看出哪些區段不同。
好的 JSON 檢視器有哪些共通點
並非所有 JSON 檢視器都一樣。區別好用與惱人的關鍵如下:
- 全部摺疊 / 全部展開 控制項 —— 你需要能瞬間重置檢視;沒有 “全部摺疊” 按鈕的檢視器只能讓你一個個關節點
- 在大型檔案上穩定的效能 —— 一些瀏覽器型檢視器在面對數萬個節點時會吃力;最好的工具能穩穩處理
- 準確的語法高亮 —— 鍵應該與字串值有區別;數字、布林與 null 在視覺上各自獨特
- 對邊界情況的妥善處理 —— 空物件、空陣列、null 值與深層巢狀結構都需要正確渲染
- 不需要上傳資料 —— 你的 JSON 常含有敏感資料;在瀏覽器本地處理一切的檢視器比把資料送到伺服器的安全得多
JSON Reader:它和 viewer 有不同嗎?
“JSON reader” 通常與 “JSON viewer” 可互換 —— 描述的是閱讀和瀏覽 JSON 的動作,而非編輯或重新格式化。如果看到一個工具標榜為 JSON reader,幾乎可以肯定它提供樹狀導覽和可摺疊節點,與 viewer 相同。
偶爾 “reader” 會出現在程式碼語境中 —— 比如 Java 的 Gson 函式庫裡的 JsonReader —— 但在 Web 工具的脈絡下,reader 和 viewer 是同一件事。
你兩個都需要嗎?
需要 —— 而且大多數好工具都會把兩種能力結合。現代 JSON 工具會先把輸入格式化(統一縮排)並且 把它渲染成可瀏覽的樹。格式化文字和互動式檢視器共存:依當下任務選用哪一種檢視。
差別最重要的時刻是工具專為其中之一而設計時。命令列格式化器如 jq 或 python -m json.tool 只給你文字輸出。瀏覽器擴充功能中的專用檢視器只給你樹狀導覽。日常工作中,一個瀏覽器內同時具備兩種能力的工具最實用。
如何挑對工具
如果你主要在終端機工作
jq 是事實上的標準。它以強大的表達式語言對 JSON 進行格式化、過濾與查詢。它沒有檢視器,但在腳本化工作流中無可匹敵。
如果你在程式碼編輯器中工作
搭配 Prettier 擴充功能的 VS Code 會在儲存時格式化 JSON。對於樹狀瀏覽,大多數瀏覽器內建的 DevTools 的 JSON 編輯器其實意外地好用。
如果你需要快速、貼上即看的方案
瀏覽器型工具是最快的途徑。挑一個邊輸入邊驗證、提供可摺疊樹檢視、能穩穩處理大型檔案、並把資料保留在本地的工具。fixjson 的 JSON 檢視器 全部做到 —— 貼上你的 JSON,樹立刻渲染出來,完全不會把資料送到任何伺服器。
如果你面對的是損壞或不合法的 JSON
標準的格式化器或檢視器都無能為力 —— 你需要先用 JSON 修復工具。修復工具能處理常見錯誤,如 尾隨逗號、單引號,以及 未加引號的鍵,再把清理過的 JSON 交給檢視器或格式化器。
常見問題
JSON 檢視器和 JSON 格式化器有什麼差別?
格式化器輸出可讀、帶縮排的 文字,可以複製;檢視器渲染一個互動式 樹,帶可摺疊節點和語法高亮供你瀏覽。格式化器 = 文字看起來如何;檢視器 = 你如何與資料互動。
JSON 檢視器和 JSON reader 一樣嗎?
在 Web 工具裡,是的 —— “reader”、“viewer” 與 “explorer” 都描述帶可摺疊節點的樹狀導覽。(像 Gson 等程式庫中的 “JsonReader” 與此無關。)
我需要同時擁有檢視器與格式化器嗎?
大多數現代工具已合二為一 —— 它們在同一個檢視中格式化輸入並渲染一棵可摺疊樹,因此你永遠不必在可讀性與可瀏覽性之間二選一。
如果我的 JSON 壞了怎麼辦?
檢視器和格式化器都救不了 —— 先用 JSON Fix 修復,再檢視或格式化清理後的輸出。也請參見 如何格式化 JSON。
結語
JSON 格式化器給你可讀的文字。JSON 檢視器給你一棵互動式樹。兩者都有用 —— 用哪一個,取決於你需要的是可以複製貼上的輸出,還是可以點擊瀏覽的結構。
對大多數開發者而言,理想工具是兩者兼具:它會格式化輸入,並在同一檢視中渲染一棵可摺疊樹。如此一來,你永遠不必在可讀性與可瀏覽性之間做選擇。
如果你的 JSON 在嘗試檢視之前就已損壞,請先修好它 —— 檢視器和格式化器都需要合法的 JSON 作為輸入;修復工具則不需要。
來源
- jq 手冊 — 命令列 JSON 格式化器與查詢工具
- Prettier — 儲存時格式化 JSON（及程式碼）
- Firefox JSON 檢視器 — 瀏覽器內建的可摺疊 JSON 檢視器
最後審閱:2026 年 6 月。