先手动执行Reopen with Encoding → Chinese (GBK)使中文可读,再Save with Encoding → UTF-8转存磁盘;ST4已移除fallback_encoding,须设default_encoding_on_save为"UTF-8"且save_with_bom为false。

Sublime Text 显示中文乱码,不是文件坏了,也不是编辑器出问题,而是它用 UTF-8 去解一个实际是 GBK 的字节流——结果必然是“锟斤拷”或方块。真正要做的,不是改一堆配置,而是先让内容能读,再决定要不要改磁盘文件。
Reopen with Encoding 选对原始编码才能显示中文
右下角显示的 “UTF-8” 或 “Western (ISO 8859-1)” 只是 Sublime 当前怎么读这个文件,不是文件真实编码。你看到乱码,恰恰说明它正在用错的方式读。
- 打开乱码文件后,立刻点击右下角当前编码名 → 选
Reopen with Encoding→Chinese (GBK) - 如果还是乱码,再试
Chinese (GB2312)或Western (Windows 1252);只要中文一出来,右下角变成Chinese (GBK),就说明原始编码识别对了 - 别点
Convert to UTF-8(老版本菜单里有):它会静默重写文件且不提示,原始编码信息直接丢失 - 确认真实编码最可靠方式:
file -i 文件名(Linux/macOS),看输出里的charset=gbk;Windows 用户用 Notepad++ 打开,右下角直接显示GBK或UTF-8-BOM
Save with Encoding → UTF-8 才是真正转码动作
前面所有操作(包括插件自动转换)都只影响内存里的显示,不碰磁盘一字节。只有这一步,才把当前已正确解码的 Unicode 内容,严格按 UTF-8 编码规则重新写回文件。
- 必须在
Reopen with Encoding→Chinese (GBK)确认中文完全正常后,再执行File→Save with Encoding→UTF-8(注意:不是UTF-8 with BOM) - 保存后关闭再重开,右下角应显示
UTF-8,且中文依然正常;如果别人用记事本打开还是乱码,说明上一步没做对——文件根本没被正确识别为 GBK - 验证是否真去除了 BOM:
xxd 文件名 | head -n1,输出不含ef bb bf才算干净 - 保存失败或静默丢字?可能是文件含 GB18030 混合变体或异常控制字符,建议先用 Notepad++ 转一次再回 Sublime
Sublime Text 4 用户必须改的配置项
ST4 彻底移除了 fallback_encoding,所谓“全局兜底编码”不复存在。你加 "fallback_encoding": "Chinese (GBK)" 到设置里,完全无效。
- 真正控制保存行为的是
default_encoding_on_save:设为"UTF-8"(注意大小写和短横),就能强制所有Ctrl+S静默以 UTF-8 写入磁盘 -
default_encoding已被官方标记为“已弃用”,它只影响新建空文件右下角显示的编码标识、以及“另存为”对话框默认选中的编码项,不控制Ctrl+S的实际写入编码 - 顺手加一行:
"save_with_bom": false,否则保存后 Python/Git 会报Non-UTF-8 code starting with '\xef' - 别信网上教程让你设
"fallback_encoding": "UTF-8"——这会让 GBK 文件更乱,且在 ST4 中完全被忽略
ConvertToUTF8 插件现在还值得装吗?
对 Sublime Text 4(Build 4126+)用户,基本不推荐。它自 2020 年起停止更新,ST4 的 API 变动导致常见失效现象:状态栏不显示编码名、右键无反应、Package Settings 里压根找不到入口。
- 即使强行安装,也容易和原生编码逻辑冲突,造成状态栏显示错乱或保存行为异常
- 如果你必须用(比如维护老 ST3 项目),注意三点:只能通过
Package Control: Install Package安装;装完必须重启;首次启用后要进Preferences → Package Settings → ConvertToUTF8 → Settings – User,填入配置:{"convert_on_load": true,"convert_on_save": true,"confidence": 0.95} - 其中
confidence设太高(如 0.98)会漏掉弱信号 GBK 文件,太低(0.85)又可能把带 BOM 的 UTF-8 错判为 GBK - 删掉任何
detect_encoding: true—— 它会让 Sublime 主动跳过 BOM 去试 GBK,把真正的 UTF-8+BOM 文件搞乱
最常被忽略的一点:ST4 中没有“全局 fallback”,遇到乱码文件必须手动 Reopen with Encoding → Chinese (GBK),而不是指望某个配置自动生效。哪怕你配齐了所有选项,第一步人工确认原始编码,仍是不可跳过的硬步骤。











