代码提示乱码是字体渲染层未正确加载中文字体或 fallback 链断裂所致,需在 font_face 中显式配置支持英文等宽与中文全角的字体序列并重启 Sublime Text。

汉化后代码提示(如函数名、变量名、补全弹窗)出现乱码,和界面汉化本身无关,是字体渲染层未正确加载中文字体或字体 fallback 链断裂导致的。直接改 font_face 就能解决,不用重装插件或降级版本。
为什么代码提示乱码而菜单不乱?
Sublime Text 的菜单、侧边栏、状态栏走的是 UI 渲染管线,受汉化包和系统 locale 影响;但代码提示(autocomplete popup)、行号、折叠标记、高亮文本等走的是编辑器核心的字体渲染链,只认 font_face 设置里的第一个可用字体。如果该字体不支持中文(比如 Consolas、Fira Code),哪怕系统装了微软雅黑,它也不会自动 fallback 到第二个字体去显示中文符号。
- 常见现象:补全框里函数名正常(英文),但参数说明或 docstring 里的中文变成 □ 或 “锟斤拷”
- 典型错误操作:只在设置里加了
"font_face": "Microsoft YaHei",但没删掉旧字体或没验证是否生效 - Windows 下尤其明显,因为默认
font_face是空值,ST 会退化到系统默认等宽字体(通常是不带中文的)
怎么配 font_face 才让提示框显示中文
必须显式声明一个**同时支持英文等宽 + 中文全角**的字体,并确保它已安装且被 ST 正确识别。不能只写“微软雅黑”,要带上备用字体兜底。
- Windows 推荐配置:
"font_face": "Microsoft YaHei Mono, Microsoft YaHei, Consolas"(注意顺序:Mono 版优先,无则退到普通雅黑,再退到 Consolas) - macOS 推荐:
"font_face": "Monaco, PingFang SC, Hiragino Sans GB" - Linux 推荐:
"font_face": "DejaVu Sans Mono, Noto Sans CJK SC, WenQuanYi Micro Hei" - 改完后必须重启 Sublime Text,仅 Reload Settings 不生效
- 验证方式:打开一个含中文注释的 Python 文件,触发
import os补全,看参数提示里的中文是否正常
fallback_encoding 和 detect_encoding 对提示框没影响
很多人误以为乱码是编码设置问题,于是去调 fallback_encoding 或开 detect_encoding——这些只控制文件读取解码,对代码提示弹窗的字体渲染完全无效。它们连内存里的 Unicode 字符都还没生成,更不会参与字体选择。
-
fallback_encoding只在 Reopen with Encoding 失败时起作用,和 UI 渲染无关 -
detect_encoding: true反而可能干扰真实编码识别,建议删掉 - 如果你用的是 Sublime Text 4,
fallback_encoding已被移除,设了也白设 - 真正影响提示框显示的,只有
font_face、font_size和系统字体缓存
最常被忽略的一点:改完 font_face 后没重启,或者用了带空格/括号的字体名(如 "Source Code Pro")却没加引号——ST 解析失败就静默回退到无中文字体,此时提示框里的中文会直接消失或替换成方块,而不是报错提醒你。











