VSCode不支持像素级滚动，仅基于行或页面逻辑滚动；所谓“精确滚动”需调低mouseWheelScrollSensitivity（如0.3～0.5）、关闭smoothScrolling，并统一系统滚轮设置为单行。
VSCode 没有“像素级滚动”模式，它只支持基于行（line）或页面（page/halfPage）的逻辑滚动；所谓“精确滚动”实际是调低 editor.mouseWheelScrollSensitivity 并配合禁用平滑动画来逼近逐行控制。
为什么搜不到 pixel-perfect scroll 或 sub-line scrolling
VSCode 基于 Electron 渲染，底层滚动锚点始终对齐逻辑行（即使启用了软换行或 word wrap），不提供亚像素或 CSS transform 级别的滚动位移。所有滚动动作最终都会被四舍五入到最近的完整行位置——这是设计使然，不是配置遗漏。
-
editor.smoothScrolling只是插值动画，不改变终点位置 - 触摸板惯性、鼠标滚轮脉冲、
fastScrollSensitivity都无法突破“行”这个最小单位 - 扩展市场中也没有真正实现像素滚动的插件，因为 VSCode API 不暴露渲染层 scroll offset 的写入权限
如何让滚轮尽可能接近“一行一动”
目标是让每次滚轮事件只滚动 1 行（而非默认的 3 行），关键在三处协同设置：
- 把
editor.mouseWheelScrollSensitivity设为0.3～0.5（数值越小，单次滚轮触发的行数越少；设为1通常仍会跳 2～3 行，因系统滚轮事件本身就有最小脉冲） - 关闭
editor.smoothScrolling（设为false），避免动画插值掩盖真实滚动步长 - Windows/macOS 系统级设置必须统一：Windows 控制面板 → 鼠标 → “每次滚动几行” 设为
1；macOS 系统设置 → 触控板/鼠标 → 滚动速度拉到最慢档
PageUp/PageDown 怎么做到“视觉半屏”而非整屏跳跃
整屏翻页受窗口高度、字体大小、侧边栏开关状态影响极大，不可靠；halfPage 是唯一稳定参数，但需手动绑定快捷键：
{
"key": "pageup",
"command": "editorScroll",
"args": {
"to": "up",
"by": "halfPage",
"value": 1
},
"when": "editorTextFocus && !editorReadonly"
}
- 不要用
by: "line"或by: "page"，它们在缩放、换行、分屏时行为飘忽 -
value: 1表示执行 1 次 halfPage 滚动；设为2就是全屏，没必要 - 该绑定对触摸板双指上下滑无效——那是系统事件，VSCode 无法拦截重定向
容易被忽略的硬件与远程环境陷阱
你调对了所有 JSON 参数却没效果？大概率卡在这几个地方：
- Logitech Options 或 Razer Synapse 等鼠标驱动开启了“平滑滚动”，它会在 OS 层直接吞掉原始滚轮事件，VSCode 根本收不到脉冲——关掉驱动里的对应开关
- WSL/SSH 远程开发时，
editor.smoothScrolling默认降级为无动画，必须加启动参数code --enable-gpu或确保ELECTRON_ENABLE_GPU=1环境变量已生效 - macOS 上同时开启系统“惯性滚动”和 VSCode
smoothScrolling，会导致动画撕裂或响应延迟，建议只留其一
