back
loading skill details...
提供JSON格式化（美化）、压缩、语法验证和JSONPath路径提取功能，适合开发调试和小文件处理。
---
slug: json-beautifier-free
name: json-beautifier-free
version: 1.0.0
displayName: JSON美化工具免费版
summary: 轻量级JSON格式化、压缩、验证与路径提取工具，适合日常开发调试与小文件处理。
license: Proprietary
edition: free
description: JSON美化工具免费版提供格式化、压缩、验证、路径提取四项核心能力，帮助开发者快速整理JSON数据，提升可读性与可维护性。核心能力：支持2/4空格缩进格式化、单行压缩、语法合法性验证、JSONPath路径提取；内置类型识别、键名排序、Unicode转义处理；提供标准化的结构化输出，便于下游消费。Use
when 需要代码生成、编程辅助、调试测试、开发部署时使用。不适用于无明确技术栈的模糊需求。
tags:
- 集成工具
- JSON
- 格式化
- 开发者工具
tools:
- - read
- exec
homepage: https://skillhub.cn
pricing_tier: "L1-入门级"
pricing_model: per_use
suggested_price: "9.9 CNY/per_use"
tools: ["read", "write", "exec"]
tags: "工具,效率,自动化"
---
# 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、需要代码生成、编程辅助、调试测试、开发部署时使用、不适用于无明确技、术栈的模糊需求等。
## 使用场景
| 场景 | 角色 | 价值 |
|---|---|---|
| API响应调试 | 后端开发者 | 快速美化API返回的压缩JSON |
| 配置文件整理 | 运维工程师 | 规范化缩进与键名顺序 |
| 日志数据提取 | 数据分析师 | 从日志JSON提取所需路径 |
| 前后端联调 | 全栈开发者 | 验证双方JSON结构一致性 |
| 学习教学 | 学生/教师 | 直观展示JSON嵌套结构 |
| 数据采样检查 | 测试工程师 | 快速浏览样本数据结构 |
## 使用流程
1. 阅读## 核心能力章节了解skill功能
2. 按## 依赖说明配置环境
3. 执行所需能力对应的命令
4. 参考## 错误处理章节处理异常
5. 查看## FAQ解答常见疑问
### 场景1：格式化压缩JSON
输入：
## 输入格式
| 参数名 | 类型 | 必填 | 说明 |
|:-----|:-----|:-----|:-----|
| input | string | 是 | JSON美化工具免费版处理的输入数据或指令 |
| options | object | 否 | 附加配置选项,如模式选择、格式偏好等 |
| callback_url | string | 否 | 异步处理完成后的回调通知URL |
```json
{"a":1,"b":2,"c":{"d":3,"e":[4,5]}}
```
输出：
```json
{
"a": 1,
"b": 2,
"c": {
"d": 3,
"e": [
4,
5
]
}
}
```
### 场景2：压缩美化后的JSON
输入：
```json
{
"a": 1,
"b": 2
}
```
输出：
```json
{"a":1,"b":2}
```
### 场景3：验证并提取路径
输入：
```json
{"user":{"name":"张三","age":30},"tags":["dev","vip"]}
```
结构化输出：
```json
{
"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]"
]
}
```
## 示例
### 格式化参数表
| 参数 | 类型 | 默认值 | 可选值 | 说明 |
|---:|---:|---:|---:|---:|
| `indent` | integer | 2 | 2/4/0 | 缩进空格数，0表示Tab |
| `sort_keys` | boolean | false | true/false | 是否按键名排序 |
| `ensure_ascii` | boolean | false | true/false | 是否转义非ASCII字符 |
| `compact` | boolean | false | true/false | 是否压缩为单行 |
### 输出结构字段说明
| 字段 | 类型 | 说明 |
|:---:|:---:|:---:|
| `formatted` | string | 格式化后的JSON字符串 |
| `valid` | boolean | 是否通过语法验证 |
| `size` | integer | 格式化后字符数 |
| `paths` | array | 所有叶子节点的JSONPath列表 |
### JSONPath语法速查
| 表达式 | 含义 |
|:------|------:|
| `$.key` | 根对象的key字段 |
| `$.key.subkey` | 嵌套字段 |
| `$[0]` | 数组首元素 |
| `$.key[*]` | 数组所有元素 |
| `$.key[0:2]` | 数组切片 |
## 最佳实践
### 缩进风格选择
- 团队协作推荐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的运行时
### 依赖详情
| 依赖项 | 类型 | 是否必需 | 获取方式 |
|---:|:---|---:|---:|
| LLM API | API | 必需 | 由Agent平台内置LLM提供 |
| JSON解析器 | 运行时 | 必需 | Node.js/Python内置 |
### API Key 配置
- 本skill基于Markdown指令规范，无需额外API Key
- 所有处理在本地完成，不依赖外部服务
### 可用性分类
- **分类**: MD+EXEC（纯Markdown指令，部分功能需要exec命令行执行能力）
- **说明**: 基于Markdown的AI Skill，通过自然语言指令驱动Agent执行JSON的格式化、压缩、验证与路径提取任务
## 错误处理
| 错误场景 | 原因 | 处理方式 |
|:------:|--------|:-------|
| 配置错误 | 参数缺失或格式错误 | 检查依赖说明中的配置要求 |
| 运行时错误 | 运行环境不满足 | 确认运行环境符合依赖说明 |
| 网络错误 | 连接超时或不可达 | 执行ping命令测试网络连通性,检查防火墙和代理设置连接后执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令，参考国内替代方案 |
don't have the plugin yet? install it then click "run inline in claude" again.