Sublime Text 不支持平滑滚动是因为其原生GUI层仅响应整行/整页的滚动事件,未接入系统级高精度滚动事件流;唯一有效折中方案是设置 "scroll_wheel_multiplier": 0.3 并启用 subpixel_antialias 渲染。

Sublime Text 默认不支持鼠标滚轮的平滑滚动(即惯性滚动、像素级滚动),滚动行为是“一格一格”的离散跳变,尤其在高 DPI 屏幕或 macOS 上配合触控板/Logitech 鼠标时,体验明显生硬。这不是 bug,而是 Sublime Text 基于原生 GUI 工具包(macOS 的 Cocoa / Windows 的 Win32)对滚动事件的默认处理方式 —— 它只响应 WM_MOUSEWHEEL 或 NSMouseScrollEvent 的整行/整页 delta,不消费系统级的平滑滚动事件流。
为什么 Sublime Text 不响应 macOS 触控板的平滑滚动
macOS 的平滑滚动依赖 NSScrollView 的连续 scrollWheel: 事件,但 Sublime Text 的文本视图(STView)未启用 setUsesPredominantAxisScrolling:,也未将 hasPreciseScrollingDeltas 设为 YES。结果就是系统把细粒度的 delta 合并成大步长后才上报,Sublime Text 拿到的永远是 ±1 行或 ±3 行的跳跃值。
- 即使你在系统设置里开启「滚动方向:自然」,Sublime Text 也不会变
- 第三方工具如
SmoothScroll或LinearMouse对 Sublime Text 进程基本无效 —— 它们无法注入到 Sublime 的原生视图层级 - 插件如
Smooth Scrolling(Package Control 可搜)仅控制动画过渡帧,不改变滚动事件源,属于“视觉欺骗”,无法解决卡顿感
Windows 下用 Logitech Options 启用平滑滚动仍无效的原因
Logitech Options 软件发送的是标准 WM_MOUSEWHEEL 消息,而 Sublime Text 的消息循环只检查 wParam 中的 HIWORD(wParam)(即 wheel delta),忽略低精度之外的增量信息。它不会去调用 GetScrollInfo 或监听 WM_VSCROLL 的 SB_THUMBTRACK 类型来实现像素级拖拽。
- 修改注册表强行提高
MouseWheelScrollLines只会让每次滚动跳得更猛,不是更顺 -
AutoHotkey脚本模拟SendInput发送小幅度滚轮事件,容易触发防误触逻辑,且无法与光标位置联动 - 真正有效的路径只有:让 Sublime Text 主动接收并解析原始输入设备的高精度 delta —— 但这需要修改其底层渲染层(目前闭源,不可行)
唯一可落地的折中方案:调整 viewport 行高 + 启用 subpixel rendering
虽然不能实现真正的平滑滚动,但可通过缩小单次滚动的视觉位移量 + 提升渲染细腻度,显著缓解“顿挫感”。核心是让 scroll_wheel_multiplier 和字体亚像素渲染协同生效:
- 在
Preferences.sublime-settings中添加:{ "scroll_wheel_multiplier": 0.3, "font_options": ["subpixel_antialias"] } -
scroll_wheel_multiplier小于 1.0 时,Sublime Text 会把原始 wheel delta 缩放后应用,0.3 ≈ 每滚一下移动约 1/3 行,配合代码折叠和行号对齐,人眼感知更连贯 - 务必确认你的字体支持亚像素渲染(如
"font_face": "Fira Code"),否则subpixel_antialias无效;macOS 上需关闭font_options中的directwrite(Windows)或coretext(macOS)干扰项 - 该设置对触控板三指滑动无效(系统直接走手势通道),但对物理鼠标滚轮、Magic Mouse 滚动环完全生效
平滑滚动的本质是输入事件链(硬件 → 驱动 → 系统合成 → 应用消费)中某一级缺失了高采样率支持。Sublime Text 卡在最后一环 —— 它没暴露接口给用户接管原始 wheel event,也没计划接入 Wayland 的 zwp_pointer_gestures_v1 或 macOS 的 IOHIDEvent。所以所有“开启平滑滚动”的教程,要么改了别的软件、要么骗了眼睛、要么根本没生效。真要丝滑,只能换编辑器;想留着 Sublime,就老老实实调 scroll_wheel_multiplier,再配个好字体。

















