Sublime Text控制台中文乱码必须修改.sublime-build文件,用"cmd"数组模式、指定Python绝对路径、加"-u"参数、顶层设"encoding":"utf-8",且改完需手动切换构建系统生效。

Sublime Text 汉化后控制台(Build Results)仍乱码,和菜单汉化是否成功完全无关——控制台输出乱码只由构建系统编码配置决定,不是字体、语言包或界面汉化的问题。
为什么汉化了菜单,控制台还是“涓枃”?
菜单乱码和控制台乱码是两套独立渲染链路:
菜单走的是 UI 字体 + 系统 locale + ST 内部字符串表;
而控制台(Build Results)显示的是 Python 子进程的 stdout 字节流,Sublime 默认不指定解码方式,Windows 下就用 GBK 去 decode UTF-8 输出,必然得到“涓枃”。
改 font_face、装汉化包、切右下角编码,对 Build Results 窗口零影响。
必须修改 .sublime-build 文件中的 encoding 字段
这是唯一可靠路径。其他所有“环境变量”“chcp 65001”“PYTHONIOENCODING”在 Sublime 启动的 subprocess 中均被 Python 官方明确标记为无效(尤其 Windows)。
-
"encoding": "utf-8"必须作为顶层字段写入.sublime-build文件,不能嵌在"cmd"里 - 必须用
"cmd"数组模式,不能用"shell_cmd"(后者直接忽略encoding) -
"cmd"中的 Python 路径必须是绝对路径(如"D:/Python39/python.exe"),避免环境变量歧义 - 务必加
"-u"参数:禁用 stdout 缓冲,否则中文可能卡住不输出
正确示例(保存为 Python3.sublime-build):
{
"cmd": ["D:/Python39/python.exe", "-u", "$file"],
"file_regex": "^.*?File \"(.*?)\", line ([0-9]*)",
"encoding": "utf-8",
"selector": "source.python"
}改完配置后必须手动切换构建系统
这是 90% 用户跳过的致命步骤:
保存 .sublime-build 文件 ≠ 生效。
必须手动执行 Tools → Build System → Python3(或你命名的名称),让 Sublime 主动加载新配置。
确认右下角状态栏显示的构建系统名称与你刚保存的文件名一致。
- 如果仍显示“Automatic”或旧名称,说明没切换,控制台继续走默认(GBK)解码
- 脚本开头的
# -*- coding: utf-8 -*-对 Python 3 非必需,但建议保留——防止某些旧构建系统误判源码编码 - 确保脚本文件本身是 UTF-8 无 BOM 格式(Notepad++ 可验证:“编码 → 转为 UTF-8 无签名”)
真正麻烦的点不在写 JSON,而在于:每个 Python 安装路径不同、每台 Windows 的 codepage 隐式干扰不同、且 Sublime 不提示你“当前构建系统未生效”。


















