在线 JSON 工具怎么用：格式化 / 校验 / 转换全指南 2026

这是什么

做出海的技术同学、独立站运营、对接海外支付 / 物流 / 广告 API 的人，几乎每天都在和 JSON 打交道：看接口返回、调试 webhook、把一坨数据导成表格、给对方按格式拼请求体。

这篇是 chdh.me 自建的一套纯本地在线 JSON 工具的使用指南——讲清每个工具怎么用、什么时候用、有哪些坑。所有工具全程在你浏览器本地用原生 `JSON.parse` / `JSON.stringify` 运行，不上传、不记录，含 API Key / Token / 订单信息的 JSON 也能放心处理。

TL;DR 按需求直达：

• 看不清一坨压缩 JSON → JSON 格式化 / 校验（美化 + 报错定位到行列）
• 深层嵌套看不清层级 → JSON 树形视图（可折叠树）
• 要塞进请求体 / 减体积 → JSON 压缩 / 转义
• 导进 Excel 做分析 → JSON 转 CSV
• 写 CI / K8s 配置 → JSON 转 YAML
• 前端要类型定义 → JSON 转 TypeScript
• 后端要实体类 → JSON 转 Java / C# / Go
• 写接口契约 / 校验 → JSON Schema 生成

一、格式化与校验：先解决「看得懂」和「合不合法」

接口返回的 JSON 常常压成一行，人根本没法读。JSON 格式化 / 校验 做两件事：美化（按缩进换行展开，可选 2 空格 / 4 空格 / Tab）和校验（检查语法是否合法）。合法就美化输出，不合法就精确报出错在第几行第几列。

JSON 不合法？先查这 4 个高频原因

90% 的「JSON 解析失败」都是这 4 个：

1. 用了单引号——JSON 的键名和字符串必须双引号 `"`，单引号 `'` 一律非法。这是从 JavaScript 对象字面量复制过来最常见的坑。 2. 尾随逗号——数组 / 对象最后一个元素后多了逗号，如 `[1, 2, 3,]`。JS 允许，JSON 标准不允许。 3. 带注释——标准 JSON 不支持 `//` 或 `/* */`。那是 JSON5 / JSONC 的扩展，很多接口不认。 4. 键名没加引号——`{ name: 1 }` 是合法 JS 但非法 JSON，必须写成 `{ "name": 1 }`。

工具会把错误定位到具体行列，照着位置检查即可，比肉眼扫快得多。

二、深层嵌套：树形视图比纯文本强

海外 API（尤其是聚合类、GraphQL）经常返回深层嵌套的大 JSON。纯文本即使格式化了也难看清「某个值到底在第几层、归属哪个对象」。JSON 树形视图 把 JSON 渲染成可折叠的树、按值类型着色，默认展开前两层，点节点收放。先看整体骨架，再逐层深入，定位字段快很多。

三、转换类：JSON 转成你要的格式

这是出海场景最实用的一组。

JSON → CSV：导进 Excel 做分析

把接口返回的对象数组（订单、商品、广告数据）转成 CSV，直接粘进 Excel / Google Sheets。JSON 转 CSV 会取所有对象键的并集当表头，缺字段的格留空，并按 CSV 规范处理含逗号 / 引号 / 换行的值。要求输入是 `[{...}, {...}]` 形式的对象数组。

JSON → YAML：写 CI / K8s / 配置文件

YAML 是 JSON 的超集，用缩进代替大括号、更适合人写配置。JSON 转 YAML 把 JSON 配置改写成更易读的 YAML（CI/CD、Docker Compose、Kubernetes 清单常用）。字符串按需加引号——只有当值可能被 YAML 误解析（像数字 / 布尔、含特殊字符）时才加引号，保证还原正确。

JSON → 类型定义 / 实体类：省去手写

对接第三方 API 时，拿一段真实响应就能生成代码骨架：

• JSON 转 TypeScript——生成 interface，嵌套对象自动拆成独立 interface。
• JSON 转 Java / C# / Go——生成实体类 / struct（Go 带 `json` tag），切换语言 tab、自定义类名。

⚠️ 这类推断都基于单个样例：所有出现的字段会被当必填、数组按第一个元素推断类型。可选字段和联合类型（某字段有时是 number 有时是 null）需要你在生成结果上手工加 `?` / `| null`。建议用一份字段尽量齐全的样例。

JSON → Schema：写接口契约

JSON Schema 生成 从样例推断 draft-07 Schema（类型、properties、required），可复制给 ajv 等校验库、或给 AI 的 function calling / tool use 定义参数。同样：从单样例推断的是骨架，可选字段和 `format` / 范围约束要手工补。

四、为什么「不上传」很重要

跨境对接海外支付 / 物流 / 广告 API 时，JSON 里经常夹着 API Key、Access Token、Webhook 密钥、订单与收款信息。很多在线 JSON 工具会把你粘的内容发到它们服务器处理——等于把敏感数据交给第三方，可能被日志、缓存留存。

chdh.me 这套工具全程在你浏览器本地运行，不发任何网络请求、不落日志。含敏感字段的 JSON 也能放心处理。这也是我们把它们做成纯前端的核心理由。

五、编辑视角：什么时候别用在线工具

• 超大文件（几十 MB 以上）——本地运行受设备性能限制，可能让浏览器卡顿，改用命令行的 `jq` 更稳。
• 要批处理 / 进流水线——一次性转换用在线工具，反复自动化还是写脚本。
• 需要 JSON5 / JSONC（带注释、尾逗号的宽松 JSON）——标准 JSON 工具会报错，那是设计如此，先把非标语法去掉。

关于 chdh.me

出海导航 chdh.me 是面向中国跨境电商 / 独立站 / 海外 SaaS 创业者的独立工具评测与发现平台，并陆续自建一批纯本地、不上传的在线小工具。独立运营 · 纯公益 · 不接联盟链接 · 不接付费收录。上面提到的全部 JSON 工具见顶栏「JSON工具」下拉，或从 JSON 格式化 / 校验 进入。

对接海外 API 时除了 JSON，还常打交道的是编码与加密：请求签名、参数转义、令牌校验。这两块的用法与坑见姊妹篇——对接海外 API 的编码与加密速查（Base64 / URL / MD5 / SHA / AES / RSA）与 JWT 从原理到调试。