bbdrug.com 内容更新

bbdrug.com 内容更新 JSON 规范、查询、转换、性能与工具实践的更新订阅 https://bbdrug.com/cn/feed.xml 2026-11-07T00:00:00Z bbdrug.com https://bbdrug.com/cn zh-CN bbdrug.com feed generator 大文件 JSON 打不开怎么办：按体积选对工具 https://bbdrug.com/cn/performance/open-large-json-files 2026-11-07T00:00:00Z 2026-11-07T00:00:00Z

几十 MB 的 JSON 导出在文本编辑器和在线工具里经常直接卡死，但解析本身只要几百毫秒。本文用一份 45MB、50 万条记录的样本实测各环节耗时与内存，解释行数和节点数才是真正的成本，并给出按文件体积选工具的决策表：在线查看、命令行提取、流式处理与桌面客户端各管一段。

JSONL 文件实操：打开、转换与坏行排错 https://bbdrug.com/cn/formats/jsonl-file-handbook 2026-11-06T00:00:00Z 2026-11-06T00:00:00Z

整份 .jsonl 丢给 JSON.parse 报错，多半不是文件坏了，而是读取方式错了。这篇给出查看与逐行读取的标准写法、与 JSON 数组互转的命令、六类坏行的排查表，以及流式接口里逐行消费的正确姿势。

JSON Schema 契约测试：把校验规则焊进 CI https://bbdrug.com/cn/schema/json-schema-contract-testing 2026-11-05T00:00:00Z 2026-11-05T00:00:00Z

schema 写完不改就是坏的起点：一个 typo 让校验器静默放行，一次重构让 fixture 全线误报。本文给出一套可落地的契约测试方案——正例、负例、快照三件套，schema 本身先进 lint，编译一次复用，再把四道闸门焊进 CI，让契约坏了构建先红。

JSON 转 CSV：表头从哪来，值为什么会变味 https://bbdrug.com/cn/conversion/json-to-csv-columns 2026-11-04T00:00:00Z 2026-11-04T00:00:00Z

用站点真实转换器跑九组实测：第一行键策略会静默丢字段，null、缺失与空串三态全部变空格，20 位整数在 JSON.parse 阶段就已丢精度，键含点号会把两条不同路径撞成同一列。本文讲清表头怎么生成、值怎么变味、按下游用途怎么选策略。

JSON 转 Java 类：生成器只给骨架，生产还要补的五件事 https://bbdrug.com/cn/conversion/json-to-java-pojo 2026-11-04T00:00:00Z 2026-11-04T00:00:00Z

用生成器实测 JSON → Java 的默认输出——number 映射成 Double、嵌套对象变 static 内部类、不生成任何注解。对照三路英文圈的实战经验，给出金额精度、字段改名、泛型擦除、未知字段、日期与无参构造五个必须手工补齐的位置与可复制代码。

JSON 转 TypeScript：接口、类型守卫与生成边界 https://bbdrug.com/cn/conversion/json-to-typescript-interface 2026-10-31T00:00:00Z 2026-11-04T00:00:00Z

从样例 JSON 生成 interface 只完成了一半：可选字段、null、联合类型、日期与大整数都要人工确认，生成结果本身也不做运行时校验。这篇给出生成、收敛与守卫的完整流程。

大整数为什么变成 9007199254740992 https://bbdrug.com/cn/faq/json-bigint-precision 2026-10-30T00:00:00Z 2026-11-04T00:00:00Z

超过 2^53-1 的整数在 IEEE 754 双精度里无法精确表示，JSON.parse 会静默把末位改掉。订单号、雪花 ID、金额分单位都踩过这个坑，正确解法是全程当字符串传。

JSON 报错信息反查表：从报错原文直接定位改法 https://bbdrug.com/cn/basics/json-error-message-lookup 2026-10-30T00:00:00Z 2026-11-04T00:00:00Z

按 JSON.parse 报错原文反查原因与改法：12 条高频报错对应 Chrome、Firefox、Safari 三种措辞，覆盖 HTML 错误页、截断输入、重复解析、NDJSON 拼接等线上场景，并解释报错位置为什么常指向"下游"。

同一份 JSON，四个工具给出四种结果：格式化工具怎么选 https://bbdrug.com/cn/ecosystem/json-formatter-tool-comparison 2026-11-03T00:00:00Z 2026-11-03T00:00:00Z

格式化不等于无损：带前导零、BOM 或大整数的同一份 JSON，经 Python、Node、jq、json.tool 处理后有的报错、有的静默改值。10 份样本实测四条解析路径，给出按场景选型的对照表与一段可复制的严格校验脚本。

JSON 转 YAML 命令行：yq 一条命令背后的四个坑 https://bbdrug.com/cn/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 样本上跑出四组数据，讲清输出格式由扩展名决定这件事，并给出批量转换、引号、缩进与大整数精度的正确写法。

additionalProperties 不关，Schema 校验等于没校验 https://bbdrug.com/cn/schema/schema-additional-properties 2026-11-02T00:00:00Z 2026-11-02T00:00:00Z

校验通过不代表数据干净。Pydantic 默认忽略未知字段，Zod 默认剥离，Ajv 默认放行——模型编造的参数、拼错的键都会静默穿过。本文用实测说明静默放行的三种形态，并给出关闭对象、控制强转、逐层收口的完整写法。

单行 JSON 报错怎么定位：从 line 1 column 23611 找到出错那个字节 https://bbdrug.com/cn/basics/minified-json-error-position 2026-11-01T00:00:00Z 2026-11-01T00:00:00Z

4MB 单行 JSON 报 line 1 column 23611，行列号形同虚设。本文用本地实测的三份样本，解释 Python、Node、jq 为什么报出三个不同的数字，怎么用字符偏移一次挖到出错字节，以及语法修好后仍然会悄悄丢数据的三类陷阱。

JSON 解析报错怎么修：Unexpected token 逐条排查 https://bbdrug.com/cn/basics/json-parse-error-fix 2026-10-30T00:00:00Z 2026-11-01T00:00:00Z

把浏览器、Node、Java、Python 的报错原文翻译成「第几行第几个字符出了什么问题」，再按尾逗号、单引号、注释、控制字符、BOM、截断六个方向逐个排除。

JMESPath 入门：比 JSONPath 更适合的投影查询 https://bbdrug.com/cn/query/jmespath-guide 2026-10-31T00:00:00Z 2026-10-31T00:00:00Z

如果目标是把一批对象重排成另一种形状，JMESPath 比 JSONPath 更直接。本文从基础语法讲到投影、管道、内置函数与 AWS CLI 实战。

二进制 JSON：MessagePack、CBOR 与 BSON 的取舍 https://bbdrug.com/cn/formats/json-binary-formats 2026-10-31T00:00:00Z 2026-10-31T00:00:00Z

MessagePack、CBOR、BSON 都把 JSON 的数据模型压成字节，但体积、类型系统与生态完全不同。本文用同一份数据对比字节开销，说明 int64 与二进制字段的处理，并给出「什么时候值得换」的判断线。

JSON 对比工具怎么选：文本 diff、结构 diff 与可视化 https://bbdrug.com/cn/ecosystem/json-diff-tools 2026-10-31T00:00:00Z 2026-10-31T00:00:00Z

文本 diff 负责找出「哪里不一样」，结构 diff 负责判断「内容是否等价」，可视化负责让人快速看懂差异。三层选对，才不会把键顺序当成事故。

JSON 校验进 CI：jsonlint、ajv 与 jq 的流水线 https://bbdrug.com/cn/ecosystem/json-lint-and-validate-cli 2026-10-31T00:00:00Z 2026-10-31T00:00:00Z

语法校验只能保证文件「能解析」，Schema 校验才能保证字段「符合约定」。把两者放进 CI，关键不是选哪个工具，而是让退出码、报错定位和修复路径都清楚。

JSON 的内存账：字符串、对象与大数组各占多少 https://bbdrug.com/cn/performance/json-memory-footprint 2026-10-31T00:00:00Z 2026-10-31T00:00:00Z

一份 10MB 的 JSON 文本，解析后可能变成三到五倍大小的对象图，峰值还要再翻一倍。本文把字符串、对象、数组与数字在 V8 里的实际开销逐项拆开，给出用 process.memoryUsage 做基线测量的方法，并说明流式解析到底省在哪一段内存。

JSON 压缩的顺序别搞反：minify、gzip、brotli 实测谁在真省字节 https://bbdrug.com/cn/performance/json-minify-vs-gzip 2026-10-31T00:00:00Z 2026-10-31T00:00:00Z

去掉空白能省三到五成原始字节，但服务端开了 gzip 之后，这份收益会被压缩器压掉九成。本文在四份真实样本上实跑 gzip 三档等级与 brotli，给出「先做哪一步」的定量结论，并标出那些该跳过的场景。

JSON Patch 的安全应用：原子性、幂等与并发冲突 https://bbdrug.com/cn/query/json-patch-safety 2026-10-31T00:00:00Z 2026-10-31T00:00:00Z

JSON Patch 只是变更格式，原子性、幂等和并发控制仍要自己设计。本文从 test 前置条件、路径转义、回滚实现到 ETag 协作，给出可落地的安全用法。

大树渲染为什么卡：JSON 查看器的虚拟滚动与折叠策略 https://bbdrug.com/cn/performance/json-render-virtualization 2026-10-31T00:00:00Z 2026-10-31T00:00:00Z

一份 5MB 的 JSON 能生成几十万个 DOM 节点，卡顿从创建节点那一刻就开始，而不是从滚动开始。本文拆开解析、建节点、布局与绘制的成本，给出折叠优先、虚拟列表、搜索高亮与 Worker 分层的具体做法，并列出可以验收的指标。

JSON Schema 报错看不懂：Ajv 错误定位与错误信息治理 https://bbdrug.com/cn/schema/json-schema-error-messages 2026-10-31T00:00:00Z 2026-10-31T00:00:00Z

校验器给出的是一串机器错误，用户需要的是「哪个输入框错了」。本文拆解 Ajv 的 errors 数组，讲清 instancePath 与 schemaPath 的差别，并给出归类、自定义文案、国际化与前端呈现的完整方案。

JSON Schema 复用：$ref、$defs 与 allOf/oneOf 组合 https://bbdrug.com/cn/schema/json-schema-ref-composition 2026-10-31T00:00:00Z 2026-10-31T00:00:00Z

$ref 解决复用，allOf/oneOf 解决组合，两者叠在一起最容易出事。本文按解析顺序讲清 $id、$defs、条件分支、循环引用与打包，并给出可复现的调试路径。

JSON Text Sequences（RFC 7464）：RS 分隔的流式 JSON https://bbdrug.com/cn/formats/json-seq-rfc7464 2026-10-31T00:00:00Z 2026-10-31T00:00:00Z

RFC 7464 用 0x1E 记录分隔符把多条 JSON 串成可边写边读的流，还给了一个正式媒体类型。本文讲清格式规则、与 NDJSON 的差别、按分隔符切分再解析的实现，以及字符串里控制字符的边界。

JSON 转 SQL：INSERT、建表与类型映射的坑 https://bbdrug.com/cn/conversion/json-to-sql-insert 2026-10-31T00:00:00Z 2026-10-31T00:00:00Z

把 JSON 数组写成 SQL INSERT，看着只是加引号，实际会踩到嵌套拆表、NULL 与缺字段、引号转义、精度丢失和方言差异。这篇给出可直接运行的语句与对照表，逐条说清哪里会失真。

JSON、TOML、YAML、CSON：配置文件格式怎么选 https://bbdrug.com/cn/formats/json-toml-config-formats 2026-10-31T00:00:00Z 2026-10-31T00:00:00Z

配置文件需要注释、日期与多行文本，这些恰好是 JSON 的短板。本文把 JSON、TOML、YAML、CSON 放进同一张表比较语法与工具支持，给出按场景的选型结论，并说明转换时哪些信息一定会丢。

JSON 契约的版本演进：兼容、弃用与数据迁移 https://bbdrug.com/cn/practice/json-versioning-and-migration 2026-10-31T00:00:00Z 2026-10-31T00:00:00Z

给接口加字段不等于安全，破坏性变更往往藏在类型与语义里。这篇给出可执行的版本演进路径：兼容边界、版本字段与媒体类型、弃用窗口、消费者排查、双写迁移与回滚、契约测试，以及灰度发布的观察指标。

JSON 可视化工具：树形查看、折叠与大数据量取舍 https://bbdrug.com/cn/ecosystem/json-visualization-tools 2026-10-31T00:00:00Z 2026-10-31T00:00:00Z

可视化工具把 JSON 从一屏文字变成可折叠的树，但树形渲染、大文件性能与隐私边界决定了它适合什么场景。选型时先问数据在哪、文件多大、要不要分享。

JSONPath 过滤器进阶：递归、切片与多条件筛选 https://bbdrug.com/cn/query/jsonpath-filter-advanced 2026-10-31T00:00:00Z 2026-10-31T00:00:00Z

递归下降、数组切片与过滤器组合起来才是 JSONPath 的真正能力，也是误用最集中的地方。本文用可运行样例拆解多条件筛选、结果形态与各库差异。

大 JSON 的解析、渲染与流式处理 https://bbdrug.com/cn/performance/large-json-performance 2026-10-30T00:00:00Z 2026-10-31T00:00:00Z

解析往往不是瓶颈，渲染和拷贝才是。按「解析 → 遍历 → 渲染 → 传输」四层拆开优化，才不会白费力气。

性能与安全常见问题：慢、卡与不可信数据 https://bbdrug.com/cn/faq/faq-performance-security 2026-10-30T00:00:00Z 2026-10-30T00:00:00Z

几十 MB 的 JSON 为什么打不开、深拷贝有多贵、__proto__ 污染怎么防、XSS 从哪里进来，十条急救结论按症状排列。

查询与校验常见问题：JSONPath 与 Schema https://bbdrug.com/cn/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/cn/faq/faq-syntax-formats 2026-10-30T00:00:00Z 2026-10-30T00:00:00Z

注释能不能写、尾逗号为什么报错、键名要不要加引号、9007199254740993 为什么变样，十二条结论全部对照 RFC 8259 给出。

工具使用常见问题：数据、文件与导出 https://bbdrug.com/cn/faq/faq-tool-usage 2026-10-30T00:00:00Z 2026-10-30T00:00:00Z

数据会不会上传、能处理多大文件、存不存本地、中文为什么变成 \u4e2d，这十个问题把在线 JSON 工具的行为边界讲清楚。

团队协作常见问题：契约、配置与夹具 https://bbdrug.com/cn/faq/faq-workflow 2026-10-30T00:00:00Z 2026-10-30T00:00:00Z

命名风格、时间格式、空值语义、枚举形态、配置格式、夹具组织与合并冲突，十二条团队里真正会吵起来的取舍。

JSON API 数据契约设计要点 https://bbdrug.com/cn/practice/json-api-design 2026-10-30T00:00:00Z 2026-10-30T00:00:00Z

六件事一旦上线就很难改：响应包裹、错误格式、分页形态、ID 与时间的表示、null 与缺省的语义、版本演进。

接口返回的 JSON 该用什么结构 https://bbdrug.com/cn/faq/json-api-response-structure 2026-10-30T00:00:00Z 2026-10-30T00:00:00Z

三种常见结构各有代价：裸返回最简洁但扩展时要破坏兼容；固定信封安全但冗余；JSON:API 规范完整但重。中小型项目最实用的是「HTTP 状态码表结果 + 固定信封包业务数据」。

BOM 会导致 JSON 解析失败吗 https://bbdrug.com/cn/faq/json-bom 2026-10-30T00:00:00Z 2026-10-30T00:00:00Z

UTF-8 BOM 是不可见的三个字节 EF BB BF，JSON.parse 见到就直接抛错，而且错误位置通常报在第 1 行第 1 列，看着像文件是空的。本文讲清成因、判断方法和批量清除的手段。

中文为什么变成 \u4e2d\u6587 https://bbdrug.com/cn/faq/json-chinese-unicode-escape 2026-10-30T00:00:00Z 2026-10-30T00:00:00Z

\u4e2d\u6587 是合法的 Unicode 转义，不是编码错误。真正的乱码是「æµ‹è¯•」这种。分清两者，才知道该改序列化配置还是改文件编码。

JSON 能写注释吗 https://bbdrug.com/cn/faq/json-comment 2026-10-30T00:00:00Z 2026-10-30T00:00:00Z

RFC 8259 没有注释语法，`//` 与 `/* */` 都会让 JSON.parse 直接抛错。要写说明只有四条路：换 JSON5/JSONC、把备注塞进数据字段、写进 Schema 的 description，或改用 YAML。