VSCode Vim扩展生效需三步验证：Reload Window后状态栏显示--NORMAL--；执行console.log(vimState)不报错；禁用方向键并确保vim.useCtrlKeys和vim.handleKeys正确配置。
VSCode装上Vim扩展后，hjkl移动、ciw改词、dd删行这些操作确实能显著减少手离开主键盘区的次数，但“打字速度提升”不是自动发生的——它依赖你是否关掉了方向键、是否禁用了冲突快捷键、是否让Esc真正退出插入模式。否则只是多了一层按键映射，反而拖慢节奏。
确认 Vim 扩展已正确加载并接管输入逻辑
很多人装完就以为万事大吉，结果按hjkl没反应，或Esc退不出插入模式。这不是插件坏了，而是状态没激活：
- 安装后必须执行
Reload Window（Cmd+Shift+P → 输入并运行），不能只重启 VSCode； - 打开任意文件后，看状态栏左下角是否显示
-- NORMAL --或INSERT，这是唯一可信的生效标志； - 如果显示的是
Normal（首字母小写）或根本没显示，说明插件未初始化，大概率是和其他键位扩展（如 Emacs Keymap、Sublime Text Keymap）冲突； - 在 DevTools Console 里执行
console.log(vimState)，若报ReferenceError，就证实 Vim 扩展根本没挂载成功。
关闭方向键 + 强制 Esc 退出插入模式
方向键不关，hjkl就永远只是“备选”，肌肉记忆无法建立。而Esc失效，则会让你频繁用鼠标点编辑器外再点回来——这是效率杀手：
- 在
settings.json中添加："vim.useCtrlKeys": true（启用 Ctrl 组合键支持）； - 添加：
"vim.handleKeys": { "<up>": false, "<down>": false, "<left>": false, "<right>": false }</right></left></down></up>，显式禁用方向键； - 确保没有其他扩展（比如某些终端模拟器插件）劫持了
Esc键； - 如果仍需偶尔用方向键（比如调试时看控制台），不要全局禁用，改用
vim.normalModeKeyBindingsNonRecursive映射临时替代方案，例如把Ctrl+h/j/k/l绑定为方向移动。
同步系统剪贴板与避免 Ctrl+C 冲突
Vim 用户习惯 y 复制、p 粘贴，但如果 Ctrl+C 在 Normal 模式下仍触发“中断命令”，你就没法在终端或 Git 提交时用它复制错误信息——这会倒逼你切回鼠标右键菜单。
- 必须开启：
"vim.useSystemClipboard": true，否则y和p只在 VSCode 内部生效； - 在
keybindings.json中加一条明确规则：{"key":"ctrl+c","command":"editor.action.clipboardCopyAction","when":"editorTextFocus && vim.mode == 'Normal'"}； - 同理处理
Ctrl+V：绑定editor.action.clipboardPasteAction，但注意别和 Visual Block 模式（Ctrl+v）冲突——大小写要严格区分； - 如果发现
Ctrl+C在终端里失灵，检查terminal.integrated.commandsToSkipShell是否漏掉了该快捷键。
别急着配 .vimrc，先验证基础操作流是否闭环
看到别人用 ysiw" 包单词、ci( 改括号内容，就想立刻抄 .vimrc 配置。但 VSCode Vim 扩展对 .vimrc 的支持是有限子集，很多原生 Vim 命令（如 :s///g 全局替换）默认不启用，强行导入会导致部分映射失效或静默忽略。
- 先只开最稳的三个选项：
"vim.surround": true、"vim.textobjects": true、"vim.easymotion": true； -
vim.enableNeovim设为false（默认值），除非你本地真装了 Neovim 并配置好路径； - 想复用
.vimrc？先确认vim.vimrc.enable已设为true，再检查~/.vimrc里有没有set nocompatible这类 VSCode 不识别的指令； - 最常被忽略的一点：VSCode Vim 对
autocmd和function完全不支持，所有依赖它们的插件（如NERDTree）在 VSCode 里无效。
真正卡住多数人的，从来不是“怎么配”，而是“为什么配了没反应”。重点盯住状态栏模式标识、vimState 是否存在、方向键是否被彻底禁用——这三个点没过，后面所有高级功能都是空中楼阁。
