Python原生json模块不支持注释，因JSON标准（RFC 8259）明确禁止；应改用json5（支持注释、单引号、尾逗号）或commentjson（保留注释位置信息），或用jq预处理脏数据。
Python原生json模块无法解析带注释的JSON
直接用json.load()或json.loads()读取含//或/* */注释的文件，会抛出json.decoder.JSONDecodeError——因为JSON标准（RFC 8259）明确不支持注释。这不是bug，是设计如此。别指望改几个参数就能绕过。
常见错误现象：Expecting property name enclosed in double quotes 或 Invalid \escape，其实根源常是注释被当成非法字符解析了。
- 别手动删注释再读：容易误删字符串里的
//（比如URL），也难处理嵌套注释 - 别用正则粗暴替换：JSON字符串里可能含
"//"，正则很难安全区分注释与内容 - 真正可行的是换解析器，或预处理时保留语义结构
用json5库安全读取带注释、单引号、尾逗号的JSON-like文件
json5是JSON的超集，兼容ES5语法，支持注释、单引号字符串、末尾逗号、未加引号的键名等。它不是“修JSON”，而是按另一套规范解析——对配置文件、前端mock数据特别友好。
安装：pip install json5
立即学习“Python免费学习笔记（深入）”；
用法几乎和标准json一致：
import json5
<p>with open("config.json5", "r", encoding="utf-8") as f:
data = json5.load(f) # 不是 json.load()</p>- 支持
//行注释和/* */块注释，且能正确跳过字符串内的注释符号 - 允许
{name: "foo"}这种无引号键名（但注意：Python字典键仍是字符串，不会变成变量名） - 容忍
[1, 2,]末尾逗号，避免git diff污染 - 性能略低于原生
json，但对配置类场景影响可忽略
用commentjson处理已有JSON文件但需保留注释元信息
如果项目要求“读取时知道哪行是注释”，比如做配置校验、生成文档，commentjson能返回带注释位置的AST结构。它底层用pyparsing，比json5重，但提供额外能力。
安装：pip install commentjson
基础用法：
import commentjson
<p>with open("api_spec.json", "r") as f:
data = commentjson.load(f) # 返回普通dict，注释被丢弃</p>- 若需要注释原文，得用
commentjson.loads(text, preserve_comments=True)，返回特殊对象，含__comment__属性 - 不支持单引号字符串，只扩展JSON标准（加注释、尾逗号），比
json5更保守 - 遇到
NaN、Infinity等非标准值会报错，而json5默认接受
格式严重损坏时：先用jq命令行工具清洗再进Python
当文件混杂HTML标签、BOM头、多余空格、乱码甚至部分缺失括号时，Python库容易崩溃。此时不如交给jq——它专为JSON流设计，容错强、速度快。
示例：清洗并验证一个脏JSON文件
jq -c 'del(.comments)' dirty.json > clean.json
# 或直接管道给Python
cat dirty.json | jq -r '.host + ":" + (.port|tostring)' | python -c "import sys; print('API endpoint:', sys.stdin.read().strip())"
-
jq能自动修复BOM、标准化缩进、删除无效字段，比手写正则可靠得多 - Windows用户需装
jq或用wsl；macOS用brew install jq；Linux多数发行版自带 - 注意：
jq输出默认是纯JSON，无注释，适合后续用原生json加载
真正麻烦的不是注释本身，而是团队把JSON当通用配置格式用，又不统一规范。选json5还是commentjson，取决于你是否需要运行时感知注释——大多数情况，前者够用；真要生成文档或做配置审计，后者才值得引入。
