JSON 規範、查詢、轉換、效能與工具實踐的更新訂閱 https://bbdrug.com/tc/feed.xml 2026-11-07T00:00:00Z bbdrug.com https://bbdrug.com/tc zh-Hant bbdrug.com feed generator https://bbdrug.com/tc/performance/open-large-json-files 2026-11-07T00:00:00Z 2026-11-07T00:00:00Z

幾十 MB 的 JSON 匯出檔在文字編輯器和線上工具裡經常直接卡死，但解析本身只要幾百毫秒。本文用一份 45MB、50 萬條記錄的樣本實測各環節耗時與記憶體，解釋行數和節點數才是真正的成本，並給出按檔案體積選工具的決策表：線上查看、命令列提取、串流處理與桌面用戶端各管一段。

https://bbdrug.com/tc/formats/jsonl-file-handbook 2026-11-06T00:00:00Z 2026-11-06T00:00:00Z

整份 .jsonl 丟給 JSON.parse 卻報錯，多半不是檔案壞了，而是讀取方式錯了。這篇給出檢視與逐行讀取的標準寫法、與 JSON 陣列互轉的指令、六類壞行的排查表，以及串流介面裡逐行消費的正確姿勢。

https://bbdrug.com/tc/schema/json-schema-contract-testing 2026-11-05T00:00:00Z 2026-11-05T00:00:00Z

schema 寫完不改就是壞的起點：一個 typo 讓校驗器靜默放行，一次重構讓 fixture 全線誤報。本文給出一套可落地的契約測試方案——正例、負例、快照三件套，schema 本身先進 lint，編譯一次複用，再把四道閘門焊進 CI，讓契約壞了構建先紅。

https://bbdrug.com/tc/conversion/json-to-csv-columns 2026-11-04T00:00:00Z 2026-11-04T00:00:00Z

用站點真實轉換器跑九組實測：第一行鍵策略會靜默丟欄位，null、缺失與空字串三態全部變空格，20 位整數在 JSON.parse 階段就已丟精度，鍵含點號會把兩條不同路徑撞成同一列。本文講清表頭怎麼生成、值怎麼變味、按下游用途怎麼選策略。

https://bbdrug.com/tc/conversion/json-to-java-pojo 2026-11-04T00:00:00Z 2026-11-04T00:00:00Z

用生成器實測 JSON → Java 的預設輸出——number 映射成 Double、嵌套物件變 static 內部類別、不生成任何注解。對照三路英文圈的實戰經驗，給出金額精度、欄位改名、泛型擦除、未知欄位、日期與無參建構子五個必須手工補齊的位置與可複製程式碼。

https://bbdrug.com/tc/conversion/json-to-typescript-interface 2026-10-31T00:00:00Z 2026-11-04T00:00:00Z

從範例 JSON 生成 interface 只完成了一半：可選欄位、null、聯合型別、日期與大整數都要人工確認，生成結果本身也不做執行時校驗。這篇給出生成、收斂與守衛的完整流程。

https://bbdrug.com/tc/faq/json-bigint-precision 2026-10-30T00:00:00Z 2026-11-04T00:00:00Z

超過 2^53-1 的整數在 IEEE 754 雙精度裡無法精確表示，JSON.parse 會靜默把末位改掉。訂單號、雪花 ID、金額都踩過這個坑，正確解法是全程當字串傳。

https://bbdrug.com/tc/basics/json-error-message-lookup 2026-10-30T00:00:00Z 2026-11-04T00:00:00Z

按 JSON.parse 報錯原文反查原因與改法：12 條高頻報錯對應 Chrome、Firefox、Safari 三種措辭，涵蓋 HTML 錯誤頁、截斷輸入、重複解析、NDJSON 拼接等線上場景，並解釋報錯位置為什麼常指向「下游」。

https://bbdrug.com/tc/ecosystem/json-formatter-tool-comparison 2026-11-03T00:00:00Z 2026-11-03T00:00:00Z

格式化不等於無損：帶前導零、BOM 或大整數的同一份 JSON，經 Python、Node、jq、json.tool 處理後有的報錯、有的靜默改值。10 份樣本實測四條解析路徑，給出按場景選型的對照表與一段可複製的嚴格校驗腳本。

https://bbdrug.com/tc/conversion/json-to-yaml-cli 2026-11-03T00:00:00Z 2026-11-03T00:00:00Z

教學裡出現頻率最高的 yq -P input.json > output.yaml，實測輸出的仍是 JSON。本文用 yq v4.44.6、PyYAML 6.0.3 與 js-yaml 在 2.39 MB 樣本上跑出四組數據，講清輸出格式由副檔名決定這件事，並給出批次轉換、引號、縮排與大整數精度的正確寫法。

https://bbdrug.com/tc/schema/schema-additional-properties 2026-11-02T00:00:00Z 2026-11-02T00:00:00Z

校驗通過不代表資料乾淨。Pydantic 預設忽略未知欄位，Zod 預設剝離，Ajv 預設放行——模型編造的參數、拼錯的鍵都會靜默穿過。本文用實測說明靜默放行的三種形態，並給出關閉物件、控制強轉、逐層收口的完整寫法。

https://bbdrug.com/tc/basics/minified-json-error-position 2026-11-01T00:00:00Z 2026-11-01T00:00:00Z

4MB 單行 JSON 報 line 1 column 23611，行列號形同虛設。本文用本機實測的三份樣本，解釋 Python、Node、jq 為什麼報出三個不同的數字，怎麼用字元偏移一次挖到出錯的位元組，以及語法修好之後仍然會悄悄丟資料的三類陷阱。

https://bbdrug.com/tc/basics/json-parse-error-fix 2026-10-30T00:00:00Z 2026-11-01T00:00:00Z

把瀏覽器、Node、Java、Python 的報錯原文翻譯成「第幾行第幾個字元出了什麼問題」，再按尾逗號、單引號、註釋、控制字元、BOM、截斷六個方向逐個排除。

https://bbdrug.com/tc/query/jmespath-guide 2026-10-31T00:00:00Z 2026-10-31T00:00:00Z

如果目標是把一批物件重排成另一種形狀，JMESPath 比 JSONPath 更直接。本文從基礎語法講到投影、管道、內建函式與 AWS CLI 實戰。

https://bbdrug.com/tc/formats/json-binary-formats 2026-10-31T00:00:00Z 2026-10-31T00:00:00Z

MessagePack、CBOR、BSON 都把 JSON 的資料模型壓成位元組，但體積、型別系統與生態完全不同。本文用同一份資料比較位元組開銷，說明 int64 與二進位欄位的處理，並給出「什麼時候值得換」的判斷線。

https://bbdrug.com/tc/ecosystem/json-diff-tools 2026-10-31T00:00:00Z 2026-10-31T00:00:00Z

文字 diff 負責找出「哪裡不一樣」，結構 diff 負責判斷「內容是否等價」，視覺化負責讓人快速看懂差異。三層選對，才不會把鍵順序當成事故。

https://bbdrug.com/tc/ecosystem/json-lint-and-validate-cli 2026-10-31T00:00:00Z 2026-10-31T00:00:00Z

語法校驗只能保證檔案「能解析」，Schema 校驗才能保證欄位「符合約定」。把兩者放進 CI，關鍵不是選哪個工具，而是讓退出碼、報錯定位與修復路徑都清楚。

https://bbdrug.com/tc/performance/json-memory-footprint 2026-10-31T00:00:00Z 2026-10-31T00:00:00Z

一份 10MB 的 JSON 文字，解析後可能變成三到五倍大小的物件圖，峰值還要再翻一倍。本文把字串、物件、陣列與數字在 V8 裡的實際開銷逐項拆開，給出用 process.memoryUsage 做基線測量的方法，並說明串流解析到底省在哪一段記憶體。

https://bbdrug.com/tc/performance/json-minify-vs-gzip 2026-10-31T00:00:00Z 2026-10-31T00:00:00Z

去掉空白能省三到五成原始位元組，但伺服器端開了 gzip 之後，這份收益會被壓縮器吃掉九成。本文在四份真實樣本上實跑 gzip 三檔等級與 brotli，給出「先做哪一步」的定量結論，並標出那些該跳過的情境。

https://bbdrug.com/tc/query/json-patch-safety 2026-10-31T00:00:00Z 2026-10-31T00:00:00Z

JSON Patch 只是變更格式，原子性、冪等和併發控制仍要自己設計。本文從 test 前置條件、路徑轉義、回滾實現到 ETag 協作，給出可落地的安全用法。

https://bbdrug.com/tc/performance/json-render-virtualization 2026-10-31T00:00:00Z 2026-10-31T00:00:00Z

一份 5MB 的 JSON 能產生幾十萬個 DOM 節點，卡頓從建立節點那一刻就開始，而不是從滾動開始。本文拆開解析、建節點、佈局與繪製的成本，給出摺疊優先、虛擬列表、搜尋高亮與 Worker 分層的具體做法，並列出可以驗收的指標。

https://bbdrug.com/tc/schema/json-schema-error-messages 2026-10-31T00:00:00Z 2026-10-31T00:00:00Z

校驗器給出的是一串機器錯誤，使用者需要的是「哪個輸入框錯了」。本文拆解 Ajv 的 errors 陣列，講清 instancePath 與 schemaPath 的差別，並給出歸類、自訂文案、國際化與前端呈現的完整方案。

https://bbdrug.com/tc/schema/json-schema-ref-composition 2026-10-31T00:00:00Z 2026-10-31T00:00:00Z

$ref 解決複用，allOf/oneOf 解決組合，兩者疊在一起最容易出事。本文按解析順序講清 $id、$defs、條件分支、迴圈引用與打包，並給出可重現的除錯路徑。

https://bbdrug.com/tc/formats/json-seq-rfc7464 2026-10-31T00:00:00Z 2026-10-31T00:00:00Z

RFC 7464 用 0x1E 記錄分隔符把多條 JSON 串成可邊寫邊讀的串流，還給了正式媒體類型。本文說明格式規則、與 NDJSON 的差別、按分隔符切分再解析的實作，以及字串裡控制字元的邊界。

https://bbdrug.com/tc/conversion/json-to-sql-insert 2026-10-31T00:00:00Z 2026-10-31T00:00:00Z

把 JSON 陣列寫成 SQL INSERT，看著只是加引號，實際會踩到巢狀拆表、NULL 與缺欄位、引號轉義、精度丟失和方言差異。這篇給出可直接執行的語句與對照表，逐條說清哪裡會失真。

https://bbdrug.com/tc/formats/json-toml-config-formats 2026-10-31T00:00:00Z 2026-10-31T00:00:00Z

配置檔案需要註釋、日期與多行文字，這些恰好是 JSON 的短板。本文把 JSON、TOML、YAML、CSON 放進同一張表比較語法與工具支援，給出按情境的選型結論，並說明轉換時哪些資訊一定會遺失。

https://bbdrug.com/tc/practice/json-versioning-and-migration 2026-10-31T00:00:00Z 2026-10-31T00:00:00Z

替介面加欄位不等於安全，破壞性變更往往藏在型別與語義裡。這篇給出可執行的版本演進路徑：相容邊界、版本欄位與媒體型別、棄用視窗、消費者排查、雙寫遷移與還原、契約測試，以及漸進式發佈的觀察指標。

https://bbdrug.com/tc/ecosystem/json-visualization-tools 2026-10-31T00:00:00Z 2026-10-31T00:00:00Z

視覺化工具把 JSON 從一螢幕文字變成可摺疊的樹，但樹形渲染、大檔案效能與隱私邊界決定了它適合什麼場景。選型時先問資料在哪、檔案多大、要不要分享。

https://bbdrug.com/tc/query/jsonpath-filter-advanced 2026-10-31T00:00:00Z 2026-10-31T00:00:00Z

遞迴下降、陣列切片與過濾器組合起來才是 JSONPath 的真正能力，也是誤用最集中的地方。本文用可執行樣例拆解多條件篩選、結果形態與各庫差異。

https://bbdrug.com/tc/performance/large-json-performance 2026-10-30T00:00:00Z 2026-10-31T00:00:00Z

解析往往不是瓶頸，渲染和複製才是。按「解析 → 遍歷 → 渲染 → 傳輸」四層拆開最佳化，才不會白費力氣。

https://bbdrug.com/tc/faq/faq-performance-security 2026-10-30T00:00:00Z 2026-10-30T00:00:00Z

幾十 MB 的 JSON 為什麼打不開、深複製有多貴、__proto__ 汙染怎麼防、XSS 從哪裡進來，十條急救結論按症狀排列。

https://bbdrug.com/tc/faq/faq-query-and-schema 2026-10-30T00:00:00Z 2026-10-30T00:00:00Z

路徑查詢該用 JSONPath 還是 Pointer、Patch 與 Merge Patch 怎麼取捨、Schema 能攔住哪些錯誤、draft 版本怎麼選，一次講透。

https://bbdrug.com/tc/faq/faq-syntax-formats 2026-10-30T00:00:00Z 2026-10-30T00:00:00Z

註釋能不能寫、尾逗號為什麼報錯、鍵名要不要加引號、9007199254740993 為什麼變樣，十二條結論全部對照 RFC 8259 給出。

https://bbdrug.com/tc/faq/faq-tool-usage 2026-10-30T00:00:00Z 2026-10-30T00:00:00Z

資料會不會上傳、能處理多大檔案、存不存本地、中文為什麼變成 \u4e2d，這十個問題把線上 JSON 工具的行為邊界講清楚。

https://bbdrug.com/tc/faq/faq-workflow 2026-10-30T00:00:00Z 2026-10-30T00:00:00Z

命名風格、時間格式、空值語義、列舉形態、配置格式、夾具組織與合併衝突，十二條團隊裡真正會吵起來的取捨。

https://bbdrug.com/tc/practice/json-api-design 2026-10-30T00:00:00Z 2026-10-30T00:00:00Z

六件事一旦上線就很難改：響應包裹、錯誤格式、分頁形態、ID 與時間的表示、null 與預設的語義、版本演進。

https://bbdrug.com/tc/faq/json-api-response-structure 2026-10-30T00:00:00Z 2026-10-30T00:00:00Z

三種常見結構各有代價：裸回傳最簡潔但擴充時要破壞相容；固定信封安全但冗餘；JSON:API 規範完整但重。中小型專案最實用的是「HTTP 狀態碼表結果 + 固定信封包業務資料」。

https://bbdrug.com/tc/faq/json-bom 2026-10-30T00:00:00Z 2026-10-30T00:00:00Z

UTF-8 BOM 是檔案開頭三個看不見的位元組 EF BB BF，JSON.parse 讀到就直接拋錯，而且錯誤位置通常報在第 1 行第 1 列，看起來像檔案是空的。

https://bbdrug.com/tc/faq/json-chinese-unicode-escape 2026-10-30T00:00:00Z 2026-10-30T00:00:00Z

\u4e2d\u6587 是合法的 Unicode 轉義，不是編碼錯誤。真正的亂碼是「测试」這種。分清楚兩者，才知道該改序列化設定還是改檔案編碼。

https://bbdrug.com/tc/faq/json-comment 2026-10-30T00:00:00Z 2026-10-30T00:00:00Z

RFC 8259 沒有註解語法，`//` 與 `/* */` 都會讓 JSON.parse 直接拋錯。要寫說明只有四條路：改用 JSON5/JSONC、把備註塞進資料欄位、寫進 Schema 的 description，或改用 YAML。