Sublime Text 打开 GBK 文件乱码需配置 fallback_encoding 为 GBK 并设 default_encoding 为 UTF-8,已打开文件需手动 Reopen with Encoding → GBK 恢复,保存时自动转 UTF-8;避免使用 ConvertToUTF8 插件。

Sublime Text 打开 GBK 文件显示乱码怎么办
默认用 UTF-8 解码,遇到 GBK 编码的中文文件就会显示成方块或问号。不是文件坏了,是解码方式错了——得手动告诉 Sublime 用 GBK 读它。
常见错误现象: 、涓枃、锘 这类字符就是典型 GBK 被当 UTF-8 解了。
- 别点「File → Reopen with Encoding」再选 GBK —— 这只是临时切换,关掉重开又变乱码
- 真正要改的是「默认解码规则」:打开
Preferences → Settings – Syntax Specific,在右侧加一行:"default_encoding": "GBK" - 但注意:
default_encoding是全局配置项,只对新打开的文件生效;已打开的乱码文件必须先「File → Reopen with Encoding → GBK」手动恢复一次
保存文件时自动转成 UTF-8 避免协作问题
团队开发中硬塞 GBK 文件容易让 Git、CI、其他编辑器崩溃。Sublime 可以读 GBK,但建议保存时转回 UTF-8。
- 打开
Preferences → Settings,在用户设置里加:"fallback_encoding": "GBK"(用于读)和"default_encoding": "UTF-8"(用于写) -
fallback_encoding是“读取失败时尝试的备选编码”,比default_encoding更安全:它只在 UTF-8 解码失败时才启用 GBK,不会误伤真正的 UTF-8 文件 - 保存后右下角状态栏会显示当前编码,确认是
UTF-8再提交
中文路径或文件名在 Windows 下打不开
Windows 默认用系统 ANSI(即 GBK),但 Sublime 的文件系统 API 在某些版本里对中文路径解析不稳,尤其带空格或括号时。
- 错误信息可能是:
Unable to open file或直接无响应 - 不是编码问题,是路径没被正确传递。临时解法:把文件拖进 Sublime 窗口,而不是用「File → Open」对话框
- 长期方案:升级到 Sublime Text 4(Build 4126+),对 Windows 中文路径支持明显改善;旧版 ST3 建议避免在路径里用全角标点
插件如 ConvertToUTF8 已过时且有风险
这个老插件曾流行,但现在会干扰原生编码逻辑,甚至导致文件静默损坏。
- 它会在保存时自动转码,但不提示、不备份,一不小心就把原始 GBK 文件覆盖成 UTF-8,且无法撤回
- Sublime 自带的
fallback_encoding+ 手动Reopen with Encoding更可控 - 如果已装 ConvertToUTF8,卸载后务必检查
Preferences → Package Settings → ConvertToUTF8 → Settings是否残留配置,删干净再重启
最麻烦的其实是混合编码:一个项目里既有 UTF-8 的 JS,又有 GBK 的旧 HTML。这时候不能靠单一配置兜底,得靠右下角编码标识随时确认,该切就切——毕竟编码不是设置一次就完事的事。










