Python脚本在Sublime Text运行失败但命令行正常的编码问题排查

你的问题核心在于Python的默认文件编码依赖于运行环境的系统变量——哪怕是同一个Python可执行文件，不同运行场景下的环境变量差异，也会导致open()的默认编码出现不同。

为什么会出现这种差异？ #

Python在没有显式指定编码时，会从系统的LC_CTYPE或LANG环境变量中获取默认编码：

• 命令行激活虚拟环境后，终端会传递自己的环境变量（通常是UTF-8，比如LC_CTYPE=en_US.UTF-8）给Python，所以open()默认用UTF-8读取文件，自然能正常处理含非ASCII字符的foo.txt。
• Sublime Text作为图形界面程序，它的环境变量和终端是隔离的，默认可能没有设置UTF-8相关变量，导致Python fallback到ASCII编码，读取包含特殊字符的文件时就抛出了UnicodeDecodeError。

解决方法 #

1. 显式指定文件编码（推荐）

这是最可靠的方式，彻底摆脱环境依赖。直接修改你的open语句，根据文件实际编码指定参数：

open('foo.txt', encoding='utf-8').read()

如果文件是其他编码（比如GBK、UTF-16），对应调整encoding的值即可。

2. 修改Sublime Text构建系统，添加环境变量

在你的构建系统配置中，新增env字段，强制设置编码相关的环境变量：

{ 
    "cmd": ["env/bin/python3", "$file"], 
    "selector": "source.python", 
    "file_regex": "^\\s*File \"(...*?)\", line ([0-9]*)",
    "env": {"LC_CTYPE": "en_US.UTF-8"}
}

保存配置后，重新选择该构建系统运行脚本即可。

3. 从终端启动Sublime Text（MacOS适用）

如果你的终端环境变量配置正确，可以通过终端启动Sublime Text，让它直接继承终端的环境变量：

open /Applications/Sublime\ Text.app

这样Sublime Text运行Python时，就会使用和终端完全一致的编码设置。

内容的提问来源于stack exchange，提问作者Bemmu