核心用法
json-toolkit 是一款基于 Python 标准库构建的 JSON 处理工具，无需额外依赖即可在命令行中完成常见的 JSON 操作。核心功能包括：
- 格式化输出：通过
--indent参数指定缩进空格数（默认 2 格），生成可读性强的 JSON； - 压缩体积：
--minify模式去除所有空白字符，适合 API 传输与生产环境部署； - 结构校验：
--validate仅验证文件合法性，并输出类型、键数量、字节大小等统计信息； - 路径查询：支持点号表示法（dot-notation）访问嵌套字段，如
data.users.0.email，兼容数组索引； - 键排序：
--sort-keys按字母序排列对象键，便于版本控制中的 diff 对比； - 管道集成：支持
-作为 stdin 输入源，可与curl、cat等命令无缝衔接。
显著优点
- 零依赖：仅依赖 Python 内置
json与sys模块，部署极轻量； - 接口统一：所有操作通过单一入口脚本完成，学习成本低；
- 输出可控：支持重定向到文件或标准输出，方便脚本化集成；
- 查询语法直观：点号路径符合开发者直觉，无需学习复杂的 JSONPath 或 jq 语法。
潜在局限
- 功能边界：相比
jq等专用工具，缺少高级过滤、映射、聚合运算能力； - 性能瓶颈：纯 Python 实现，处理 GB 级大文件时可能内存占用较高；
- 错误处理：文档未明确说明 malformed JSON 的退出码与 stderr 输出格式，自动化场景需额外测试；
- 无交互模式：仅支持一次性命令执行，无法作为 REPL 持续查询。
适合人群
- 需要轻量 JSON 格式化/校验的 DevOps 工程师；
- 编写自动化脚本、CI/CD Pipeline 的开发者；
- 不愿安装
jq或 Node.js 依赖的 Python 环境用户； - 需要快速提取嵌套字段的测试人员或数据分析师。
常规风险
- 输入验证：若将不可信来源的 JSON 直接传入
--query路径，需警惕路径注入或异常深层递归导致的资源耗尽； - 文件覆盖：
-o参数若指向已有文件，可能直接覆盖而无提示，建议配合版本控制或备份策略； - 编码问题：未提及对非 UTF-8 编码的处理逻辑，跨平台使用时需提前验证文件编码。