json_repair

一键修复 LLM 输出的坏 JSON，解析不再报错

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署开源模型 🍴 复刻 232 👀 关注 11

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 5136

维护状态活跃

是否开源开源

定价模式 🏷️完全免费开源项目，MIT 许可证，完全免费，可自行部署使用。

项目预览

json_repair 项目界面预览图 — 图片来源：GitHub 官方仓库名片

项目数据

分类开源模型

开发团队mangiucugna

官网地址https://mangiucugna.github.io/json_repair

GitHubhttps://github.com/mangiucugna/json_repair

定价模式🏷️完全免费

价格说明开源项目，MIT 许可证，完全免费，可自行部署使用。

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议MIT

主要语言Python

技术栈/模型cli,json,json-repair,json-schema,llm,llm-output,malformed-json,parser,pydantic,python,streaming,structured-output

GitHub 星标★ 5136

上线时间2023-09-06 00:00:00

代码更新2026-11-10

仓库体积7.3 MB

本站数据更新2026-11-10

维护状态活跃

收录时间2026-08-09

浏览次数5

项目介绍

json_repair 是一个 Python 库，专门用于修复来自大语言模型（LLM）、API、日志或用户输入中的畸形 JSON 字符串。它解决了 AI 生成内容中常见的 JSON 格式错误问题，如缺少引号、多余逗号、截断、转义错误等，使得下游程序无需手动干预即可解析这些不完美的数据。核心能力包括：自动检测并修复多种常见的 JSON 语法错误，提供与标准 json.loads 兼容的接口，支持流式解析（针对不完整 JSON），并允许自定义修复策略。项目轻量、无外部依赖，易于集成到现有 Python 项目中，尤其适合需要处理 LLM 输出或非严格 JSON 数据的场景。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 5136

技术标签

cli json llm parser pydantic

使用教程

难度：入门约 5 分钟部署方式：库/依赖 4 步

环境要求

已安装 Python 环境（README 未指明具体版本要求）
已安装 pip 包管理工具
可正常访问 PyPI 以安装 json-repair

安装与启动步骤

1安装 json-repair

README 明确指出使用 pip 安装该库，这是集成到项目中的唯一安装方式。
```
pip install json-repair
```

2运行官方示例验证

把 README 的 Quick example 写成脚本运行，确认畸形 JSON 能被正确修复并打印出对象。

cat > test_repair.py <<'EOF'
import json_repair

bad_json = '{"users":[{"name":"Ada","role":"admin",}],"ok":true'
decoded_object = json_repair.loads(bad_json)
print(decoded_object)
EOF
python test_repair.py

3替代 json.loads

README 说明该库可完全替代 json.loads：直接 import json_repair 后调用 json_repair.loads(json_string) 即可。
4需要修复后字符串时

若只想拿到修复后的 JSON 字符串，用 repair_json；要对象则加 return_objects=True，字符串损坏过重会返回空字符串。

关键配置

配置项	必填	说明	示例
`PYTHONANYWHERE_API_TOKEN`	否	仅官方文档站同步到 PythonAnywhere 的 Actions 仓库密钥，普通用户无需配置	`your-pythonanywhere-api-token`