Python 源文件声明 gbk 实际存成 UTF-8 报 Non-UTF-8 code

file -i app.py
head -3 app.py | cat -A
sed -i '1,2s/coding[:=].*gbk/coding: utf-8/' app.py

脚本第二行写着 coding: gbk，文件实际是 UTF-8。运行报 SyntaxError: Non-UTF-8 code starting with '\xe4' in file app.py on line 3。这类现象通常不是突然出现的，往前翻半天日志能看到苗头。

追下去是这么回事：解释器按声明的编码解码源码，声明和真实字节不一致，非 ASCII 部分立刻解错。PEP 263 会先扫前两行找声明，找到就以它为准，不再猜。

这次卡住的地方就在「源文件编码声明」这一环，单独把它拎出来验证，别和其他改动混在同一次发布里。同类问题如果隔一段时间又出现，多半是某个定时任务或重启流程把改动冲掉了。

把这次用到的命令存进笔记，比记住结论有用，换个环境还能照着走。改完隔一天再看一次，当场正常不代表能稳住。

测试环境和线上的差别，往往就在版本号和那几行被忽略的配置上。

处理上按这个顺序：用 file -i 确认文件真实编码；声明改成 utf-8 或者直接删掉 默认就是 UTF-8；批量转换后抽查注释里的中文；编辑器统一保存编码 别让两种混在同一个仓库。

确认没问题再收工，python app.py 不再报编码错误 注释里的中文能正常打印。