ConvertToUTF8插件不能一键永久转码GBK文件，仅实现打开时自动识别并以UTF-8显示、保存时还原原编码；必须通过Package Control安装并重启生效，且需手动调优检测参数或配合iconv等外部工具完成真正UTF-8转换。
ConvertToUTF8 插件在 Sublime Text 中**不能真正“安装即用”解决所有 GBK 乱码**——它只在你打开文件时自动识别并以 UTF-8 解码显示，保存时再转回原始编码（如 GBK），**不是一次性把文件永久转成 UTF-8**。如果你想要的是“打开就正常、保存就是 UTF-8”，那得配合手动操作或外部工具。
怎么装？Package Control 是唯一靠谱路径
别信“拖文件进 Packages 目录就能用”的说法——手动安装 ConvertToUTF8 后大概率不生效，尤其在 Sublime Text 4（2026 年主流版本）中，插件依赖的 API 已变更，只有通过 Package Control 安装才能触发正确加载和初始化。
- 确保已装
Package Control（没装就先去官网复制安装代码，粘贴进 Sublime 控制台） - 按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS）调出命令面板 - 输入
Install Package回车 → 等待列表加载完成 → 搜索ConvertToUTF8→ 点击安装 - 安装完**必须重启 Sublime Text**，否则插件不会注册监听事件
装完为啥还是乱码？检查这三件事
常见现象：插件装了、重启了，但打开 .txt 或 .cpp 文件仍是方块或问号。这不是插件坏了，而是它还没“认出”你的文件是 GBK。
-
ConvertToUTF8默认启用智能检测，但只扫描前max_detect_lines行（默认 500），如果文件开头全是空行或英文注释，它可能误判为 UTF-8 - 状态栏右下角显示
UTF-8，但内容乱码 → 右键点击该编码名，选Reopen with Encoding → Chinese (GBK)，确认中文恢复后再保存 - 若频繁误判，打开
Preferences → Package Settings → ConvertToUTF8 → Settings – User，写入：
{
"convert_on_load": true,
"convert_on_save": true,
"confidence": 0.95,
"max_detect_lines": 600
}
其中 confidence: 0.95 是平衡准确率和兼容性的关键值；设太高（如 0.98）会漏掉弱信号 GBK 文件，太低（0.85）又可能把 UTF-8-BOM 当 GBK。
想批量转成 UTF-8？别指望插件干这事
ConvertToUTF8 的设计目标是「编辑体验平滑」，不是「批量编码转换」。它没有命令行接口，也不提供「全部文件另存为 UTF-8」功能。强行用它逐个点 Save with Encoding → UTF-8 效率极低，且容易漏判原始编码。
- 真正安全的批量方案是用系统级工具：
iconv - 先确认原始编码（别瞎猜）：
file -i filename.txt或enca -L zh filename.txt - 批量转换示例（Linux/macOS）：
for f in *.txt; do iconv -f GBK -t UTF-8 -c "$f" -o "utf8_$f"; done
-c 参数跳过无法转换的字节，避免中断；转换前务必 cp -r ./original ./backup 备份原目录——一旦 -f 写错（比如把 GBK 写成 GB2312），文件就不可逆损坏。
最易被忽略的坑：BOM 和 Sublime 的“假 UTF-8”
很多文件声称是 UTF-8，实际带 BOM（EF BB BF），Sublime 默认不标出，但 Git、Python 脚本、某些构建工具会把它当非法字符报错。而 ConvertToUTF8 在 convert_on_save: true 下保存时，**默认不写 BOM**，导致你“以为转好了”，结果下游工具又崩了。
- 若需带 BOM 的 UTF-8，不要依赖插件保存，而应：菜单
File → Save with Encoding → UTF-8 with BOM - 新建文件默认编码设为 UTF-8，加到
Preferences → Settings – User：
{ "default_encoding": "UTF-8" }
但注意：default_encoding 只影响新建文件和“另存为”，对已存在的非 UTF-8 文件无效——它不改变原始字节，只是下次保存时用什么编码写入。
