DevTool 團隊

JSON 格式化工具怎麼挑:錯誤定位、修復與隱私

貼一段 JSON,哪個工具值得用?這篇給判斷標準而不是工具清單:先按場景選路(臨時看一眼用線上工具、天天改用編輯器、批次與 CI 用 jq、團隊規範用 schema 校驗),再講評價一個 JSON 工具的三件套——報錯定位到行列還是一句 invalid、修復是預覽確認還是靜默改寫、大檔案是分級降級還是卡死;最後給隱私核實方法:斷網測試與分享連結的 URL fragment 機制,以及什麼時候線上工具不如編輯器和命令列。

先選路:你要對 JSON 做什麼

「JSON 格式化工具」搜尋框裡敲下這串詞的人,要的其實不是同一個東西。按你手頭的事選路:

你要做的事 順手的選擇 為什麼
看一眼介面回應、檢查一段設定、排查一個報錯 線上工具(如本站 JSON 線上解析) 零安裝、貼進來即用,樹狀檢視順帶解決「瀏覽結構」
天天要改 JSON 設定檔 程式碼編輯器(VS Code / JetBrains) 語法高亮、儲存即校驗、與 git 工作流一體
批次轉換、CI 裡校驗 命令列(jq、spectral) 可重現、可指令碼化,進 pipeline
團隊介面契約檢查 Schema 校驗(線上或 CI 內) 語法對≠結構對,契約要 Schema 管

本文重點講第一條路——因為線上工具品質差距最大,也是最容易被「功能同質化」話術糊弄的一類。判斷標準有三件套。

三件套之一:報錯定位,不是「invalid」

貼上一段壞 JSON,工具給你的第一句話暴露了它的實作品質:

  • 差的實作:一句 Invalid JSON 或 Unexpected token,你自己找哪行錯了;
  • 好的實作:行列號 + 具體原因——「第 12 行第 8 列:字串缺少右引號」「第 30 行:物件有多餘的逗號」。

這個差距在日常場景裡就是幾分鐘和幾秒的區別:介面回傳了 2MB 的回應,報錯只有一句 invalid 時,你要在壓縮成一行的文字裡肉眼找問題。本站的報錯直接給行列與原因——解析器的錯誤碼被映射成可讀的說明,而不是把 JSON.parse 的原始異常甩給你。

順帶一個高頻案例:Unexpected token 報在 JSON 第一個 { 上,九成不是 JSON 的問題——是你拿到的是「包了一層引號的 JSON 字串」(二次序列化)或回應根本是 HTML 錯誤頁。前者可以直接用一鍵修復解開(被轉義的 JSON 字串在修復覆蓋清單裡),後者的正確動作是去查介面為什麼回傳了錯誤頁。

三件套之二:修復要預覽確認,不要靜默改寫

「一鍵修復」現在是標配,但實作姿態分兩檔:

  • 靜默改寫:點一下,輸入直接被替換。快,但你不知道它改了什麼——尾逗號刪了 3 處?還是把你的字串引號全換了?對設定檔來說,「改了什麼」和「改對了」同樣重要。
  • 預覽確認:先給改動摘要(修了幾處、每處什麼變化),確認後寫回。本站走這條路線,涵蓋十幾類常見非法寫法:缺引號、單引號、尾隨逗號、註解、缺逗號缺括號、被截斷的 JSON、Python 風格的 True/False/None、被轉義的 JSON 字串、NDJSON 多行——這些多是從別的語言、別的工具、日誌裡複製出來的真實傷情。

還有一個更隱蔽的坑:有些修復實作對「完全不是 JSON 的輸入」不報錯,而是把整段文字包成一個字串字面量——輸入 @@@ junk @@@ 輸出 "@@@ junk @@@"。那不是修復,是把你的資料降級成無意義純量。好的實作會顯式攔截這種情況並判失敗。

三件套之三:大檔案的表現

大檔案區分的不是功能而是工程:10MB 的 JSON 貼進來,差工具直接卡死分頁,好工具有分級降級——超過門檻時從重型編輯器降級到純文字模式,犧牲高亮換取可用,格式化、校驗、搜尋照常。判斷方法很土但有效:拿你們線上最大的一個介面回應試一次。

配套能力還有兩個值得點名:大檔案搜尋(按路徑或按值找欄位,而不是瀏覽器 Ctrl+F 在壓縮文字裡抓瞎)和鍵排序(對接前後比對、生成 canonical 形態時省事)。

隱私口徑:怎麼核實「不上傳」

工具頁都會寫「資料不上傳」,核實辦法有兩個,都是自助可做的:

  1. 斷網測試:切斷網路再貼上內容。本機處理的工具一切照常(格式化、樹狀、報錯都在),要上傳的工具立刻罷工。
  2. Network 面板:打開開發者工具的 Network 面板,貼上內容、觸發操作,看有沒有新請求發出。

本站的口徑可以這麼驗證,但有一個例外要說清楚:分享連結。生成分享連結時,內容被 base64 編碼放進 URL 的 #fragment 部分——瀏覽器按規範不會把 fragment 發給伺服器,所以生成連結這個動作本身不上傳資料;但連結本身就攜帶全部內容,把它貼進聊天工具,等於把內容發給了聊天服務商,而且超長的內容(連結總長 16,000 字元封頂)會拒絕生成並引導你下載檔案。這是「處理不上傳」和「分享即攜帶」的邊界,用的時候分清楚。

真話:什麼時候別用線上工具

  • 檔案超過瀏覽器順手處理的量級(幾十 MB 的匯出、全量轉存):老實上 jq——jq . big.json > pretty.json,命令列不吃記憶體虧;
  • 校驗要進 CI、要可重現:線上工具的「我驗證過了」不構成證據,jq + spectral 的退出碼才是;
  • 你就是天天住在 VS Code 裡的人:編輯器已經給了高亮、儲存校驗、折疊,切到瀏覽器的唯一理由是樹狀瀏覽和給別人看——那就把這個理由用足(樹狀檢視裡點欄位複製 JSONPath,貼給同事比自己描述路徑快得多)。

線上工具的真正領地:低頻、臨時、要看結構的場景——它把這個場景做到幾秒內完成,就是合格的工具。

常見問題

線上 JSON 工具和編輯器外掛比,各自適合誰?

臨時任務(看一眼介面回應、檢查一段設定、排查一個報錯)適合線上工具:零安裝、貼進來即用、樹狀檢視順帶給了瀏覽結構的能力。天天要改 JSON 設定的人適合編輯器(VS Code 等):語法高亮、儲存即校驗、和 git 工作流無縫。批次處理與 CI 適合命令列(jq):可重現、可指令碼化。三者不是競爭關係,是同一份 JSON 的三種工作節奏。

怎麼驗證一個線上工具真的不上傳資料?

兩個自助辦法:斷網測試——切斷網路後貼上內容,本機處理的工具功能照常,要上傳的工具立刻罷工;或者打開瀏覽器開發者工具的 Network 面板貼上內容,觀察有沒有發出請求。另外注意分享功能的機制:內容編碼在 URL 的 #fragment 裡時不會發給伺服器,但連結本身就攜帶內容,貼進聊天工具等於把內容發出去——和「不上傳」是兩回事。

JSON 修復功能會不會悄悄改壞資料?

取決於工具有沒有「預覽確認」環節。負責任的修復流程是:先展示改動摘要(改了幾處、改成什麼),使用者確認後才寫回;並且要攔截「偽修復」——有些函式庫對完全不是 JSON 的輸入不報錯,而是把整段文字包成一個字串字面量,那不是修復,是把資料變成了無意義的純量。用修復前先看一眼 diff,是對自己資料負責的最低成本。

JSON Schema 校驗和語法校驗有什麼區別?

語法校驗回答「這是不是合法 JSON」——括號引號逗號對不對;Schema 校驗回答「這是不是我要的 JSON」——欄位齊不齊、型別對不對、列舉值在不在範圍內。比如語法合法但把 age 寫成了字串、少了必填的 email,只有 Schema 校驗能抓住。報錯品質也要看定位:好的實作把每條 Schema 違規定位到具體行列,而不是甩一段校驗器輸出。