终端字体大小需设置 terminal.integrated.fontSize(非 editor.fontSize),推荐值12–15;字体样式依赖 fontFamily 是否含对应变体及渲染后端支持,macOS/Windows/Linux 渲染差异大,改后需重启终端页而非 VSCode。

终端字体大小调不了?改的是 terminal.integrated.fontSize
VSCode 集成终端的字体和编辑器是分开控制的,改 editor.fontSize 完全没用。真正起作用的是用户设置里的 terminal.integrated.fontSize,它只影响终端区域,不联动编辑器或其他面板。
常见错误现象:在设置界面搜“font size”,结果调了全局或编辑器的值,终端毫无反应;或者改了 terminal.integrated.fontFamily 但没配大小,字体看起来糊或太小。
- 推荐直接打开命令面板(
Ctrl+Shift+P或Cmd+Shift+P),输入「Preferences: Open Settings (JSON)」,手动加这一行:"terminal.integrated.fontSize": 14
- 数值建议从
12起步,13–15是多数人可读性较好的范围;Windows 上若用Consolas,13刚好;macOS 上Menlo或JetBrains Mono建议14起 - 别用像素单位(比如
14px),这个字段只接受纯数字,填字符串会静默失效
字体样式(粗体/斜体)不生效?检查 terminal.integrated.fontWeight 和渲染后端
终端里 ls --color 输出的高亮文字、git status 的变色部分是否加粗,取决于两个东西:一是 VSCode 的 terminal.integrated.fontWeight 设置,二是底层终端渲染是否支持该样式——后者常被忽略。
常见错误现象:设了 "terminal.integrated.fontWeight": "bold",但命令输出里的粗体文字还是灰扑扑的;或者斜体完全不显示(比如 man 页面里的斜体关键词)。
-
fontWeight可取值为"normal"、"bold"、"100"到"900",但不是所有字体都提供完整字重;推荐优先试"bold"或600 - 斜体依赖
terminal.integrated.fontFamily是否包含对应斜体变体;例如设"Fira Code"就行,但只写"Fira"可能找不到斜体文件 - Windows 用户如果用默认的 Windows Terminal 后端(WSL 或 PowerShell),可能需额外开启「启用 GPU 加速」(
terminal.integrated.gpuAcceleration设为"on"),否则字体样式渲染会降级
不同操作系统字体路径和默认行为差异大
macOS、Windows、Linux 下终端字体的实际渲染效果差异明显,不是调一个参数就能统一。根本原因是 VSCode 终端复用了系统原生渲染层(如 macOS 的 Core Text、Windows 的 DirectWrite),字体回退逻辑各不相同。
使用场景:你在一个系统上配好了,切到另一台机器发现字体发虚、中文错位、符号显示为方块——大概率是字体家族名写法或 fallback 链不匹配。
- macOS 推荐显式写全:
"terminal.integrated.fontFamily": "'SF Mono', 'Hack Nerd Font', monospace"
(单引号包裹含空格的字体名) - Windows 上避免用
"Cascadia Code"这类带空格的名称而不加引号,否则解析失败,自动回落到等宽默认字体 - Linux(尤其 Ubuntu)若装了
nerd-fonts,要确认字体已用fc-cache -fv刷新,否则fontFamily写对了也加载不出来
改完没反应?重启终端或重载窗口比重启 VSCode 更快
VSCode 对终端字体设置的热更新支持有限。改完 JSON 设置后,新开的终端标签页通常能立刻生效,但已有终端页不会刷新字体——这不是 bug,是设计如此。
容易踩的坑:反复修改设置 → 点「保存」→ 瞪着旧终端看半天 → 怀疑配置错了 → 全局重启 VSCode。其实没必要。
- 最轻量做法:关闭当前终端页(
Ctrl+Shift+P→ 「Terminal: Kill the Active Terminal Instance」),再新建一个(Ctrl+Shift+`) - 如果用了自定义 shell(比如 zsh + oh-my-zsh),某些主题会强制重设
$TERM或触发字体重绘异常,此时可以临时在终端里执行clear或reset看是否恢复 - 极少数情况(如远程开发容器内),需要连带检查容器里是否安装了对应字体;光配 VSCode 没用
事情说清了就结束。字体这事,参数只是入口,真要稳,得盯着系统、字体文件、渲染后端三层一起看。











