VSCode平滑滚动失效需排查配置、系统设置与GPU支持三环节：确保settings.json中"editor.smoothScrolling": true未被覆盖，macOS关闭惯性滚动，远程开发启用--enable-gpu参数。
editor.smoothScrolling设为true却没动画？检查settings.json是否被覆盖
GUI界面勾选「Smooth scrolling」只是代理开关，不保证写入生效。真正起作用的是settings.json里那行"editor.smoothScrolling": true——它必须存在、未被注释、值为true（不能是"on"或1），且不能被工作区设置覆盖。
- 打开命令面板（
Ctrl+Shift+P或Cmd+Shift+P），执行Preferences: Open Settings (JSON) - 确认用户级
settings.json中有且仅有一行："editor.smoothScrolling": true - 检查当前项目根目录下的
.vscode/settings.json，若含"editor.smoothScrolling": false，删掉或改为true - 保存后建议完全重启 VSCode，GPU 渲染上下文可能未刷新
鼠标滚轮还是跳变？别漏掉mouseWheelScrollSensitivity和系统惯性滚动
editor.smoothScrolling 控制是否有缓动动画，editor.mouseWheelScrollSensitivity 控制每次滚动“走多远”，两者必须配合。但 macOS/Linux 下，系统级滚动行为会直接干扰插值节奏。
-
editor.mouseWheelScrollSensitivity默认是1.0，推荐从1.2开始试；设为0.5～1适合小屏或高密度文本，2～3适合大屏浏览长文件 - macOS 用户必须关闭「惯性滚动」：系统设置 → 辅助功能 → 指针控制 → 触控板选项 → 取消勾选「惯性滚动」和「自然滚动」
- Logitech/Razer 鼠标驱动若启用了「平滑滚动」，会劫持原始事件，导致 VSCode 参数完全失效——需先关掉驱动层平滑
- Linux Wayland 或远程开发环境，确保未启用
--disable-gpu，否则动画静默退化为跳变
远程开发（WSL/SSH）下平滑滚动失效？GPU 加速是硬门槛
VSCode 远程模式默认禁用硬件加速，而 editor.smoothScrolling 依赖 WebGL 渲染路径。没有 GPU 上下文，动画根本不会触发，只会做普通跳转。
- 启动 VSCode 时加参数：
code --enable-gpu --use-gl=desktop（macOS/Linux）或code --enable-gpu（Windows） - WSL 环境可提前设置环境变量：
export ELECTRON_ENABLE_GPU=1 - 打开开发者工具（
Ctrl+Shift+I），Console 中若出现Failed to create WebGL context，说明 GPU 未启用，配置无效 - 部分低配云服务器或旧显卡驱动不支持 WebGL 1.1+，此时即使加参数也无济于事
PageUp/PageDown 和方向键永远不平滑？这是设计，不是配置问题
VSCode 明确将 PageUp/PageDown、↑/↓ 等原生导航操作归类为“页面跳跃”逻辑，绕过平滑插值管线。这不是 bug，也不受 editor.smoothScrolling 控制。
- 只有走
editorScroll命令路径的操作才受控：如Ctrl+G输入行号、Ctrl+Click跳定义、Ctrl+Home到文件头 - 想让键盘翻半屏带过渡？只能靠自定义 keybinding 调用
editorScroll并加延迟，但响应会变慢，实测体验提升有限 - 方向键/打字时光标瞬移是 Monaco 编辑器的硬性设计：为保障等宽字体像素对齐和输入响应速度，禁止坐标插值
- 终端（
Ctrl+`）里的滚动和光标完全独立，编辑器设置对其无效
