必须同时配置editor.fontFamily、editor.fontSize、editor.lineHeight三项才能使编辑器代码区字体生效,缺一不可;终端需单独设terminal.integrated.fontFamily和terminal.integrated.fontSize;右键菜单等原生UI须通过Custom CSS插件注入CSS修改。

VSCode 全局字体设置不能只改 editor.fontFamily,否则菜单、右键、侧边栏等区域字体完全不变——这是最常被忽略的根源问题。
编辑器代码区字体怎么设才生效
必须同时配置三项,缺一不可:
-
editor.fontFamily:填带单引号的字体名,多个用逗号分隔,例如'JetBrains Mono', 'PingFang SC', monospace -
editor.fontSize:整数,推荐 13–15;设成 12 或更低时括号/分号易糊 -
editor.lineHeight:像素值(非 CSS 的line-height),不能小于fontSize + 2,比如字号 14 就别设 13,否则文字底部被裁切
改完需执行 Ctrl+Shift+P → Developer: Reload Window,仅保存 settings.json 不够。
终端字体为什么还是小?
终端字体不继承 editor 配置,必须单独设:
-
terminal.integrated.fontFamily:和editor.fontFamily格式一致,但建议专配等宽字体,如'Fira Code', 'Cascadia Mono', monospace -
terminal.integrated.fontSize:建议比editor.fontSize大 1–2,比如编辑器是 14,终端设 15 - 改完已打开的终端不会刷新,必须关掉当前终端页(不是关窗口),再按
Ctrl+`重开
注意:terminal.fontSize 是旧键名,VSCode 1.118 已弃用,只认 terminal.integrated.fontSize。
右键菜单、标题栏、侧边栏字体怎么改
这些属于原生 UI,settings.json 无法控制,必须用 CSS 注入:
- 装插件
Custom CSS and JS Loader - 新建
vscode-font.css,内容含.shadow-root-host{font-family:'PingFang SC'!important;}(右键菜单)和.monaco-workbench.windows{font-family:...!important;}(主界面) - 在
settings.json中加"vscode_custom_css.imports": ["file:///D:/vscode-font.css"],路径必须是file://协议,且不能放在 VSCode 安装目录内
Windows 用户注意:CSS 里要保留 .windows 类名;macOS 用户得换成 .mac,否则无效。
字体名写错、没装字体、连字不显示的常见坑
三个高频失效原因:
- 字体名含空格却没加单引号,比如写成
JetBrains Mono而非'JetBrains Mono',VSCode 直接忽略该字体 - 只在 VSCode 文件夹里放了 .ttf,但没真正安装到系统(macOS 要进“字体册”,Windows 要右键“为所有用户安装”)
- 开了
editor.fontLigatures: true,但选的字体本身不支持连字(如Consolas),结果!=还是显示为两个字符,且可能轻微卡顿
连字是否生效,最终取决于字体文件本身是否包含 ligature 字形表,不是 VSCode 能强制渲染出来的。


















