宏说明乱码是因Sublime用UTF-8解码GBK编码的宏文件所致,非汉化问题;应先Reopen with Encoding→Chinese (GBK)临时修复显示,再Save with Encoding→UTF-8永久转码,并配置fallback_encoding为"Chinese (GBK)"预防复发。

汉化后宏命令说明乱码,和汉化本身无关,是 Sublime Text 读取宏文件时用了错误编码解码其注释内容。 宏(.sublime-macro)本质是 JSON 格式文本,但若其中含中文注释且文件保存为 GBK 编码,而 Sublime 默认用 UTF-8 解析,就会在命令面板(Ctrl+Shift+P)里显示“锟斤拷”或方块——这不是界面汉化失败,而是宏文件被错解了。
为什么宏说明会乱码,而菜单/对话框正常?
Sublime 的界面汉化(如菜单、设置项)走的是语言包资源路径(Default.sublime-package),由渲染引擎按系统 locale 加载;但宏文件是用户本地磁盘上的纯文本,加载时不经过语言包流程,只依赖编码识别逻辑。只要宏文件真实编码 ≠ Sublime 当前解码方式,注释文字就必然崩。
- 常见诱因:用 Windows 记事本编辑过宏文件(默认存为 ANSI/GBK),再拖进 Sublime
- 右下角状态栏可能显示
UTF-8,但这只是 Sublime “当前怎么读”,不代表文件真是 UTF-8 - 宏文件无 BOM 时,
detect_encoding: true反而会让 Sublime 跳过 UTF-8 直接试 GBK,导致原本是 UTF-8 的宏也被误判
Reopen with Encoding → Chinese (GBK) 是唯一安全入口
别改配置、别装插件、别碰字体设置——先让说明文字能看清。打开乱码的宏文件后,立刻操作:
- 点击右下角当前编码名(比如
UTF-8或Western (ISO 8859-1)) - 选
Reopen with Encoding → Chinese (GBK) - 如果仍乱码,换试
Chinese (GB2312);若变正常,说明原始编码就是 GBK/GB2312 - 此时命令面板里该宏的说明文字应立刻恢复可读
这一步不写磁盘,纯内存重解析,完全安全。
Save with Encoding → UTF-8 才算真正修复
显示正常后,必须执行保存动作,否则下次打开还是乱码:
- 确认中文注释已清晰显示
- 点击
File → Save with Encoding → UTF-8(注意不是UTF-8 with BOM) - 关闭文件再重新打开,检查右下角是否稳定显示
UTF-8,且命令面板说明仍正常 - 如果保存后其他工具(如 Git、Python 解释器)报
Non-UTF-8 code starting with '\xef',说明你误选了 BOM 版本,删掉文件重来
关键点:Save with Encoding 是唯一把磁盘文件内容真正转码的操作;Reopen with Encoding 只是临时“看清楚”,不做任何保存。
用户设置里 fallback_encoding 必须配对生效
为避免以后新建或导入的宏再次乱码,需在 Preferences → Settings – User 中补全这两行:
{
"default_encoding": "UTF-8",
"fallback_encoding": "Chinese (GBK)"
}
注意:fallback_encoding 必须写成 "Chinese (GBK)"(括号、空格、大小写全对),写 "GBK" 或 "utf-8" 都无效;它只在“无 BOM + UTF-8 解码失败”时触发,专治这类没声明编码的旧宏文件。
最易忽略的是:宏文件一旦含混合编码(比如部分注释是 UTF-8、部分是 GBK),以上方法会失效——这时只能手动拆开,逐段用 Reopen with Encoding 切换验证,没有自动兜底方案。











