JSON美化工具（免费版）

本工具提供JSON数据的格式化、压缩、验证与路径提取能力，帮助开发者快速整理JSON，提升可读性，并为下游处理提供标准化输出。

概述

JSON是现代API与配置文件的主流数据格式，但原始JSON往往以压缩形式传输，可读性差；或因手写编辑导致缩进混乱、语法错误。本工具围绕JSON的"整理"场景，提供四项核心能力：格式化（美化）、压缩（最小化）、验证（语法检查）、路径提取（JSONPath）。

核心能力

格式化（美化）

• 支持2空格、4空格、Tab三种缩进风格
• 自动处理嵌套结构的缩进对齐
• 保留或规范化字符串转义
• 支持Unicode字符的转义与原样输出两种模式

输入: 用户提供格式化（美化）所需的指令和必要参数。 处理: 解析格式化（美化）的输入参数,完成核心逻辑,返回结构化响应。 输出: 返回格式化（美化）的响应数据,包含状态码、结果和日志。

压缩（最小化）

• 移除所有非必要空白字符
• 保留字符串内部的合法空格
• 输出单行紧凑JSON，适合网络传输
• 压缩率指标反馈

输入: 用户提供压缩（最小化）所需的指令和必要参数。 处理: 解析压缩（最小化）的输入参数,完成核心逻辑,返回结构化响应。 输出: 返回压缩（最小化）的响应数据,包含状态码、结果和日志。

验证（语法检查）

• 检测JSON语法错误并定位行列号
• 识别常见错误：尾随逗号、单引号、未转义字符
• 输出结构化错误报告
• 不修复错误，仅报告（修复能力在专业版）

输入: 用户提供验证（语法检查）所需的指令和必要参数。 处理: 解析验证（语法检查）的输入参数,完成核心逻辑,返回结构化响应。 输出: 返回验证（语法检查）的响应数据,包含状态码、结果和日志。

路径提取

• 生成所有叶子节点的JSONPath路径
• 路径格式：$.key.subkey[0].name
• 支持按路径前缀过滤
• 输出路径与值的映射表

输入: 用户提供路径提取所需的指令和必要参数。 处理: 解析路径提取的输入参数,完成核心逻辑,返回结构化响应。 输出: 返回路径提取的响应数据,包含状态码、结果和日志。 技术参数：使用input_params和output_format参数控制执行行为,支持json/text/csv输出格式。 能力覆盖范围：本skill的核心能力覆盖以下场景关键词：轻量级、JSON、格式化、验证与路径提取工、适合日常开发调试、与小文件处理、美化工具免费版提、供格式化、路径提取四项核心、帮助开发者快速整、提升可读性与可维、核心能力、空格缩进格式化、单行压缩、语法合法性验证、JSONPath、路径提取、内置类型识别、键名排序、Unicode、转义处理、提供标准化的结构、化输出、便于下游消费、Use、when、需要代码生成、编程辅助、调试测试、开发部署时使用、不适用于无明确技、术栈的模糊需求等。

使用场景

使用流程

1. 阅读## 核心能力章节了解skill功能
2. 按## 依赖说明配置环境
3. 执行所需能力对应的命令
4. 参考## 错误处理章节处理异常
5. 查看## FAQ解答常见疑问

场景1：格式化压缩JSON

输入：

输入格式

{"a":1,"b":2,"c":{"d":3,"e":[4,5]}}

输出：

{
  "a": 1,
  "b": 2,
  "c": {
    "d": 3,
    "e": [
      4,
      5
    ]
  }
}

场景2：压缩美化后的JSON

输入：

{
  "a": 1,
  "b": 2
}

输出：

{"a":1,"b":2}

场景3：验证并提取路径

输入：

{"user":{"name":"张三","age":30},"tags":["dev","vip"]}

结构化输出：

{
  "formatted": "{\n  \"user\": {\n    \"name\": \"张三\",\n    \"age\": 30\n  },\n  \"tags\": [\n    \"dev\",\n    \"vip\"\n  ]\n}",
  "valid": true,
  "size": 78,
  "paths": [
    "$.user.name",
    "$.user.age",
    "$.tags[0]",
    "$.tags[1]"
  ]
}

示例

格式化参数表

输出结构字段说明

JSONPath语法速查

最佳实践

缩进风格选择

• 团队协作推荐2空格（节省垂直空间）
• 教学演示推荐4空格（层级更清晰）
• 生产传输推荐压缩（节省带宽）
• 配置文件推荐保持原缩进（避免diff噪音）

键名排序策略

• 配置文件建议按字母排序，便于查找
• API响应不建议排序，保持业务语义顺序
• 缓存键建议排序，确保序列化稳定性

Unicode处理

• 含中文的JSON建议ensure_ascii=false，提升可读性
• 跨系统传输建议ensure_ascii=true，避免编码问题
• 日志场景建议原样输出，便于人工阅读

验证与修复分离

• 本免费版仅验证不修复，确保操作可预测
• 修复能力由专业版提供，包含尾随逗号、单引号等自动修复
• 生产环境建议先验证再处理，避免静默错误

常见问题

Q1：格式化后中文变成\uXXXX怎么办？

A：这是Unicode转义模式。将ensure_ascii设为false即可保留中文原样。默认值即为false，若出现转义说明参数被误改。

Q2：验证报错但看不出哪里错了？

A：本工具的错误报告包含行列号。优先检查报错位置的前一个字符，常见原因是尾随逗号或单引号。专业版提供更详细的错误上下文与修复建议。

Q3：路径提取漏了某些字段？

A：路径提取仅生成叶子节点（非对象、非数组的值）的路径。若某字段是对象或数组，其路径不会单独列出，但其子节点的路径会包含父级前缀。

Q4：压缩后体积没明显减小？

A：若原JSON已是压缩格式或键值都很短，压缩空间有限。压缩率取决于原JSON的空白量与缩进深度。可查看size字段对比前后大小。

Q5：键名排序后业务语义混乱？

A：排序是为缓存键稳定性设计，不适用于所有场景。API响应与业务文档建议保持原序，仅在需要哈希一致性时启用排序。

已知限制

本免费体验版限制以下高级功能：

• 单次处理文件大小 > 1MB
• 批量文件处理（目录级扫描）
• 自动修复（尾随逗号、单引号、未转义字符）
• 自定义输出模板与字段映射
• 流式处理（超大JSON分块解析）
• 差异对比（两个JSON的结构差异）

解锁全部功能请使用专业版：json-beautifier-pro

• 当前为免费版本,如需完整功能请升级到付费版获取全部能力

依赖说明

运行环境

• Agent平台: 支持SKILL.md的任意AI Agent（Claude Code / Cursor / Codex / Gemini CLI等）
• 操作系统: Windows / macOS / Linux
• JSON解析: 任意支持JSON.parse/JSON.stringify的运行时

依赖详情

API Key 配置

• 本skill基于Markdown指令规范，无需额外API Key
• 所有处理在本地完成，不依赖外部服务

可用性分类

• 分类: MD+EXEC（纯Markdown指令，部分功能需要exec命令行执行能力）
• 说明: 基于Markdown的AI Skill，通过自然语言指令驱动Agent执行JSON的格式化、压缩、验证与路径提取任务

错误处理