Sublime Text 3143+ 默认支持 Ctrl+滚轮缩放,Windows 失效多因 DPI 设置、鼠标驱动或远程工具拦截;macOS 需手动创建 Default (OSX).sublime-mousemap 绑定 Cmd+滚轮;禁用 wheel_up 无修饰键绑定以防滚动失效。

Ctrl+滚轮缩放默认就可用,别折腾配置文件
Sublime Text 从 Build 3143(2017 年起)开始,Ctrl+wheel_up 和 Ctrl+wheel_down 缩放字体就是开箱即用的功能——你什么也不用改,按住 Ctrl 滚动鼠标滚轮就能放大/缩小编辑区字体。这不是隐藏功能,是官方设计的原生交互。
常见失效现象:滚轮没反应、只滚动不缩放、缩放后字体糊或 UI 错位。根本原因几乎都不是 Sublime 自身问题,而是:
- 系统级 DPI 缩放劫持了事件(尤其 Windows 高分屏下,右键快捷方式 → 兼容性 → “替代高 DPI 缩放行为”选“应用程序”)
- Logitech Options、Razer Synapse 等鼠标驱动把
Ctrl+滚轮映射成标签切换或页面缩放 - TeamViewer / ToDesk 等远程工具拦截了滚轮事件
- 插件冲突(比如 ScrollSync、MouseWheelSwitcher 类插件会覆盖原生绑定)
macOS 用户必须手动建 Default (OSX).sublime-mousemap
macOS 是个例外:Sublime 默认完全不响应 Cmd+滚轮,哪怕你按烂了也没反应。这不是 bug,是设计如此——需要你主动声明鼠标事件绑定。
操作路径:
- 打开配置目录:
~/Library/Application Support/Sublime Text 3/Packages/User/(ST4 对应Sublime Text 4) - 新建文件,严格命名为:
Default (OSX).sublime-mousemap(注意空格和括号,一个字符都不能错) - 填入以下内容并保存:
[{
"button": "scroll_up",
"command": "increase_font_size",
"modifiers": ["command"]
}, {
"button": "scroll_down",
"command": "decrease_font_size",
"modifiers": ["command"]
}]
⚠️ modifiers 必须写 "command",不是 "cmd" 或 "super";否则无效。
别碰 wheel_up 无修饰键绑定,它会废掉滚动
网上有些教程教你在 Key Bindings – User 里加 "keys": ["wheel_up"] 直接触发缩放——这极其危险。
后果很直接:
- 编辑区滚轮彻底失去上下滚动功能,变成纯缩放器
- 侧边栏、控制台、查找面板全部无法滚动,操作卡死
- 该绑定是全局生效,没法限定只在编辑区起作用
- 恢复时得手动删配置、重启、再排查是否残留插件
真正需要频繁调整字号的场景(如教学演示、视力适配),推荐稳定可靠的键盘方案:Ctrl+=、Ctrl+-、Ctrl+0(重置),它们不依赖鼠标驱动,兼容性高得多。
scroll_speed 和 smooth_scroll 是调滚动体验,不是调缩放
这两个设置常被误认为和“滚轮缩放”有关,其实完全无关:scroll_speed 控制的是文档内容滚动的快慢(比如按方向键或拖滚动条时的灵敏度),smooth_scroll 控制的是滚动动画是否开启。
如果你只是想让滚动更顺滑,可以这样设:
- Preferences → Settings → 右侧 User 设置中加:
"smooth_scroll": true - 再加一行:
"scroll_speed": 0.6(默认是1.0,数值越小越细腻)
但请注意:这些对 Ctrl+滚轮 缩放本身毫无影响。缩放改变的是 font_size,而滚动体验由 scroll_speed 和渲染管线决定——两者走的是完全不同的代码路径。
最容易被忽略的一点:macOS 用户建错文件名、Windows 用户开着 Logitech Options 却去改 Sublime 配置,这类“方向性错误”比技术问题更耗时间。










