鼠标滚轮太猛需先调系统设置,sublime不接管原始滚轮事件;windows改“一次滚动行数”,macos调“滚动速度”并启用nsscrollanimationenabled,linux用imwheel调整;scroll_speed仅影响步长感,非速度,推荐0.3~0.5;animate_inert_panning对滚轮无效,仅适用于滚动条拖拽松手或触控板滑动。

鼠标滚轮太猛?先查系统设置,不是Sublime的问题
Sublime Text 不接管原始滚轮事件,它只是被动接收操作系统发来的“滚动 N 行”指令。90% 的“滚轮太快/太慢”问题,根源在系统层,不是配置文件写得不对。
- 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 里折腾配置,只会掩盖真实瓶颈。











