启用 VSCode 平滑滚动需设置 "editor.smoothScrolling": true,它仅作用于代码编辑器区域,且主要在键盘快捷键滚动时生效;鼠标滚轮需配合调整 mouseWheelScrollSensitivity 等参数才可能感知效果。

如何启用 VSCode 的平滑滚动效果
VSCode 默认关闭平滑滚动,直接拖动滚动条或使用鼠标滚轮时是“跳变式”移动,观感生硬。要开启它,只需在设置中启用 "editor.smoothScrolling" 选项。
操作路径:打开设置(Ctrl+, 或 Cmd+,),搜索 smoothScrolling,勾选 Editor > Smooth Scrolling;或直接编辑 settings.json,添加:
{
"editor.smoothScrolling": true
}
注意:该设置仅影响编辑器主区域(即代码视图)的滚动行为,不作用于侧边栏、终端或文件资源管理器。
为什么开了 smoothScrolling 却没感觉?
常见原因不是设置没生效,而是触发条件未满足——VSCode 的平滑滚动只在「通过键盘快捷键滚动」时默认启用(如 Ctrl+Down、Alt+PageDown),而鼠标滚轮和触摸板惯性滚动默认仍走原生快速滚动路径。
- 鼠标滚轮需配合
"editor.mouseWheelScrollSensitivity"和"editor.fastScrollSensitivity"调整才可能感知差异 - 触摸板在 macOS 上需额外开启系统级“滚动方向:自然”,且 VSCode 1.85+ 才开始逐步支持惯性滚动帧插值
- 部分显卡驱动或远程桌面(如 Windows RDP)会禁用 GPU 加速,导致平滑动画被降级为普通滚动
mouseWheelScrollSensitivity 和 fastScrollSensitivity 怎么调才合适
这两个参数控制输入设备的滚动响应粒度,直接影响平滑滚动是否“跟手”或“迟滞”:
-
"editor.mouseWheelScrollSensitivity":调高(如2.0)让滚轮一格滚动更多行,适合大屏/高 DPI 屏幕;调低(如0.5)适合精细逐行浏览 -
"editor.fastScrollSensitivity":仅在按住Alt滚动时生效,数值越大,滚动越快——但它会削弱平滑感,建议保持默认5.0或略降至3.0 - 二者都**不会自动启用平滑滚动**,只是调节已有平滑行为下的响应强度
示例(兼顾细腻与效率):
{
"editor.smoothScrolling": true,
"editor.mouseWheelScrollSensitivity": 1.2,
"editor.fastScrollSensitivity": 3.0
}
性能与兼容性需要注意什么
平滑滚动依赖 VSCode 渲染线程做插帧动画,在低端设备或打开大量扩展时可能引发轻微掉帧,尤其当同时启用 "workbench.editor.enablePreview" 和多标签页时。
- 若发现光标跟随延迟或滚动卡顿,优先检查是否启用了
"editor.renderWhitespace"或"editor.renderControlCharacters"——这些渲染开关比smoothScrolling更耗资源 - Web 版 VSCode(vscode.dev)目前不支持该设置,会静默忽略
smoothScrolling - Linux 下 Wayland 会话中,部分集成显卡(如 Intel i915)可能出现垂直同步失效,表现为滚动微抖,此时可尝试添加
"window.titleBarStyle": "native"缓解
真正影响体验的往往不是开不开,而是滚动节奏是否匹配你的手眼协调习惯——调参前先试 10 分钟原生设置,再微调,比直接套用别人配置更可靠。


















