VS Code 能不能自定义鼠标快捷键？

👁 95 次阅读

问题来源：https://github.com/microsoft/vscode/issues/3130 如果只问能不能，答案是：完全不能。这篇问答把微软在 2016 年开的 microsoft/vscode#3130 讨论清楚，讲明白哪些行为今天已经能改，哪些改不了，以及网上流传的那段鼠标键位 JSON 为什么是无效配置。

现象描述

从 Sublime Text、Atom 迁到 VS Code 的用户，第一周基本都会撞同一个问题：习惯的 Ctrl+Click 加多光标，在 VS Code 里默认是 Alt+Click。想改，结果发现键位设置里搜 mouse，能搜到的一律是键盘键位，没有一个属于鼠标。这个诉求从 2016 年 2 月就开始在 #3130 里被反复 +1，issue 一直挂着 feature-request 标签，到今天仍然是 open 状态。所以它不是你没找到入口，是这个功能确实没做出来。

为什么鼠标快捷键进不了键位系统

VS Code 有一个键位规则引擎，你写的 keybindings.json 就是喂给它的。但这个引擎只认「修饰键 + 按键」，不认「修饰键 + 鼠标点击」。原因在架构：编辑器的鼠标手势分发走的是编辑器视图控制器里的一路硬编码逻辑，从不调用键位引擎；打开链接、跳转定义这些行为也各自单独判断 Ctrl+Click、Alt+Click。扩展层拿不到这些鼠标事件的钩子。所以结论很硬：任何写进 keybindings.json 的、形如「鼠标按键」的规则都不可能被执行。

今天能改的：多光标的修饰键

这是 #3130 唯一被官方做了一部分的场景。在 #27193 里引入了这个设置，#27680 把名字改成了 editor.multiCursorModifier。只有两个取值：

{
  "editor.multiCursorModifier": "ctrlCmd"
}

ctrlCmd 在 Windows 和 Linux 上就是 Ctrl，在 macOS 上是 Cmd；alt 是默认值。写进 user settings 之后，用 Ctrl+Click 加多光标。也可以在菜单里切换：选择 → Switch to Ctrl+Click for Multi-Cursor，或者命令面板里搜 Toggle multi-cursor Modifier。这里有个必须理解的行为。VS Code 不允许两个行为抢同一个修饰键，所以当多光标占掉 Ctrl 时，打开链接和跳转定义会自动让位给 Alt。设置成 ctrlCmd 之后用 Ctrl+Click 打开链接失效，这是设计出来的结果，不是 bug。想要跳转定义还是走 Ctrl 的话，只能保持多光标用 Alt。

仍然做不到的事

#3130 里的三个典型诉求，今天一个都还没有解：一、Sublime 风格的 mousemap 文件。issue 里贴过一份 Sublime 的写法，用 button 加 modifiers 声明拖选。VS Code 没有等价物，鼠标手势不走声明式规则，所以做不出来。二、自定义修饰键组合。想设成 Ctrl+Alt+Click，这个也不行。官方在 #3091 里回复过，目前只支持 ctrlCmd 和 alt 两个取值，不支持任意组合。三、给单行多光标、矩形选择这类操作分配鼠标手势。这些同样是硬编码的，没有入口。至于网上流传的这段配置，它不能实现鼠标快捷键自定义：

[
  { "key": "mouse shortcuts", "command": "editor.action.addSelection", "when": "editorHasSelection" }
]

editor.action.addSelection 是一个键盘命令，能绑到键盘按键上。但 mouse shortcuts 不是合法的 key 表达式，规则引擎直接忽略整条。这段配置看起来像 Sublime 的 mousemap，实际在 VS Code 里什么都不会发生。如果确实要替换鼠标组合键，可行的路子是放在编辑器外面：Windows 上用 AutoHotKey 拦截 Ctrl+LeftClick 之后转发出 Alt+Click，#3130 里有人贴过这个脚本，缺点是它在链接上行为不对；macOS 用 Hammerspoon；Linux 改桌面环境的键盘绑定。这些都是系统层方案，换编辑器就作废。

Linux 用户还有一个叠加问题

在 GNOME、XFCE 这些桌面环境里，Alt+Click 常被窗口管理器占用来拖动窗口，事件根本到不了 VS Code，这就是 #3091 的由来。 GNOME 下可以这样把鼠标修饰键让出来：

gsettings set org.gnome.desktop.wm.preferences mouse-button-modifier "Super"

注意这只是解决「Alt 被抢」的问题，改完之后 Alt+Click 能到达编辑器了，但 VS Code 内部依然不支持给你配成 Ctrl+Click 以外的任意组合。两件事要分开看。

方案对比

诉求	可行方案	限制
多光标改用 Ctrl/Cmd+Click	editor.multiCursorModifier 设为 ctrlCmd	只有 ctrlCmd 和 alt 两个取值
多光标改用其他任意修饰键	无	#3130 未实现
鼠标手势映射文件（Sublime 风格）	无	#3130 未实现，扩展层无钩子
跳转定义、打开链接改用别的组合	随 multiCursorModifier 自动让位	不能单独指定
Ctrl+Click 选整个单词	给 editor.action.selectWord 绑键盘按键	只能绑键盘按键，不是鼠标
矩形选择换手势	无	硬编码
Linux 上 Alt 被桌面环境抢占	改桌面环境 mouse-button-modifier	只解决抢占，不解决自定义
系统层整体替换鼠标组合	AutoHotKey、Hammerspoon	编辑器外部方案，只对本机生效

常见错误排查

一、配了 multiCursorModifier 之后跳转定义用不了了。这是让位机制，不是坏了。要跳转定义走 Ctrl，就把多光标留成 alt；或者在设置里把 editor.multiCursorModifier 改回 alt。二、Linux 上加不了多光标。先确认 Alt+Click 事件有没有到达 VS Code。用 gsettings 把窗口管理的鼠标修饰键从 Alt 换掉，再试一次；如果换完还不行，说明是编辑器内部的修饰键分工，回到第一个排查项。三、把鼠标快捷键 JSON 写进 keybindings.json 没反应。这是最常见的误配。key 字段的值是键盘按键表达式，鼠标手势不在这个语法里。看到 mouse、button 这种字段，说明这段配置抄自 Sublime，不能直接用。四、改完 settings 没有生效。user settings 保存后编辑器会立即重载配置，不需要重启。如果确实没变，确认你改的是 settings.json 而不是 keybindings.json，这两个文件作用域不同。五、想要 Ctrl+Alt+Click。目前没有取值支持。可以临时用系统层工具把 Ctrl+Alt+LeftClick 转成 Alt+Click，但这是绕过，不是解决。

总结

VS Code 到今天仍然没有通用的鼠标键位映射，#3130 从 2016 年挂着没关。唯一被官方支持的变通是多光标的修饰键，通过 editor.multiCursorModifier 在 ctrlCmd 和 alt 之间选一个，代价是跳转定义和打开链接要跟它互相让位。想要 Sublime 那种声明式的鼠标映射，或者任意修饰键组合，只能自己在操作系统层做事件转发。如果这条限制对你影响很大，直接去 #3130 关注进展，它比任何第三方配置都更接近真相。

FAQ

Q1：VS Code 能自定义鼠标快捷键吗？

A：完全自定义不能。唯一例外是多光标的修饰键，用 editor.multiCursorModifier 在 ctrlCmd 和 alt 两个取值之间选。对应 microsoft/vscode#3130，至今未实现完整方案。

Q2：改完 multiCursorModifier，跳转定义为什么失效？

A：修饰键会被 VS Code 重新分配。多光标占了 Ctrl，打开链接和跳转定义就让位给 Alt。这是设计行为，不是 bug。

Q3：为什么 keybindings.json 里鼠标规则不生效？

A：键位引擎只处理纯键盘按键。鼠标手势在编辑器视图控制器里硬编码，不经过这个引擎，扩展层也没有钩子。任何含 mouse 或 button 字段的规则都会被忽略。

Q4：Sublime 的 mousemap 能在 VS Code 里用吗？

A：不能。VS Code 的鼠标手势不做声明式规则匹配，没有等价配置文件。想做这个能力只能提交到 #3130 跟进。

Q5：Linux 上 Alt+Click 完全无反应怎么办？

A：多数情况是桌面环境把 Alt 占给了窗口拖动，用 gsettings set org.gnome.desktop.wm.preferences mouse-button-modifier 把它换成 Super。改完 Alt+Click 能到编辑器了，但多光标想换成别的键仍然要走编辑器外层的系统工具。