中文/日文/韩文打开乱码源于Sublime Text默认不检测GBK/BIG5/EUC-KR等CJK编码，误按UTF-8解码导致字节错乱；需安装ConvertToUTF8插件并配置自动转码与编码优先级。
为什么中文/日文/韩文一打开就乱码？根源在编码检测失效
Sublime Text 默认不主动猜 GBK、BIG5、EUC-KR、CP932 这类 CJK 专用编码，它只信任 UTF-8 和少数 ASCII 兼容编码。一旦文件实际是 GBK（比如 Windows 记事本直接保存的 .txt），Sublime 就会按 UTF-8 解码——两个字节被拆成两个非法 Unicode 码点，显示成 或一堆方块。
常见错误现象：
- 打开旧项目里的 .html/.js/.txt 文件，中文全变问号或小方块
- 状态栏右下角显示
UTF-8，但文字明显错乱 -
File → Reopen with Encoding里手动选GBK后立刻正常，说明文件本身没问题
关键判断点：不是字体问题，不是系统语言设置问题，是 Sublime 没“看懂”原始编码。
ConvertToUTF8 插件怎么装？别碰 Package Control 控制台那串 Python 代码
现在（2026 年）Package Control 已内置，老式控制台安装方式（import urllib2...）不仅过时，还常因 Python 版本/代理/路径含中文失败。
实操建议：
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS） - 输入
Package Control: Install Package回车 - 等几秒，输入
ConvertToUTF8，回车安装 - 安装完必须重启 Sublime Text，否则插件不加载、状态栏不显示编码
注意：不要同时装 GBK Encoding Support——它和 ConvertToUTF8 冲突，会导致编码反复切换、保存异常。
配置 ConvertToUTF8 的核心参数：别让自动转换“想太多”
插件默认行为偏保守，对混合编码或短文本识别率低。打开配置文件：Preferences → Package Settings → ConvertToUTF8 → Settings，修改以下几项：
-
"convert_on_load": true：文件打开时自动尝试解码（必须开） -
"convert_on_save": true：保存时自动转回原编码（避免覆盖原始 GBK 文件） -
"max_detect_lines": 1000：默认只读前 50 行，大文件容易误判，拉高更稳 -
"confidence": 0.90：低于该置信度就不触发转换，设太低会误转 UTF-8 文件为 GBK
如果你的项目里大量用 BIG5（繁体中文）或 EUC-KR（韩文），还得加编码优先级："encoding_list": [ ["Chinese Simplified (GBK)", "GBK"], ["Chinese Traditional (BIG5)", "BIG5"], ["Korean (EUC-KR)", "EUC-KR"] ]
Linux 下输入法打不出中文？不是插件问题，是 GTK IMModule 加载失败
Ubuntu / Debian 系统里，Sublime Text 3 静态链接了 GTK 库，导致 Fcitx 或 IBus 的输入法模块（IMModule）无法动态注入。现象是：光标闪，按键有响应，但中文不上屏，拼音候选框也不弹。
这不是 ConvertToUTF8 能解决的，得从系统层补丁：
- 确保已安装
fcitx5-modules或ibus-gtk3 - 启动 Sublime 前加环境变量：
GTK_IM_MODULE=fcitx5 sublime_text（或ibus） - 若仍无效，需用社区维护的 patched build（如
sublime-text-ime-fixAUR 包或 PPA）
这个环节最容易被当成“编辑器 bug”反复重装插件，其实跟编码转换完全无关。
CJK 显示和输入是两套机制：前者靠编码插件，后者靠系统输入框架。混在一起调，只会越调越乱。
