Sublime Text 3143+及ST4原生支持Ctrl/Cmd+滚轮缩放,但macOS需手动创建Default (OSX).sublime-mousemap文件启用;失效主因是未配该文件、鼠标驱动劫持、远程工具拦截、焦点不在编辑区或高DPI设置冲突。

Sublime Text 3143+(含 ST4)原生支持 Ctrl/Cmd + 滚轮缩放字体,Windows/Linux 开箱即用,macOS 必须手动创建 Default (OSX).sublime-mousemap 文件才能启用——不是功能缺失,是平台设计差异。
为什么按住 Ctrl/Cmd 滚轮没反应?常见失效原因
滚轮缩放不生效,90% 不是 Sublime 配置问题,而是外部干扰或平台限制:
- macOS 用户未创建
Default (OSX).sublime-mousemap文件:Sublime 默认完全不监听Cmd + wheel,必须显式声明绑定 - Logitech Options、Razer Synapse 等鼠标驱动劫持了
Ctrl/Cmd + wheel,映射成浏览器缩放或标签切换——进驱动设置里关掉对应项 - TeamViewer / ToDesk 等远程工具拦截滚轮事件,本地直连再试
- 焦点不在编辑区:光标落在侧边栏、控制台、查找面板时,
Ctrl + wheel无效 - Windows 高 DPI 设置冲突:右键快捷方式 → 属性 → 兼容性 → “替代高 DPI 缩放行为” → 勾选并选“应用程序”
macOS 必须手动配 Default (OSX).sublime-mousemap
路径和写法一个字符都不能错,否则白配:
- 打开配置目录:
~/Library/Application Support/Sublime Text 3/Packages/User/(ST4 改为Sublime Text 4) - 新建文件,**严格命名为**:
Default (OSX).sublime-mousemap(注意空格、括号、大小写,不能是default.osx或Default(OSX)) - 内容只填两行 JSON,其他字段全删掉:
[{ "button": "scroll_up", "command": "increase_font_size", "modifiers": ["command"] }, { "button": "scroll_down", "command": "decrease_font_size", "modifiers": ["command"] }]
⚠️ modifiers 必须写 "command",写成 "cmd" 或 "super" 无效;别碰 wheel_up 这种无修饰键绑定,它会废掉所有滚动功能。
别用 wheel_up 绑定缩放——这是自毁操作
网上有些教程教你在 Key Bindings – User 里加 "keys": ["wheel_up"] 直接触发缩放,后果很直接:
- 编辑区失去上下滚动能力,滚轮变成纯缩放器
- 侧边栏、控制台、查找面板全部无法滚动,操作卡死
- 该绑定是全局生效,没法限定作用域(比如只对编辑区起作用)
- 恢复需手动删配置、重启、再排查插件残留
真正需要稳定调节字号的场景(如教学演示、视力适配),优先用键盘快捷键:Ctrl + =、Ctrl + -、Ctrl + 0。它们不依赖鼠标驱动,兼容性高得多,且默认就存在。
滚轮缩放只是临时调整,固定字号得改 font_size
Ctrl/Cmd + wheel 缩放不会保存,关闭再打开就回去了。如果想一劳永逸地固定显示比例:
- 打开
Preferences → Settings - 在右侧用户设置中添加:
"font_size": 14(数值按需调整) - 注意:这仅调编辑区字体,UI 缩放(侧边栏、标签高度等)由
ui_scale控制,两者要分开设
最易被忽略的一点:macOS 上那个 Default (OSX).sublime-mousemap 文件,名字里的空格和括号缺一不可,少一个就失效——很多人反复试了十几次,就因为多打了个下划线或漏了空格。

















