离线文档(如Hover提示、内置扩展文档)使用WebView渲染,不响应editor.fontSize等编辑器字体设置;唯一可靠方式是调整window.zoomLevel全局缩放并配合workbench.fontAliasing优化清晰度。

离线文档(如内置的 TypeScript/JavaScript 参考文档、扩展自带的 Markdown 文档)在 VSCode 中不走编辑器字体设置,必须单独处理。
离线文档用的是 WebView 渲染,不是编辑器视图
VSCode 打开的离线文档(比如按 F1 输入 Developer: Toggle Developer Tools 后看到的“Built-in Extensions”文档、或某些语言服务器提供的 Hover 文档)本质是嵌入式 WebView,它有自己的 CSS 渲染上下文,完全不读取 editor.fontSize 或 terminal.integrated.fontSize。
- 你调大
editor.fontSize,对 Hover 提示、内联文档、命令面板里的文档预览毫无影响 - 这类页面默认字号由 VSCode 内部 WebView 的基础样式决定,通常固定为 13–14px,且不随系统缩放自动适配
- 即使开了
window.zoomLevel,WebView 内容也不一定同步缩放(尤其旧版本或特定扩展)
唯一可靠方式:改 workbench.fontAliasing + window.zoomLevel 组合
没有直接控制“离线文档字体大小”的配置项,但可通过底层渲染参数间接改善可读性:
-
"workbench.fontAliasing": "auto"(默认值)在高分屏下可能让小字号文字发虚;尝试设为"workbench.fontAliasing": "grayscale"或"subpixel",部分用户反馈能提升小字号清晰度 -
"window.zoomLevel": 1是最接近“放大文档”的手段——它会等比缩放整个工作台,包括 WebView 容器。虽然会连带放大图标和边距,但文档文字确实变大了 - 注意:
window.zoomLevel是全局生效,会影响侧边栏宽度、调试面板布局等;建议从0(默认)逐步试到1,避免过度挤压界面
Hover 和内联文档的字号无法单独调,但有缓解技巧
Hover 提示(悬停看类型定义)、Ctrl+Space 补全弹窗里的文档摘要,属于编辑器 UI 层的浮动 WebView,更难干预:
- 确保系统 DPI 设置合理:Windows 上检查“显示设置→缩放与布局”,macOS 检查“显示器→分辨率→缩放”,错误的系统级缩放会让 WebView 文字模糊或过小
- 禁用 GPU 加速有时反而改善渲染:
"disable-hardware-acceleration": true加入 VSCode 启动参数(需从终端启动:code --disable-gpu),适合 Intel 核显老旧设备 - 某些扩展(如
Auto Close Tag)会注入自定义样式干扰 WebView,默认关闭它们可减少字体异常
真正麻烦的是:离线文档字体大小根本不在用户可控配置列表里。你调得再细,也绕不开 WebView 的封闭渲染链路——能做的只有调 window.zoomLevel 让它“看起来大一点”,再靠 workbench.fontAliasing 把边缘压清楚。别在 settings.json 里找 docs.fontSize 这种不存在的字段,徒劳。


















