1. 一个键按下去到底是谁先接住的装了 Vim 扩展、把 hjkl 用熟、然后卡在第三天的人我见过太多。Vim 的快捷键本身并不难记难的是把它塞进 VSCode 这套已经有几百条命令的快捷键体系里还得让两边不打起来。这篇是我这些年攒下来的VSCode Vim 快捷键整理不按官方速查表的字母顺序排而是按写代码时手会往哪儿伸的顺序重排了一遍顺手把容易踩的冲突点、开关项和配置写成能直接抄的样子。它适合两类人一类是从没用过 Vim、想直接在图形界面编辑器里上手的另一类是在终端里用得挺熟、搬到 VSCode 之后总觉得手感不对的。前者的重点是先建立模式概念后者的重点大多是冲突排查。先把最容易误解的一件事说清楚在 VSCode 里按下一个键它经过的链路不是一条而是三条。操作系统或输入法先看一眼编辑器自己的快捷键表看一眼Vim 扩展再看一眼。哪一层先接住决定了你看到的结果。很多人以为Vim 模式一开所有键都归 Vim 管这是错的也有人以为VSCode 的快捷键优先也不对。真实情况是按模式、按具体键、按你的配置动态变化的这也是为什么同一个CtrlD在不同人的机器上表现完全不同。1.1 Normal 模式几乎全接管Insert 模式几乎全放手Vim 扩展的处理策略其实很朴素Normal 模式下凡是在它键表里登记过的键它全部截住自己处理没登记的才往下丢给编辑器Insert 模式下它几乎不截任何键输入直通编辑器只有Esc和少数显式配置的组合会回到自己的流程里。所以你会遇到一个很反直觉的现象——同一个CtrlD在 Normal 模式里是往下翻半页进了 Insert 模式就变成别的行为甚至可能是编辑器的添加下一个选中项。这不是 bug是设计如此。理解了这个分层很多玄学就能解释了。比如有人抱怨我的dd有时候删一行有时候什么都不干八成是他以为自己还在 Normal 模式实际光标在搜索框或者终端面板里又比如为什么CtrlF一会儿是翻页一会儿是查找框因为默认配置下CtrlF在 Normal 模式里被交给了编辑器的查找命令而不是 Vim 的翻页。搞清楚每一层管什么后面所有冲突都能自己定位。1.2 三种典型冲突表现和对号入座的判断方法我把见过的冲突归成三类按出现频率排表现大概率原因快速验证方式键完全没反应像被吞掉Vim 接管了但没定义动作或者被handleKeys显式禁用换 Insert 模式按同一个键行为不同就说明是 Vim 层触发了编辑器自带功能该键被让给了 VSCode默认或配置里设为 false打开键盘快捷方式面板搜这个键看有没有绑定触发了系统或窗口行为操作系统层面的全局快捷键优先换个应用按同一个键如果行为一致就是系统层「键盘被吞掉」这个现象特别容易误导人。VSCodeVim 里有不少键是登记了名字但当前上下文没有对应动作按下去毫无反馈看起来就像键盘坏了。遇到这种情况先切到 Insert 模式试一次能立刻分辨是不是 Vim 层的问题。排查的时候还有一个通用手法把 Vim 扩展临时禁用再按那个键。如果行为恢复成普通 VSCode 的样子问题就在 Vim 层如果还是不对问题在编辑器或系统层。这个二分法能省掉大量翻配置的时间我至今还在用。2. 移动类快捷键从能挪到能预判落点移动是 Vim 的基本功也是最容易被低估的部分。新手觉得 hjkl 就是方向键的替代品用了一周之后发现还不如方向键快于是放弃。真正的问题在于hjkl 的价值从来不是单次移动而是带着数字前缀做批量移动并且落点可以预判。方向键按住不放是看着屏幕等它到5j是我心里知道第五行在哪。前者需要眼睛参与后者不需要这是本质差别。所以练移动的顺序建议是先把wbe和0^$这六个练到肌肉记忆再上数字前缀最后才是ft这类需要看一眼前方字符的跳转。跳过前三步直接上 f/t会出现按了 f 之后不知道要按哪个字符的尴尬反而更慢。2.1 字符、单词、行内三段位移的取舍按粒度分行内移动其实有三档字符级、单词级、行边界。字符级就是 hjkl 和左右方向改一个错别字用它单词级是w下一个词首、b上一个词首、e当前/下一个词尾在大驼峰或者下划线命名的标识符上跳转用它行边界是0行首含空格、^行首第一个非空字符、$行尾。这里有个新手常见的误区0和^混着用。写代码时行首往往是缩进你想去的是第一个非空字符那就该用^0是真正意义上第 0 列只有你想在缩进区插东西时才用。这两个键用错会带来大量怎么光标停在缩进里的困惑。另外w在标点上的行为要注意小写w会把标点当成独立的词foo.bar会被切成三段大写W按空白切分foo.bar是一整段。改代码里的函数调用链时W通常更顺手。2.2 跨屏与跨文件的位置跳转屏幕级移动有几个必须记住的CtrlD下翻半页、CtrlU上翻半页、CtrlF下翻整页、CtrlB上翻整页。半页翻是阅读长文件的主力整页翻更适合快速扫结构。同一屏幕内的三个落点用H顶、M中、L底配合zt当前行滚到顶部、zz滚到中间、zb滚到底部来调整视野读一大段代码时这套组合比用鼠标滚轮精准得多。跨位置的大跳gg到文件头、G到文件尾、数字 G到指定行、%在配对括号之间来回跳。%这个键在处理嵌套很深的表达式时价值极高尤其在需要确认某个}到底闭的是哪一层的时候。段落跳转用{和}在 VSCode 里它们按空行切分对分块明显的代码文件很实用。括号跳转和段落跳转这两个我建议直接背下来它们几乎每天都会用到一次以上。2.3 标记、跳转历史与回跳m加一个字母打标记反引号加同一个字母跳回去单引号加字母跳到标记所在行的行首。这个功能在需要去别处看一眼再回来时特别省事比如你在第 40 行看到一个函数名想去下面确认它的实现ma打标看完a回来比记住行号靠谱得多。比标记更省心的是跳转历史CtrlO后退到上一个位置CtrlI前进。这套是编辑器层面维护的全局跳转栈你用gd跳定义、用搜索跳走、用%跳括号全都会被记进去。所以跳出去之后回不来这件事根本不存在只要记得CtrlO。我个人习惯是任何一次跨文件跳转之后回程一律用CtrlO不用标记因为标记要额外按一次键去设而跳转历史是自动的。唯一的例外是同一文件内的短距离往返用 两个反引号直接回到上次跳转的起点更快。3. 操作符加动作Vim 真正省时间的地方如果只能保留一类快捷键我会留操作符加动作这一套其他全砍掉。原因很简单它把编辑操作变成了可组合的语法d是删除这个动词后面能跟任意一个动作或者文本对象d3w、di(、dap、d/fooEnter全部合法。这种组合性带来的是按键数量的指数级下降——你会的那几个动词乘以你会的那些动作就是你能用的全部编辑命令不需要为每个场景单独记一条快捷键。对比一下就很明显。普通编辑器里删掉当前光标所在的这个函数体你要么手动拖选眼睛找起止点需要来回滚屏要么连按几十次删除键。Vim 里是di{三个键不管函数多长。这个差距在改动大段代码时会被放大得非常厉害也是很多人用了 Vim 模式之后再也回不去的原因。3.1 d/c/y 后面能跟什么三个基础操作符d删除、c删除并进入 Insert 模式、y复制。它们的用法完全同构学会一个就学会了三个。后面能跟的东西分两类一类是动作一类是文本对象。动作类的常见组合组合效果使用场景dw删到下一个词首删一个变量名d$或D删到行尾删行尾注释d0删到行首删行首缩进或表达式dd删整行最常用没有之一dj/dk删当前行和下一行/上一行连删两行代码dG删到文件尾清空后面全部内容d/fooEnter删到下一个 foo 出现处删到某个标记位置caw改一个词含周围空格处理重命名局部变量y这一组也一样yy复制一行、y$复制到行尾、yj复制两行。p粘贴到光标后P粘贴到光标前。这里有个细节值得单独说Vim 的yy默认走的是 Vim 自己的寄存器不进系统剪贴板粘到浏览器里是空的。想要互通需要打开配置项后面第 6 章会讲。3.2 文本对象清单与优先级文本对象是这套体系里最值钱的部分格式统一是iinner不含边界或aaround含边界加一个字符。挑最常用的列对象inneraround说明词iwaw光标在词内任意位置都能选中整个词引号ia单双引号、反引号都支持圆括号i(或iba(参数列表改起来极快花括号i{或iBa{函数体、对象字面量方括号i[a[数组、下标尖括号ia模板参数、标签标签itatHTML 或 JSX 里成对的标签段落ipap按空行切分的整段用起来的差别可以用一个具体场景说明改一个函数调用的某个参数光标停在那个参数上ci(会删掉整个参数列表并进入 Insert 模式等你输入ci,之类不支持逗号但你可以用ci(之后重写全部参数。或者更精准一点用f,跳到逗号、ciw改单个参数。前者适合整体重排后者适合改一个值看你手头的情况选。it和at这两个在写前端模板的时候效率提升非常明显因为标签嵌套往往很深手选起止位置很容易选错一层cit则是稳稳地落在最内层标签内容上。3.3 重复、撤销与宏的边界.是重复上一次修改这是 Vim 里性价比最高的一个键。注意是修改而不是移动所以dw之后按.会再删一个词之后按.会再缩进一行。把.用好很多重复劳动可以压缩成做一次然后连按点。比如给十行代码加同样的后缀做一遍然后j.j.循环即可。u撤销、CtrlR重做。VSCode 里撤销栈和 Vim 的撤销粒度有时候不完全一致尤其是涉及自动补全、格式化这类编辑器自己做的修改时一次u可能撤掉的比你预期的多。遇到这种情况我通常直接CtrlZ走编辑器自己的撤销别跟 Vim 的撤销树较劲。宏是q加寄存器名开始录制q停止加寄存器名回放重复上次回放数字 批量回放。宏适合处理有规律但不完全规则的批量编辑比如给一批结构相似的行统一加字段。但要提醒一句宏录制会把你所有的移动和输入原样记下来包括你不小心按错的那一下。录之前先想清楚完整动作序列宁可慢一点录一遍正确的也别录完发现中间多删了一个字符再重录。4. 搜索替换与多光标VSCode 的强项怎么接过来Vim 的搜索是围绕模式设计的VSCode 的搜索是围绕界面设计的两者各有优势。我自己的习惯是小范围内的跳转用 Vim 的/*#需要看全局分布或者跨文件批量替换时用编辑器的搜索面板。混着用不丢人效率高就行。多光标这件事要单独提一句因为它最容易在切换 Vim 模式之后出问题。编辑器原生的多光标快捷键大量占用Ctrl组合而这些组合在 Normal 模式下有很大一部分被 Vim 拿走了于是以前一个CtrlD能选一串现在选不了就成了高频反馈。4.1 行内查找、全文搜索与正则替换行内查找是f加字符向后找、F加字符向前找、t加字符向后找到该字符前一位、T同理。找到之后用;重复上一次查找,反向重复。这一组在改一行里重复出现的符号时特别顺比如把obj.a.b.c里的某个点跳到下一处f.然后;;。全文搜索是/加模式回车?方向相反n下一个、N上一个。*直接搜索光标下的词#反向搜索这两个键是读陌生代码时最顺手的工具——看到某个变量名*一按所有出现位置全部高亮配合n挨个跳过去看。替换用:s/旧/新/g替换当前行:%s/旧/新/g替换全文末尾加c会逐个确认。:noh清除搜索高亮这个命令一定要记住否则高亮会一直挂在那儿影响阅读。:%s之前的范围前缀是可以组合的:10,20s/a/b/g只替换 10 到 20 行:,s/a/b/g是可视模式下选中区域的替换。后者在按:时会自动补全不需要手打。4.2 多光标与可视块的按键冲突可视模式有三种v字符选择、V行选择、CtrlV块选择。前两个一般没冲突块选择是重灾区因为CtrlV在多数系统上就是粘贴事件有可能根本到不了编辑器。我见过几种绕法比较稳妥的是给块选择换一个键。在配置里加一条 Normal 模式映射把CtrlQ指到块选择CtrlQ在传统 Vim 里也是块选择的别名切换成本低vim.normalModeKeyBindingsNonRecursive: [ { before: [C-q], after: [C-v] } ]多光标方面编辑器原生的选中下一个匹配命令 ID 是editor.action.addSelectionToNextFindMatch。如果CtrlD在 Normal 模式下不响应这个功能直接映射一条vim.normalModeKeyBindingsNonRecursive: [ { before: [leader, d], commands: [editor.action.addSelectionToNextFindMatch] } ]映射完之后的好处是多光标和 Vim 移动可以共存先用v选中一个词再用leaderd逐个加光标然后I或A在多个位置同时插入最后Esc。这个组合我用得非常多批量改变量名、批量加日志都靠它。要注意的是commands里写的是命令 ID不是快捷键写错一个字符就静默失效改完记得试一次。4.3 重命名、代码动作与跳转定义Vim 扩展里内置了几个直接对接语言服务的键gd跳转到定义、gh悬停显示类型信息、gr查找引用、gi跳到实现、gD跳到声明。这四个我建议直接换掉脑子里F12的印象因为gd不需要伸手。重命名符号在 Vim 里原生是c系列自己改但跨文件改名必须用语言服务否则漏改。命令 ID 是editor.action.rename可以映射成leaderrn之类。代码动作快速修复的命令 ID 是editor.action.quickFix映射成leaderca比较顺手。这两个本质上不是 Vim 的东西但既然要手不离主键区把它们拉进来是合理的一步。5. 把分屏、缓冲区和终端也纳进键位里真正影响效率的往往不是编辑动作本身而是编辑动作之间的切换成本。写代码的时候你会频繁在这个文件和那个文件之间跳在代码和终端之间切在上面那个窗口和下面那个窗口之间扫。这些切换如果都要摸鼠标前面练的移动速度会被吃掉一大半。5.1 窗口操作与焦点切换窗口操作的入口是CtrlW按完之后再跟一个键v垂直分屏、s水平分屏、h/j/k/l往四个方向切焦点、w循环切换、c关闭当前窗口、o只保留当前窗口、让所有窗口等宽。这套组合我用了很多年闭着眼睛都能按。这里必须提醒一个坑在部分平台上CtrlW同时也是关闭窗口的系统快捷键。Vim 扩展正常情况下会接管它但如果你在配置里用handleKeys把它让回给了编辑器那按下去就是直接关窗口很可能连着把项目窗口关了。所以我个人的原则是CtrlW系列一律让 Vim 管不要动。CtrlW还有一个容易卡住的情况按了一次没跟上第二个键这时候界面会停在等待下一个键的状态你会以为键盘没反应了。这时候随便再按一个CtrlW或者Esc就能退出等待不用重启编辑器。5.2 文件与缓冲区的冒号命令:开头的命令行是 Vim 的另一套入口功能比很多人以为的强。常用的几个命令作用备注:e 路径打开文件支持相对路径和补全:w保存:w 文件名另存:q关闭当前编辑器有未保存改动会拒绝:q!强制关闭不保存慎用没有二次确认:wq保存并关闭等价于ZZ:bn/:bp下一个/上一个缓冲区在手头有几个文件时极快:b 名称片段按名字片段切缓冲区比:bn按十次快:vsplit垂直分屏配合文件名一起用:b 片段这个特别值得练因为它比用鼠标点标签页或者用列表挑都快输入:b uti回车直接跳到utils开头的那个缓冲区。名字片段只要能唯一匹配就行我经常只打三四个字符。5.3 终端与调试面板的注意事项终端面板打开之后焦点在终端里这时候 Vim 的键位完全不生效而且CtrlW在 shell 里是删除前一个词。这是我认为最容易让人困惑的一处因为表现上就是Vim 突然失灵了。处理方式有两种。一种是把终端当外部环境进出的时候自觉切换心态另一种是直接在配置里让终端里的Esc退出到 Normal 模式。我倾向于第一种因为终端里的键位习惯CtrlA、CtrlE、CtrlW本身也很好用强行统一反而会互相干扰。做法是任何在终端里按了 Vim 组合没反应的情况先按Ctrl反引号或者点一下代码区把焦点拿回来。调试面板同理断点处的变量查看、单步执行都走编辑器自己的快捷键不在 Vim 的管辖范围内。这部分我建议保留原样别硬映射。6. settings.json 里真正该动的那几行配置项不用多改动越少越稳定。我在不同机器上来回折腾过很多轮最后沉淀下来的就这么几项每一项都有明确的理由不是抄来的。6.1 先打开相对行号和搜索高亮相对行号是让数字 j/k真正好用的前提。打开之后当前行显示绝对行号上下行显示相对于当前行的距离你一眼就能看出往下第 5 行然后5j直接到。editor.lineNumbers: relative有人会担心相对行号影响阅读其实适应期通常只有两三天。如果确实需要偶尔看绝对行号可以用:数字直接跳或者临时在命令面板里切回来。搜索相关的三项vim.incsearch: true, vim.hlsearch: true, vim.ignorecase: true, vim.smartcase: trueincsearch是边输入边跳转hlsearch是保留高亮ignorecase忽略大小写smartcase表示输入里含大写字母时自动变回区分大小写。这四个一起开搜索体验会接近现代编辑器只开前两个不开后两个你会整天被大小写烦到。6.2 leader 键与自建映射leader键默认是反斜杠位置极差我建议改成空格vim.leader: space改成空格之后leader开头的自定义映射按起来就很顺了。下面是我一直在用的一组覆盖了文件搜索、保存、格式化三个高频动作vim.normalModeKeyBindingsNonRecursive: [ { before: [leader, w], commands: [:w] }, { before: [leader, f], commands: [workbench.action.quickOpen] }, { before: [leader, s], commands: [workbench.action.findInFiles] }, { before: [leader, ], commands: [editor.action.formatDocument] } ]Insert模式下最值得加的一条是jj退出vim.insertModeKeyBindingsNonRecursive: [ { before: [j, j], after: [Esc] } ]用jj代替Esc的理由是手不用离开主键区Esc在键盘左上角来回伸手一天几百次累积的疲劳是真实存在的。这条映射只在一个条件下有意义你不用中文输入法打字原因见下一章。6.3 handleKeys把不该 Vim 管的键还回去vim.handleKeys里的键值设为false表示这个键别由 Vim 处理交还给编辑器。典型需要还回去的是补全和查找vim.handleKeys: { C-f: false, C-b: false, C-n: false, C-p: false }这里的取舍要看你的使用习惯。CtrlF交给编辑器就是打开查找框留给 Vim 就是翻页。CtrlN和CtrlP交给编辑器是补全菜单上下选留给 Vim 是光标上下一行。我自己的选择是把补全相关的还给编辑器把翻页留在 Vim因为补全菜单一旦被抢走写代码的节奏会明显变卡。改完这几行一定要重启窗口或者重新加载配置handleKeys不是所有版本都能热更新。改完没效果先别怀疑配置写错先重启试试。7. 中文输入法与跨平台最容易翻车的三个场景前面讲的所有键位都默认了一个前提你按下的字符能原样传到编辑器。这个前提在中文输入法、不同操作系统、远程环境这三种情况下会失效而且失效得很隐蔽——键没坏配置没坏就是行为不对。7.1 jj 退出在中文输入法下失效的原因jj映射能生效的前提是两个 j 字符被送到编辑器。中文输入法在中文状态下会先把按键吃掉转成候选词两个 j 可能变成拼音串或者直接消失编辑器根本收不到。所以你会看到英文状态下 jj 秒退中文状态下按半天没反应。绕开的思路有三种。第一种是把输入法切到英文再按最笨但最可靠第二种是用系统层面的输入法状态切换靠脚本在进入 Insert 模式时切英文、退出时切回中文这需要借助外部工具实现配置起来有一定成本第三种是干脆不依赖jj改用Ctrl[退出 Insert 模式这个组合在中文输入法下通常不会被吃掉而且手的位置也不用大挪。我最后选的是第三种为主、第一种为备。Ctrl[按久了其实比jj更稳因为它不依赖任何输入法状态跨机器、跨平台表现一致。jj那条映射我留着但已经很久没用了。7.2 修饰键的跨平台差异同一条配置在不同系统上可能要改键名。C-...在三个平台上基本一致A-...指的是 AltD-...在 macOS 上是 Command在 Windows 和 Linux 上通常被解释成 Super 或者无效果。写映射的时候如果用了D-...跨平台就会失效。另一个差异是 macOS 上的 Option 键在部分键盘布局下会打出特殊字符A-x这类映射可能触发不了。遇到这种情况只能试试出来哪个能用记下来。我的习惯是所有自定义映射只依赖Ctrl和leader空格这两个在三平台上表现最稳定配置搬过去基本不用改。7.3 远程环境与剪贴板互通在远程开发场景里键盘事件是本地采集、转发过去的所以映射生效的逻辑在远端。这带来一个副作用本地系统的一些全局快捷键会先被拦掉键根本到不了远端编辑器。典型的受害者是CtrlW有些系统的窗口管理会优先响应。剪贴板是另一个高频问题。Vim 默认的y和p走自己的寄存器和系统剪贴板不互通复制一段代码粘到聊天窗口里是空的。想让它们互通打开这一项vim.useSystemClipboard: true代价是每次y都会覆盖系统剪贴板如果你习惯用系统剪贴板暂存别的东西会被打断。我自己的折中方案是保持默认不互通需要往外部粘贴时用编辑器的CtrlC两边各管各的反而清晰。8. 两周上手路线与常见退化点快捷键表看一遍不会变成肌肉记忆这一点必须承认。我见过很多人把速查表打印出来贴在显示器边上两周之后表格还在手还是用鼠标。问题不在于记不住在于练的顺序不对——一上来就学全套结果每个都用不利索遇到稍微复杂的操作就退回鼠标因为鼠标至少能保证完成。8.1 分阶段练什么、不练什么我的建议是把两周切成三段每段只解决一个层次的肌肉记忆其他全部允许用鼠标不给自己压力。第一段第 1 到 4 天只练移动。hjkl、w b e、0 ^ $、gg G、CtrlD CtrlU。这一阶段明确禁用方向键其他操作删除、复制、保存想用鼠标就用鼠标。目标是在任何位置都能不看键盘把光标挪到想去的地方。第二段第 5 到 10 天上操作符和文本对象。ddyyp打底然后ciwdi(ciyap这四个反复练。这一阶段允许用鼠标定位但删除和复制必须用组合键完成。目标是把删一个词从选中再删变成ciw的直接反应。第三段第 11 到 14 天把编辑器操作接管过来。CtrlW系列、:命令、gdgr、自定义 leader 映射。这一阶段重点不是学新键是把前两段学到的东西串进真实工作流里——读代码用gd跳、改代码用ciw、切文件用:b、分屏用CtrlW v。每段结束后回头看一次哪些动作还在下意识找鼠标就单独拿出来多练十遍。这个回看环节比多学十个新键有用得多。8.2 三个最容易让人退回鼠标的瞬间第一个是要大范围选中一段不确定边界的代码。这时候文本对象失效可视模式又要靠眼睛找起止点很多人就顺手拖鼠标了。我的处理办法是先找锚点如果这段代码在括号里vi{一把选中如果是一整段vap如果什么结构都没有先按V选行再用jk调整边界。可视模式下是可以继续用移动键扩选的这一点新手常常忘。第二个是要改的地方在屏幕外得先滚过去看看。这时候容易去摸滚轮。替代方案是CtrlD翻半页扫一眼CtrlO回来改完CtrlI再确认一遍。整个来回不用离开键盘。第三个是不小心按错了状态乱了不知道自己在哪个模式。这时候不要瞎按Esc连按两次一定能回到 Normal 模式然后u撤销误操作。养成状态不确定就按两次 Esc的习惯能省掉大量怎么又打出一串奇怪字符的困惑。真正让我把 Vim 模式用下来的其实不是哪条快捷键特别神而是某一天发现自己改一行代码的整个流程——跳过去、定位、改、回来、保存——手一次都没有离开主键区。那天之后再用手拖选光标会有明显的别扭感。如果你练到两周还没这个感觉多半是某一段的练习被跳过了回去补那一段比继续往前学新键有用。