解决Sublime鼠标滚轮滚动速度过快或过慢的微调

鼠标滚轮太猛？先别急着折腾 Sublime 配置文件，90% 的情况是系统设置没搞定。Sublime Text 不接管原始滚轮事件，它只是被动接收操作系统发来的“滚动 N 行”指令——所以，问题根源多半在系统层。

鼠标滚轮太猛？先查系统设置，不是Sublime的问题

Sublime 本身并不插手滚轮行为的底层逻辑，它只是听命于系统发来的滚动行数指令。所以当你觉得滚轮太快或太慢时，第一反应应该是检查操作系统，而不是翻配置文件。

• Windows：打开「设置 → 设备 → 鼠标 → 滚动」，把「一次滚动的行数」从默认的 3 改成 1（更细腻）或 5（更快速），改完立刻生效，无需重启。
• macOS：进入「系统设置 → 鼠标 → 滚动速度」，把滑块拉到中间偏右的位置；然后在终端里跑一句 defaults write -g NSScrollAnimationEnabled -bool true，启用系统级惯性效果。
• Linux（GNOME）：在「设置 → 鼠标和触摸板 → 滚动速度」里调整，如果还不够，装个 imwheel，把配置里 Button4/Button5 后面的数值从 3 改成 4～6 试试。
• 外接鼠标驱动（比如 Logitech Options、Razer Synapse）常常默认启用「超速滚动」或「无限滚动」——务必关掉。它们会直接劫持滚轮事件，Sublime 根本收不到原始信号。

scroll_speed 调的是“步长感”，不是“速度”

scroll_speed 这个参数，影响的只是鼠标滚轮和滚动条拖拽时的视觉步长密度。值越小，每次动作移动的行数越少，看起来会更细腻；但它不会改变滚轮本身的物理行为，也不影响方向键、Ctrl+G 等跳转操作。

• 默认值是 1.0，推荐设为 0.3～0.5 之间，例如 "scroll_speed": 0.4。
• 低于 0.1 的话，滚动条拖拽会明显卡顿、响应迟钝。
• 这个参数和系统设置是叠加关系：举个例子，Windows 里设了“一次滚动 3 行”，scroll_speed 设成 0.5，实际效果就是滚 1.5 行（向下取整为 1 行）。
• 如果装了 SmoothScroll 之类的插件，它可能会和 scroll_speed 共同作用，导致动画变得过慢——这时候建议先关掉插件，或者把 scroll_speed 提高到 0.5 以上。

animate_inert_panning 不是给滚轮用的

animate_inert_panning 这个设置，其实跟滚轮半点关系没有。它只对两种场景有效：按住滚动条拖拽后松手，或者触控板快速滑动后松手——会带来类似 macOS 的惯性滑行效果。鼠标滚轮、方向键、Ctrl+G 统统不受影响。

• 必须同时启用 "animation_enabled": true，否则该设置静默失效。
• 建议再加上 "hardware_acceleration": "opengl"，尤其 Intel 核显或 macOS 用户，能明显改善帧率。
• 值必须写成布尔值 true，不能带英文引号——写成 "true" 字符串会解析失败。
• Logitech G HUB 等驱动如果开启了「自然滚动」或「惯性增强」，会覆盖 Sublime 的惯性逻辑，记得关掉。

别碰 Default (Windows).sublime-mousemap，除非你清楚后果

编辑 Default (Windows).sublime-mousemap 看起来挺自由，实际上很容易翻车。新手常犯的错误是误绑无修饰键的 wheel_up，结果整个编辑区无法上下滚动。

• 只建议用它来微调带修饰键的行为，比如这样写：{"modifiers": ["ctrl"], "button": "wheel_up", "command": "zoom_in"}。
• 绝对不要写这种：{"button": "wheel_up", "command": "scroll_lines", "args": {"amount": 1}}——这会直接干掉所有基础滚动功能。
• macOS 用户如果想用 Cmd+滚轮 缩放，必须创建 Default (OSX).sublime-mousemap，而且 modifiers 必须写 "command"，不能写成 "cmd"。
• 修改后需要重启 Sublime 才生效，而且它和系统设置是并存的——调完了 mousemap，还要回头检查系统级设置，否则效果直接打对折。

真正起效的组合，永远是系统设置打底 + scroll_speed 微调观感 +（仅触控板/滚动条场景）animate_inert_panning 补惯性。鼠标滚轮本身没有所谓的“平滑动画”，强行在 Sublime 里折腾配置，只会掩盖真正的瓶颈。