必须同时启用"editor.smoothScrolling": true、关闭macOS系统惯性滚动、微调"editor.mouseWheelScrollSensitivity"（推荐1.2～1.5）、确保远程开发启用GPU加速，四者缺一不可，否则平滑滚动静默失效。
editor.smoothScrolling 必须设为 true，但只靠这一项几乎肯定没效果——它会被工作区设置覆盖、被 macOS 惯性滚动干扰、在远程开发中因 GPU 缺失而静默失效。
settings.json 里必须有且仅有一行 "editor.smoothScrolling": true
GUI 界面勾选只是代理，不保证写入生效。很多用户点了「Smooth scrolling」却没反应，是因为：
• 工作区级 .vscode/settings.json 里存在 "editor.smoothScrolling": false（优先级更高）
• 用户级 settings.json 中该行被注释（// "editor.smoothScrolling": true）
• 同一文件里出现两次，值冲突
实操建议：
• 按 Ctrl+Shift+P（Win/Linux）或 Cmd+Shift+P（macOS），执行 Preferences: Open Settings (JSON)
• 删除所有重复或注释掉的 editor.smoothScrolling 行
• 只保留一行："editor.smoothScrolling": true
• 保存后**完全重启 VSCode**（不是重载窗口），避免 GPU 渲染上下文残留旧状态
macOS 用户必须关掉系统级「惯性滚动」
VSCode 的平滑滚动是软件插值动画，macOS 的惯性滚动是硬件级物理模拟，两者叠加会导致视觉撕裂、卡顿、动画中途断帧。
这不是配置错误，而是底层节奏冲突。
路径：系统设置 → 辅助功能 → 指针控制 → 触控板选项
• 关闭「惯性滚动」
• 建议同步关闭「自然滚动」（方向反向会干扰触控板手感）
• 改完立即生效，无需重启系统，但 VSCode 需重启
鼠标滚轮要“顺”，得调 editor.mouseWheelScrollSensitivity
editor.smoothScrolling 控制有没有动画，editor.mouseWheelScrollSensitivity 控制每次滚轮触发的位移量是否匹配动画节奏。
默认值 1.0 在多数设备上太“钝”，容易感觉不到过渡；设太高（如 >3.0）又会让动画“跟不上”，尤其在低配机器或远程开发中出现撕裂。
推荐值：
• 1.2～1.5：兼顾跟手与流畅，适合大多数 1080p/2K 屏
• 0.7～1.0：小屏、高密度代码（如 YAML/JSON）、调试时逐行定位
• 注意：最终滚动距离 = 系统设置 × VSCode 设置（例如 macOS 设“滚动 3 行” + VSCode 设 1.2 = 实际滚 3.6 行）
• Logitech/Razer 鼠标驱动若开了「平滑滚动」，该参数会失效——先关驱动层平滑
远程开发（WSL/SSH）下必须启用 GPU 加速
VSCode 远程模式默认禁用硬件加速，editor.smoothScrolling 的动画依赖 WebGL 渲染路径。没有 GPU 上下文，它会静默退化为跳变滚动，控制台不会报错，只会“开了等于没开”。
验证方法：
• 打开开发者工具（Help → Toggle Developer Tools）→ Console 标签页
• 查看是否有 Failed to create WebGL context 报错
解决路径：
• WSL：在 /etc/wsl.conf 加 guiApplications=true，确保 Windows 端已安装最新 WSLg
• SSH：修改服务端 code-server 启动命令，加入 --enable-gpu --enable-features=SmoothScrolling
• 低配云服务器或虚拟机若不支持 WebGL，则无法启用动画，只能接受跳变
editor.smoothScrolling、系统惯性关闭、mouseWheelScrollSensitivity 微调、GPU 可用性这四点同时满足——漏掉任意一个，你看到的都只是“看起来开了，实际没动”。 
