解决sublime构建输出乱码需在.sublime-build中强制指定"encoding": "utf-8",并用python -u确保无缓冲utf-8输出,windows下须用绝对路径调用python.exe,改后需手动切换构建系统生效。

构建系统输出乱码本质是子进程编码没对齐
Sublime 的 exec 构建目标本身不处理编码转换,它只是把子进程的 stdout/stderr 原样丢进输出面板。Python 脚本用 UTF-8 保存、含中文 print,但 Windows 默认 chcp 是 936(GBK),Sublime 没显式指定 "encoding" 时就会按系统 locale 解码——结果就是字节流被当成 GBK 解,UTF-8 的中文就变成一堆 。
必须在 .sublime-build 里写死 "encoding": "utf-8"
这个字段不是可选项,是解决乱码的刚性条件。它告诉 Sublime:不管系统是什么 locale,都用 UTF-8 去 decode 子进程输出的字节流。
-
"encoding"必须是字符串,值写"utf-8"或"UTF-8"都行,大小写不敏感,但不能写"UTF8"或"utf8"(Sublime 会静默忽略) - 仅设
"encoding"不够:Python 3 默认 stdout 是行缓冲,且可能因 locale 自动启用 surrogateescape,所以还得加-u参数强制无缓冲 + 强制 UTF-8 输出 -
"cmd"推荐用数组形式,避免 shell 解析歧义;若用"shell_cmd",需确保路径中无空格或已转义
{
"cmd": ["python", "-u", "$file"],
"encoding": "utf-8",
"syntax": "Packages/Python/Python.sublime-syntax"
}
Windows 下必须用绝对路径调用 python.exe
Sublime 的构建系统在 Windows 上默认走 cmd.exe /c,而 cmd 启动的子进程继承的是 cmd 的 codepage(比如 936),不是 Python 进程自己的 locale。靠环境变量或 set PYTHONIOENCODING=utf-8 在这里基本无效。
- 不要依赖 PATH 查找
python,直接填绝对路径,例如"C:/Users/xxx/AppData/Local/Programs/Python/Python311/python.exe" - 路径中反斜杠要写成正斜杠或双反斜杠,否则 JSON 解析失败
- 如果用 WSL 的 Python,路径得是
"C:/Windows/System32/wsl.exe"加参数,但更推荐用原生 Windows Python 避免额外跳转
改完构建系统后必须手动切换一次才生效
Sublime 不会自动 reload 当前激活的构建系统。哪怕你保存了 .sublime-build 文件,输出面板仍沿用旧配置。
- 快捷键
Ctrl+Shift+P→ 输入Build With→ 回车 → 选你刚改的那个构建系统名称 - 或者菜单栏
Tools → Build System → [你的构建系统名] - 注意:如果构建系统文件名含空格或特殊字符(如
My Python (UTF-8).sublime-build),Sublime 可能无法识别,建议只用字母、数字、下划线
最容易被忽略的一点:"encoding" 只管输出解码,不管 Python 脚本里 open() 读写文件的行为——那得靠脚本自己设 encoding="utf-8"。构建系统的 "encoding" 字段,只负责把终端吐出来的字节,正确还原成你该看到的中文。











