Sublime Text 4 原生支持 GBK/GB18030 自动探测,禁用 ConvertToUTF8;乱码时应先 Reopen with Encoding → Chinese (GBK),再 Save with Encoding → UTF-8,并配置 fallback_encoding 为 "Chinese (GBK)"。

ConvertToUTF8 在 Sublime Text 4 中已失效,别装它
Sublime Text 4(Build 4126+)原生支持 GBK/GB18030 自动探测,强行安装 ConvertToUTF8 不仅不会修复乱码,反而会破坏右下角编码显示、禁用右键菜单、让 Package Settings 配置项消失。你看到的“汉化文本乱码”,90% 是文件真实编码为 GBK,而 Sublime 默认用 UTF-8 去解——结果就是“锟斤拷”或方块字,不是字体问题,也不是编辑器坏了。
Reopen with Encoding → Chinese (GBK) 是唯一安全救急操作
打开乱码文件后,右下角显示的 “UTF-8” 或 “Western (ISO 8859-1)” 只是当前解码方式,不是文件真实编码。盲目点状态栏切换、改 default_encoding 都没用。
- 立刻点击右下角当前编码名 → 选
Reopen with Encoding→Chinese (GBK)(有时也叫CP936) - 如果还是乱码,依次试
Chinese (GB2312)、Western (Windows 1252);只要中文一出来、右下角变成Chinese (GBK),就说明解码成功 - 这一步只改内存显示,磁盘文件一字未动,可反复试,绝对安全
- 千万别点老版本里的
Convert to UTF-8——它会静默重写文件且不提示,原始编码信息直接丢失
Save with Encoding → UTF-8 才是真正转码动作
前面所有操作都只是“让内容能看懂”,只有这一步才修改磁盘文件。跳过上一步直接执行,等于把乱码字节再按 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
用户设置里 fallback_encoding 必须设为 "Chinese (GBK)"
fallback_encoding 字段不接受标准编码名,写 "UTF-8" 是无效配置。Sublime 只认内置标识符,比如 "Chinese (GBK)"。
- 推荐配对使用:
"default_encoding": "UTF-8"+"fallback_encoding": "Chinese (GBK)" -
default_encoding已被官方标记为“已弃用”,它只影响新建空文件右下角显示的编码标识,不控制Ctrl+S的实际写入编码 -
fallback_encoding是“读取失败时尝试的备选编码”,比default_encoding更安全:它只在 UTF-8 解码失败时触发,不会干扰正常 UTF-8 文件 - 务必删掉配置里可能存在的
"detect_encoding": true——这个开关会让 Sublime 主动跳过 BOM 去试 GBK,反而把带 BOM 的 UTF-8 文件判成乱码
ST4 用户该装 Codecs37,不是 ConvertToUTF8
Sublime Text 4 用户不应安装 ConvertToUTF8,因其已停更且干扰原生编码逻辑。目前唯一持续维护、支持 GBK/GB18030/Shift-JIS 等 30+ 编码的现代替代方案是 Codecs37。
- 通过
Package Control: Install Package搜索并安装Codecs37 - 安装后重启,无需任何配置,打开 GBK 文件直接显示正常,右下角明确标出
GBK - 如果仍乱码,说明文件本身不是纯 GBK(比如混用了 GB2312 或带 BOM 的 UTF-8),此时手动走
Reopen with Encoding流程更可靠 - 别信 Package Control 搜索结果:官方仓库早已下架
ConvertToUTF8,现在搜到的大多是过期镜像或恶意 fork
真正的难点从来不在“怎么装插件”,而在确认文件真实编码——file -i 文件名(Linux/macOS)或 Notepad++(Windows)右下角显示,才是唯一可信依据。其他全是猜。











