VSCode 的 Vim 模式需安装 vscodevim.vim 扩展才能实现完整功能，原生模式仅支持极简映射；须禁用 keyboardNavigation 和 accessibilitySupport，正确配置 settings.json 中 vim 相关选项，并注意多光标等特性需手动启用。
VSCode 的 Vim 模式不是开箱即用的“真 Vim”，而是通过 Vim 扩展（由 vscodevim 官方维护）模拟的，它支持大部分常用操作，但键绑定、寄存器行为、插件兼容性与原生 Vim 有差异。配置不当会导致 Esc 失效、hjkl 不响应、或粘贴后自动进入插入模式等典型问题。
安装并启用 Vim 扩展
VSCode 自带的“Vim 模式”仅指极简的按键映射（如 Ctrl+Alt+I 切换插入），不能替代扩展。必须安装 vscodevim.vim 扩展：
- 打开扩展视图（
Ctrl+Shift+X），搜索vim，认准发布者为vscodevim - 安装后无需重启，但需确认右下角状态栏出现
VIM标识（默认为-- NORMAL --） - 若未生效，检查是否被其他扩展冲突（如
Emacs Keymap或Sublime Text Keymap）——它们会覆盖hjkl等基础导航
禁用 VSCode 原生键盘导航干扰
VSCode 默认启用 editor.accessibilitySupport 和 keyboardNavigation，会导致 Tab / Shift+Tab 在焦点间跳转而非缩进/反缩进，破坏 Vim 流程：
- 在设置中搜索
keyboard navigation，关闭Editor > Accessibility > Keyboard Navigation - 搜索
accessibility support，设为off（除非你依赖屏幕阅读器） - 否则你会遇到：按
Tab后光标跳到侧边栏，或Ctrl+P搜索框无法用hjkl移动
关键 Vim 模式配置项（settings.json）
纯 GUI 设置界面无法覆盖全部行为，必须编辑 settings.json（Ctrl+, → 右上角打开 JSON 按钮）：
{
"vim.enableNeovim": false,
"vim.useSystemClipboard": true,
"vim.handleKeys": {
"<C-a>": false,
"<C-f>": false,
"<C-b>": false
},
"vim.leader": "<space>",
"vim.hlsearch": true,
"vim.incsearch": true
}说明：
-
"vim.enableNeovim": false—— 开启需本地装 Neovim 且路径正确，否则报错Failed to start Neovim；新手建议关掉 -
"vim.useSystemClipboard": true—— 让"+y/"+p直接读写系统剪贴板，否则复制粘贴仅限 VSCode 内部 -
"vim.handleKeys"中显式设为false的快捷键，会交还给 VSCode 原生处理（例如Ctrl+A全选、Ctrl+F查找） -
"vim.leader"设为<space></space>后，<space>w</space>可触发 VSCode 命令面板（类似原生 Vim 的<leader>w</leader>）
键盘导航实操要点
Vim 模式下，方向键仍可用，但违背“手不离主键区”原则。真正高效的是：
-
h/j/k/l：基础移动（注意：在终端面板或调试控制台中可能失效，因这些区域不走 Vim 扩展逻辑） -
w/b/e：按单词跳转；{/}：按段落跳转（对 Markdown/Python 缩进块有效） -
gg/G：首行/尾行；5G：第 5 行；%：匹配括号（()、[]、{}） - 退出插入模式后，
Ctrl+O可临时执行一个命令模式动作（如Ctrl+O+o换行并插入），避免反复按Esc
容易忽略的是：VSCode 的多光标（Ctrl+D 选词）和列选择（Shift+Alt+↓）在 Vim 模式下默认被禁用，需在 settings.json 中加 "vim.overrideCopy": false 并手动绑定，否则无法混合使用。
