为什么需要 JSON 格式化
接口返回、日志导出、配置文件里的 JSON 经常是一整行，肉眼难找字段。缩进对齐后，对象层级和数组下标一目了然，联调与 code review 都更快。
ComTools JSON 格式化（Tools/Json/Formatter）在浏览器本地解析并美化 JSON，不上传服务器。
主要能力
| 功能 | 说明 |
|---|---|
| 缩进 | 2 空格、4 空格或 Tab |
| 语法高亮 | 键、字符串、数字、布尔/null 分色 |
| 行号与折叠 | 可折叠 { / [ 块，方便浏览大对象 |
| 上传文件 | 选择本地 .json 文本文件后自动格式化 |
| 错误提示 | 非法 JSON 显示解析错误信息 |
使用步骤
- 打开 JSON 格式化。
- 粘贴 JSON，或点击 上传 选择文件；也可点 示例。
- 选择缩进（默认 2 空格）。
- 点击 运行 / 格式化。
- 成功后编辑器内即为美化结果，可 复制 带走。
示例
压缩输入：
{"name":"ComTools","free":true,"tools":["json","excel"]}
2 空格缩进输出：
{
"name": "ComTools",
"free": true,
"tools": [
"json",
"excel"
]
}
常见场景
| 场景 | 做法 |
|---|---|
| 接口联调看响应 | 从 DevTools / Postman 复制 → 格式化 |
| 配置文件可读化 | 上传 .json → 格式化 → 复制回仓库 |
| 只要压缩成一行 | 用 JSON 压缩 |
| 不确定是否合法 | 先 JSON 校验 |
| Excel 导出的 JSON | Excel 转 JSON 后再格式化 |
与校验、压缩的分工
| 需求 | 工具 |
|---|---|
| 美化缩进、折叠阅读 | JSON 格式化 |
| 只关心合不合法 | JSON 校验 |
| 传输体积最小化 | JSON 压缩 |
| 两段差异 | JSON 对比 |
格式化本身也会先做 JSON.parse；失败时等同校验不通过，需先修语法再美化。
注意事项
- 仅支持标准 JSON（双引号键名等）；尾逗号、单引号等 JS 对象字面量会报错。
- 超大文件建议在本地编辑器处理；浏览器内存有限。
- 数据本地处理，适合含敏感字段的接口响应（勿在不可信电脑上操作）。
常见问题
Q：格式化后顺序变了？
A：现代引擎大体保留键插入顺序；不要依赖 JSON 对象键序做协议。
Q：能否排序键名？
A：当前工具按解析结果原样 stringify，不做键排序。
Q：和 VS Code 格式化有何区别？
A：网页即开即用，带折叠与高亮；适合临时粘贴排查。