wangzhy Keymap
为 macOS 上的 VS Code 提供一套沿用 IDEA 使用习惯的快捷键:Ctrl 换成 Cmd,Alt 对应 Option。支持编辑、搜索、导航、Git 和 Markdown 编辑等常用操作。
快捷键仅在 macOS 生效,Windows 和 Linux 的快捷键不受影响。下述 Go 配置初始化适用于各桌面平台。扩展 ID:wangzhy.wangzhy-keymap。
使用
安装并启用扩展后,快捷键立即生效。若同时启用了其他 Keymap 扩展,建议在当前 Profile 中只保留一套。用户自己在 keybindings.json 中定义的规则优先于扩展。
在设置中搜索 wangzhyKeymap.enabled,可以为当前工作区启用或关闭。
仅对某个项目启用时:
在用户设置中将 wangzhyKeymap.enabled 设为 false。
在该项目的 .vscode/settings.json 中加入:
{
"wangzhyKeymap.enabled": true
}
也可以为不同项目使用独立的 VS Code Profile。
自动配置 Go
安装并启用扩展后,首次激活会自动将以下配置写入当前 Profile 的用户 settings.json。已有用户升级到 0.1.9 后也会执行一次。需要已安装并启用 Go 扩展,本扩展不会自动安装 Go 扩展或 Go 工具链。
{
"gopls": {
"experimentalPostfixCompletions": true,
"usePlaceholders": true
},
"[go]": {
"editor.defaultFormatter": "golang.go",
"editor.formatOnSave": true,
"editor.codeActionsOnSave": {
"source.organizeImports": "explicit"
}
}
}
首次写入会覆盖这几项已有的用户值,保留其他 gopls、Go 编辑器设置和保存动作;这两项 gopls 设置已有的 ui.completion. 别名会合并为上面的写法。工作区设置不会被写入或复制到用户设置,已有工作区覆盖仍然有效。
配置成功后记录完成状态,之后重启或升级不会再次覆盖你的修改。关闭 wangzhyKeymap.enabled 仅关闭快捷键,不影响初始化;禁用扩展不会清理设置。若缺少 Go 扩展或设置文件无法写入,会提示原因;处理后执行 Developer: Reload Window 重试。命令行安装时若 VS Code 未运行,则在下次启动并激活插件时写入。
从 0.1.10 起,卸载会自动撤销有修改记录的配置:新增项删除,覆盖项恢复原值,安装前已经相同的项保留。清理时逐项比较当前值,只有仍与插件写入值相同的项才处理;你后来改为其他值的项和无关设置都会保留。若保存动作原来使用数组,未被修改时还原数组;后来添加或修改了其他动作,则保留这些修改,只撤销本插件对整理导入的改动。
清理由 VS Code 的 vscode:uninstall 脚本执行,通常需要卸载后完全退出并重新启动 VS Code。如果其他 Profile 仍安装着此插件,需要等插件从所有 Profile 完全卸载后才会运行;普通关闭窗口、禁用或升级不会触发清理。完成卸载后重新安装,会再次进行初始化。
0.1.9 已经初始化过的配置没有修改前记录,升级时不会重新覆盖或将它们标记为新版本创建;卸载也会保留这些旧配置。设置文件损坏或清理过程中被其他进程修改时,清理会保留无法处理的文件和记录,错误写入 VS Code 日志。
快捷键
下表中的 Option 即键盘上的 ⌥ / Alt。
| 操作 |
快捷键 |
说明 |
| 文件结构 |
Cmd+O |
列出当前文件中的方法、类和变量等符号 |
| 删除行 |
Cmd+D |
支持选中的多行 |
| 切换加粗 |
Cmd+B |
Markdown 中添加或移除 **,保留选区,支持再次切换 |
| 切换红色加粗 |
Ctrl+Cmd+B |
Markdown 中用红色加粗 span 包裹选中文字,再次按键取消;无选区时不处理 |
| 切换斜体 |
Cmd+I |
Markdown 中添加或移除 * |
| 切换代码块 |
Ctrl+Cmd+反引号(`) |
Markdown 中用反引号围栏包裹选中文字所在的整行;无选区时处理当前行,再次按键取消代码块 |
| 切换标题 |
Cmd+1~6 |
Markdown 中设置或取消当前行的一级至六级标题;其他级别直接替换 |
| 在选中文本上粘贴链接 |
Cmd+V |
Markdown 中复制 URL 后选中文字,例如粘贴为 [文字](https://example.com) |
| 在下方插入新行 |
Shift+Enter / Cmd+Enter |
与 VS Code 默认 Cmd+Enter 相同,在当前行下方插入新行并移动光标 |
| 向下复制行 |
Cmd+Option+↓ / Ctrl+Option+↓ |
支持选中的多行 |
| 上移一行 |
Cmd+↑ |
支持选中的多行 |
| 下移一行 |
Cmd+↓ |
支持选中的多行 |
| 全局搜索 |
Cmd+H |
搜索工作区中的文本 |
| 查找文件(Go to File) |
F3 / Cmd+Shift+R |
按文件名快速打开 |
| 查找类 / 符号 |
Cmd+Shift+T |
搜索工作区符号,也包含函数和变量 |
| 查找所有引用 |
Cmd+G |
在 References 视图显示结果,需语言扩展支持 |
| 当前符号高亮 |
Cmd+Shift+G |
近似替代当前文件引用查询,不提供引用列表 |
| 关闭标签页 |
Cmd+W |
关闭当前编辑器标签 |
| 前进 |
Cmd+→ |
编辑位置历史 |
| 后退 |
Cmd+← |
编辑位置历史 |
| 撤销 |
Cmd+Z |
撤销编辑 |
| 重做 |
Cmd+Y |
重做编辑 |
| 跳转到实现 |
Cmd+T |
需语言扩展支持 |
| 类型继承关系 |
Cmd+Option+H |
查看类型层次,需语言扩展支持 |
| 跳到指定行 |
Cmd+L |
输入行号 |
| 当前文件查找 |
Cmd+F |
查找文本 |
| 当前文件替换 |
Cmd+R |
替换文本 |
| 格式化代码 |
Cmd+Option+L |
有选区时仅格式化选中内容,无选区时格式化整个文件;需配置格式化工具 |
| 整理导入 |
Cmd+Shift+O |
整理、清理导入,需语言扩展支持 |
| 大小写转换 |
Cmd+Shift+U |
先选中文本,再切换英文大小写 |
| 全部展开 |
Cmd+Shift+= |
展开所有折叠区域 |
| 全部折叠 |
Cmd+Shift+- |
折叠所有可折叠区域 |
| 构建项目 |
F9 |
执行默认构建任务 |
| 当前文件历史 |
F1 |
打开 Timeline 时间线 |
| 重命名 |
F2 |
编辑器中重命名符号,资源管理器中重命名文件 |
| 悬浮提示 / 翻译 |
F4 |
显示悬浮内容;译文由翻译扩展提供 |
| 从 Git Changes / Markdown 预览进入源文件 |
F12 |
支持左侧 Changes / Staged Changes 列表、差异编辑器和 Markdown 预览 |
| 触发行内代码建议 |
Cmd+I |
在 Markdown 以外的文件中生效,需启用 Copilot 或其他行内补全提供者 |
代码块快捷键使用反引号的物理键位(ctrl+cmd+[Backquote]),不随键盘布局变化。macOS 的 ABC / 美式布局会把 Option+反引号用于组合输入重音字符,因此从 0.1.15 起改用 Ctrl+Cmd+反引号。
另外保留以下习惯:无选区时 Cmd+Shift+L 格式化整个文件,Option+F4 关闭远程连接,Cmd+P 不再打开文件。查找文件请使用 F3 或 Cmd+Shift+R。未添加 Java 的 try-catch / Surround With 快捷键。
Markdown 编辑
这些功能参考 Markdown All in One,直接集成在本扩展中。仅在 macOS 的可编辑 Markdown 源文件中启用,受 wangzhyKeymap.enabled 控制。
- 加粗与斜体:
文字 与 **文字** / *文字* 之间切换,支持反向选区、多选区和跨行文本;只选中标记内的正文也可取消样式。没有选区时处理光标所在单词,空白处插入成对标记并把光标放在中间;在闭合标记前再次按键可跳出标记。首尾空白留在标记外,加粗与斜体可以叠加。
- 红色加粗:选中文字后按 Ctrl+Cmd+B,生成
<span style="color:red;font-weight:bold;">选中的文字</span>,并选中完整 span。选中完整 span 或其全部正文时再次按键,移除一层对应标签并选中正文。只识别这一固定样式的标签,不转换其他样式;原文中的空白、换行和特殊字符原样保留,不做转义。支持反向选区、多选区、跨行文本,以及一次撤销、重做;没有选区时不修改文本,混合多选区中的空光标不插入标签。命令面板也提供“Markdown:切换红色加粗”。
- 代码块:按 Ctrl+Cmd+反引号(
`),在选中文字所在的整行上下各添加一行三个反引号,不添加语言名称;选区终点在下一行行首时,不包含该行。没有选区时处理当前行,空行生成空代码块。光标或选区位于同一个已闭合的反引号代码块内时,移除整块的首尾围栏(包括开头的语言名称),保留正文;未闭合的代码块不处理。支持多选区,重叠或相邻行合并,同一代码块只处理一次。正文含连续反引号时自动使用更长的外层围栏,保留原文、换行格式和选区方向,可一次撤销、重做。
- 标题:Cmd+1~6 分别设置或取消一级至六级标题。例如
### 标题 按 Cmd+2 变为 ## 标题,再次按下变为 标题;空行会插入相应的 # 前缀和空格。始终只修改主光标所在行,选中多行时以选区活动光标所在行为准;保留正文、缩进和选区方向,可一次撤销。仅识别行首的 # 至 ###### 标题前缀,其他内容原样保留,不额外转换下划线式标题、列表或引用结构;代码围栏、缩进代码、HTML 块和数学块中不执行。命令面板也提供六个“Markdown:切换…级标题”命令。
- 粘贴链接:单行选区上按 Cmd+V,剪贴板是单个 URL 时生成 Markdown 链接;链接中的括号及文本中的方括号会转义。普通文本、多行选区、已有 URL 或链接交回 VS Code 原有粘贴流程。支持多个独立选区。
| 列表操作 |
快捷键 |
行为 |
| 继续列表 |
Enter |
支持 -、+、*、1.、1) 和任务列表;新任务默认未完成 |
| 在下一行追加列表项 |
Cmd+Enter |
光标位于行中时也从当前行末尾追加 |
| 普通换行 |
Shift+Enter |
在列表中换行,不添加列表标记 |
| 退出空列表项 |
Enter |
嵌套项先减少缩进;顶层任务项先移除复选框,再移除列表标记 |
| 调整列表缩进 |
Tab / Shift+Tab |
在列表前缀处或有选区时按 Tab 缩进;Shift+Tab 减少缩进,缩进宽度参考前面的列表标记 |
| 移除前缀 |
Backspace |
在正文开头移除任务复选框、减少嵌套缩进,或将顶层标记替换为空格 |
| 移动、复制列表行 |
Cmd+↑/↓、Cmd+Option+↓、Ctrl+Option+↓ |
沿用现有键位,并整理受影响有序列表的编号;也支持 VS Code 的 Option+↑/↓ 和 Shift+Option+↑/↓ |
| 调整选中行缩进 |
Cmd+] / Cmd+[ |
缩进或减少缩进,并整理编号 |
命令面板还提供“Markdown:切换列表标记”(按 - → * → + → 1. → 1) → 无标记循环)和“Markdown:切换任务完成状态”。编号整理与当前列表操作可一起撤销。代码围栏、缩进代码、HTML 块和数学块中的类似列表文本不会触发列表编辑;引用块支持 Enter 延续 >。
输入建议、代码片段、Tab 移动焦点和 Vim 非插入模式等上下文会让列表按键保留原有操作。其他 Markdown 扩展或用户自定义快捷键仍可能覆盖这些绑定。
功能差异
- 格式化代码:选中内容时使用选区格式化,需要当前语言的格式化工具支持;不支持时不会改为格式化整个文件。
- 查找引用与高亮:引用查找需要语言扩展。符号高亮不等于“只查当前文件的引用列表”;若
editor.occurrencesHighlight 为 multiFile,还可能高亮其他打开的文件。使用 singleFile 可限制为当前文件。
- 整理导入:整理、排序和清理未使用的导入,不保证补齐缺失的导入。缺失导入通常使用快速修复。
- 大小写转换:选区包含 a–z 小写字母时全部转大写,否则转小写;转换后保留选区,可以再次切换。按 Esc 退出代码片段模式。
- 构建:F9 不自动 clean。只有默认构建任务本身执行清理再构建时,才是完整重建。
- 历史:时间线可能同时显示 Git 提交与本地保存记录,可在时间线筛选器中只保留 Git。命令面板仍使用 Cmd+Shift+P。
- 翻译:F4 只打开悬浮提示。可自行安装并启用 Comment Translate,设置翻译源并开启
commentTranslate.hover.enabled。本扩展不捆绑翻译服务。
- Git 文件与 Markdown 预览:点击 Changes / Staged Changes 中的文件后,焦点可以留在左侧列表,按 F12 即可从当前预览进入工作区源文件。差异编辑器、Markdown 渲染差异和普通 Markdown 预览中也可直接按 F12;Git 差异打开的是工作区版本,普通源文件中仍沿用 VS Code 默认行为。历史提交中已删除的文件可能没有对应的工作区文件。
- 代码提示:在 Markdown 以外的文件中,Cmd+I 触发行内补全,不是 IntelliSense 下拉列表或聊天窗口。
macOS 按键冲突
Cmd+H 与 Cmd+Option+H 也用于 macOS 菜单的“隐藏”和“隐藏其他”。如果按下后仍触发隐藏,可在“系统设置 → 键盘 → 键盘快捷键 → App 快捷键”中,将 VS Code 对应菜单项改成其他按键;菜单名称必须与实际显示完全一致。参见 Apple 的设置说明。
如果 F1–F12 用作亮度、媒体等系统功能,请配合 Fn 使用,或启用标准功能键。
这些绑定会在对应上下文覆盖部分 VS Code 默认操作,例如 Cmd+D 的多选、Cmd+↑/↓ 的文档首尾跳转,以及 Markdown 编辑器中 Cmd+1~6 的编辑器组切换。输入框和终端仍尽量保留原有导航。
许可证
MIT。参考实现的来源和许可随包保存在 THIRD_PARTY_NOTICES.md。