sublime text 4 用户不应安装 converttoutf8，因其已停更且干扰原生编码逻辑；应改用持续维护的 codecs37 插件，支持 gbk/gb18030 等 30+ 编码，安装后无需配置即可自动识别并正确显示中文，右下角明确标出真实编码。
Sublime Text 4 用户别装 ConvertToUTF8
Sublime Text 4（Build 4126+）已内置 GBK/GB18030 自动探测，ConvertToUTF8 插件不仅不更新，还会干扰原生编码逻辑：状态栏编码名消失、右键菜单失效、Package Settings 里根本找不到配置入口。你装了也白装，甚至会让原本能自动识别的文件反而乱码。
真正推荐的是 Codecs37——目前唯一持续维护、支持 GBK/GB18030/Shift-JIS 等 30+ 编码的现代替代方案。安装后无需配置，打开 GBK 文件直接显示正常，右下角明确标出 GBK。
- 通过
Package Control: Install Package搜索并安装Codecs37 - 安装后重启 Sublime Text，不用改任何设置
- 打开 GBK 文件，若仍乱码，说明文件本身不是纯 GBK（比如混用了 GB2312 或带 BOM 的 UTF-8），此时手动走
Reopen with Encoding流程更可靠
乱码文件立刻显示正常的唯一操作
无论装没装插件，第一步永远是告诉 Sublime “这个文件本来就是 GBK”——它不会自己猜对，也不会从文件头可靠判断无 BOM 的 GBK 文件。
打开乱码文件后，必须执行：
- 点击右下角当前编码名（如
UTF-8或Western (ISO 8859-1)） - 选
Reopen with Encoding → Chinese (GBK) - 如果还是乱码，依次试
Chinese (GB2312)、Western (Windows 1252) - 只要中文一出来，右下角变成
Chinese (GBK)，就说明解码成功；此时内存里已是正确 Unicode，磁盘文件一字未动
千万别反复点状态栏切换编码——那是拿错解码器去解释一堆已错解的字节，只会越来越乱。
Save with Encoding → UTF-8 才是真转码
Save with Encoding → UTF-8 是唯一修改磁盘文件的动作。前面所有操作（包括插件自动转换）都只影响内存显示，不碰文件一个字节。
- 必须在
Reopen with Encoding → Chinese (GBK)确认中文正常后执行 - 务必选
UTF-8，不是UTF-8 with BOM（记事本兼容性差，Git 易冲突） - 保存后关闭再重开，右下角应显示
UTF-8且中文依旧正常 - 如果别人用记事本打开还是乱码，说明你漏了上一步——文件根本没被正确识别为 GBK，直接保存等于把乱码字节按 UTF-8 再编码，不可逆
ST3 用户装 ConvertToUTF8 的硬性条件
如果你还在用 Sublime Text 3，且项目里全是无 BOM 的 GBK 文件，ConvertToUTF8 仍有价值，但必须满足三个条件，缺一不可：
- 不能从 Package Control 安装——现在搜到的几乎全是过期镜像或改名版（如
CTU8），有兼容风险；必须从原作者仓库seanliang/ConvertToUTF8下载 master 分支 zip，解压重命名为ConvertToUTF8，拖进Packages目录 - 装完必须重启，否则插件监听事件不注册，等于没装
- 首次启用后要进
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
插件不解决初始乱码，也不改磁盘文件——它只是帮你把已正确解码的内容，在你按 Ctrl+S 时自动以 UTF-8 写回。这一步，依然绕不开 Reopen with Encoding 和 Save with Encoding → UTF-8。
