sublime text需先在系统安装中文字体(如微软雅黑→“microsoft yahei”),再于设置中准确填写英文全名;字体名错误、未刷新缓存或编码不匹配均会导致显示异常。

Sublime Text 本身不安装字体,只调用系统已安装的字体。想用微软雅黑、思源黑体、霞鹜文楷等中文字体,必须先在操作系统里装好,再在 Sublime 的设置里正确写对字体名——写错一个字、多一个空格、大小写不对,都会 fallback 到默认字体。
怎么把微软雅黑这类中文字体装进系统
字体文件(.ttf 或 .otf)得先被系统识别,Sublime 才能选到它:
- Windows:右键字体文件 → “为所有用户安装”(推荐),或双击后点“安装”
- macOS:双击字体文件 → 点“安装字体”,确保装到“电脑”而非当前用户(否则其他账号/应用可能看不到)
- Linux:复制到
~/.fonts/或/usr/local/share/fonts/,然后运行fc-cache -fv刷新缓存
装完别急着开 Sublime,先打开系统字体册(Windows 字体设置、macOS 字体册)确认“微软雅黑”是否显示为“Microsoft YaHei”——这是它在 Sublime 里要用的真实名称,不是中文界面里看到的“微软雅黑”。
Sublime 设置中文字体时,font_face 值怎么写才有效
font_face 必须填操作系统注册的**英文全名**,不是文件名,也不是显示名。常见中文字体对应关系如下:
- 微软雅黑 →
"font_face": "Microsoft YaHei" - 思源黑体(简体)→
"font_face": "Source Han Sans CN"(注意空格和 CN 后缀) - 霞鹜文楷 →
"font_face": "LXGW WenKai"(区分大小写,WenKai 首字母大写) - 苹方-简 →
"font_face": "PingFang SC"(macOS 原生,Windows 没这个)
填错最常表现为:设置保存后无变化,或突然变成 Courier New 这类等宽默认字体。打开系统字体册,右键字体 → “预览”或“详细信息”,找“全名(Full Name)”字段,照抄过去。
中文字体设置生效但显示方块或模糊?检查这三项
即使字体名写对、系统也装了,中文字体仍可能渲染异常,原因往往不在 Sublime 本身:
- 高 DPI 屏幕下中文菜单发虚?加配置:
"gl_hardware_acceleration": false - 某些字体(如旧版微软雅黑)缺粗体/斜体变体,导致
font_options里的["bold", "italic"]失效,建议删掉该配置项先测试基础显示 - Sublime 默认禁用 subpixel antialiasing(次像素抗锯齿),中文笔画细时易发虚;可加:
"font_options": ["subpixel_antialias"](仅 Windows 有效,macOS 用自身 Quartz 渲染)
改完设置记得保存,且必须关闭所有 Sublime 窗口(包括托盘进程),再重开——它不热重载字体配置。
为什么选了中文字体,代码里中文注释还是乱码
字体设置管的是“怎么画字”,而“能不能读对字”是编码问题。如果打开一个 GBK 编码的 .py 文件,里面中文注释显示成 ,那是编码没识别对,跟字体无关:
- 先按
Ctrl+Shift+P调出命令面板,输入Set Encoding: UTF-8强制转码(慎用,可能损坏非 UTF-8 文件) - 更稳妥的是装
ConvertToUTF8插件,它会自动检测 GBK/GB2312 并转成 UTF-8 显示,不改原文件 - 新建文件默认编码可在用户设置里加:
"default_encoding": "UTF-8"
字体和编码是两层事:字体决定“字形是否清晰”,编码决定“字符是否被正确解析”。两者都配对了,中文字体才算真正跑通。











