Repository navigation
v2.5.2 — 🐛 真正的红:`open()` 没写 `encoding`,在英文版 Windows 上读 UTF-8 会炸
🐛 真正的红:open() 没写 encoding,在英文版 Windows 上读 UTF-8 会炸
v2.5.1 修的是「测试假装自己是 UTF-8」,修完 CI 还是红。拿到真实堆栈后才看清:
UnicodeDecodeError: 'charmap' codec can't decode byte 0x8d in position 579
readiness-gate action 里用内联 python -c 'json.load(open(sys.argv[1]))["score"]' 读报告。open() 不写 encoding 就用系统 ANSI 代码页:GitHub 的 Windows 运行器是英文版,代码页 1252,而 hpp audit --json 输出的是 UTF-8,0x8d 在 cp1252 里是未定义字节——直接抛异常。于是 action 一个分数都没报出来,测试断言 'score=0' in '' 才失败。
这个 bug 在我本机永远复现不了:cp936(GBK)几乎能解任何字节序列,中文 Windows 上「UTF-8 文件用默认编码读」看起来一直是对的。这是本仓库最想防的那类问题——不是逻辑错,是环境假设错。
scripts/audit_field.py(新):把「从报告里取字段」从 YAML 里的内联 Python 挪成可导入、可测试的脚本,显式encoding="utf-8"。action 改为调用它。- 两处同族隐患一并修掉:
cli/hpp.py的open(os.devnull, 'w')、check_docs_consistency.py里git tag的subprocess.run(text=True)都补上encoding。 - 加机械门禁
tests/test_file_encoding.py(7 例):- AST 扫描
cli/与scripts/下所有随仓库运行的 Python,任何文本模式open()/read_text()/write_text()缺encoding=就红; - 扫描
.github/workflows/*.yml与.github/actions/**/action.yml的run:块,禁止内联python -c——这类代码测不到,正是本次踩坑的地方。 - 这条门禁本身就是本仓库的公约:只写在文档里的约束等于默认违规(反模式 #13)。
- AST 扫描
scripts/audit_field.py的测试(6 例):字段顺序、含中文的报告、缺字段返回空串但退出 0、报告缺失/损坏时退出 2 且不打Traceback。