terminal.integrated.fontSize 必须单独设置,editor.fontSize 对终端无效;需配置 terminal.integrated.fontFamily 为系统已安装字体的准确名称,并重启终端页生效。

terminal.integrated.fontSize 必须单独设,改 editor.fontSize 没用
VSCode 的终端和编辑器用的是两套字体系统,editor.fontSize 只控制代码区字号,对 Ctrl+` 弹出的终端完全无效。常见错误是调完编辑器字体,发现终端还是小得看不清——根本没动对地方。
真正起作用的是:terminal.integrated.fontSize,数值建议从 12 起步,13–15 是多数人可读性较好的范围:
- Windows 上用
Consolas,13刚好清晰不挤 - macOS 上
Menlo或JetBrains Mono建议从14起,SF Mono超过15容易毛刺 - Linux 终端渲染依赖
fontconfig配置,若中文显示为方块,大概率是 fallback 字体链没配全
terminal.integrated.fontFamily 写法要严格匹配系统已安装字体名
填错字体名是终端显示异常的头号原因。不是你“觉得叫什么”,而是系统注册的正式名称。比如:
- Windows:查
C:\Windows\Fonts里实际文件名,Consolas可用,但consolas(小写)或Consolas Regular(带样式后缀)可能失败 - macOS:用字体册(Font Book)点开字体,看「完整名称」字段,
JetBrains Mono有效,jetbrains-mono无效 - Linux:运行
fc-list : family查可用家族名,注意中文字体常带语言标签,如Noto Sans CJK SC,漏掉SC就回退成方块
多个字体用英文逗号分隔,推荐写法:"'JetBrains Mono', 'Cascadia Code', monospace",末尾加 monospace 保底。
改完不生效?先关终端页再重开,别只刷新
VSCode 终端面板不会热更新字体设置。常见现象:改了 settings.json,保存后终端文字毫无变化——因为你没关掉当前终端页。
正确操作顺序:
- 保存
settings.json或图形设置 - 关闭所有已打开的集成终端页(点每个终端右上角 ×,不是只清空内容)
- 按
Ctrl+`或菜单 Terminal → New Terminal 重新打开 - 如果仍异常,检查是否被工作区
.vscode/settings.json覆盖(尤其团队项目里)
字体间距过大、中文错位、符号发虚?本质是渲染后端差异
VSCode 终端复用系统原生渲染层:macOS 走 Core Text,Windows 走 DirectWrite,Linux 依赖 FreeType + fontconfig。同一套配置,在三台机器上表现可能完全不同。
典型症状与对策:
- 字体发虚 / 毛边:禁用连字(加
"terminal.integrated.fontLigatures": false),尤其 macOS 高分屏下 - 中文和英文字符高度不齐:换等宽中英混排字体,如
JetBrains Mono或Noto Sans Mono CJK,别用纯中文字体如Microsoft YaHei - 特殊符号(→、≠、λ)显示为空心框:确认字体是否含 Unicode Basic Multilingual Plane 外的字形,或补全 fallback,例如加
'Noto Color Emoji'
最稳路径不是追求“一次配全”,而是先定死 terminal.integrated.fontSize 和一个已验证兼容的字体,再逐步加特性。跨平台协作时,把终端字体配置写进项目级 .vscode/settings.json,比靠记忆或口头同步靠谱得多。


















