VSCode Vim插件失效主因是未进入工作状态：必须打开真实文件、删除Esc冲突绑定、启用vim.useSystemClipboard，三者缺一不可；jj/jk退出需在keybindings.json中配置extension.vim_escape命令并限定InsertMode条件。
VSCode Vim插件装完不能用，90%不是配置问题，而是根本没进 Vim 的工作状态——必须打开真实文件、禁用 Esc 冲突绑定、确认系统剪贴板打通，三者缺一不可。
Esc 按了没反应？先查快捷键劫持
VSCode 默认把 Esc 绑给 workbench.action.showCommands 和 workbench.action.terminal.toggleTerminal，直接吞掉 Vim 插件监听。这不是插件没加载，是按键在进 Vim 之前就被截断了。
- 打开快捷键设置：
Ctrl+K Ctrl+S（Windows/Linux）或Cmd+K Cmd+S（macOS） - 搜索
escape，找到上述两条命令，右键 →「删除键绑定」 - 检查
vim.useCtrlKeys是否为true（远程开发环境常默认false） - 执行
Developer: Reload Window，不用重启整个 VSCode
jj 或 jk 退出插入模式怎么配？必须写进 keybindings.json
这个映射不是普通快捷键，而是插入模式下的按键序列监听，UI 设置界面无法生效，也不能放在 settings.json 的 vim.insertModeKeyBindings 里——那个字段只对 vim 插件内部命令有效，而 extension.vim_escape 是扩展级命令，必须走 VSCode 原生快捷键机制。
- 执行
Preferences: Open Keyboard Shortcuts (JSON) - 在数组里加这段（注意逗号分隔和大小写）：
{
"key": "j j",
"command": "extension.vim_escape",
"when": "editorTextFocus && vim.mode == 'InsertMode'"
}vim.mode == 'InsertMode' 不能写成 'insert' 或 '-- INSERT --'，字符串值必须完全匹配console.log(vimState)，报 ReferenceError 说明插件压根没加载复制粘贴不走系统剪贴板？vim.useSystemClipboard 必须开
y 复制后 Ctrl+V 粘不到浏览器，外部复制的内容 p 不出来——这是默认行为，不是 bug。VSCode-Vim 默认用内部寄存器（" 开头），和系统剪贴板物理隔离。
- 在
settings.json中加："vim.useSystemClipboard": true - macOS 用户：必须在「系统设置 → 隐私与安全性 → 辅助功能」里给 VSCode 手动授权
- WSL/Remote-SSH 场景：确保
DISPLAY或 X11 转发正常，否则unnamedplus行为不可用 -
.vimrc里的set clipboard=unnamedplus对 vscodevim 完全无效，它不解析这行
自定义 nnoremap 不生效？别指望它读 .vimrc
vscodevim 不运行 vim 进程，也不加载 .vimrc，所有原生 vimscript 映射（包括 nnoremap、inoremap）必须手动转成 JSON 格式，且语法不兼容。
- 用
vim.normalModeKeyBindingsNonRecursive字段，避免递归展开引发意外行为 -
before是按键数组，比如[" ", "f", "f"]，不能写成"<space>ff"</space> -
commands只能填 VSCode 命令 ID（如"workbench.action.files.newUntitledFile"）或扩展命令（如"extension.vim_noHighlight"），不支持:nohlsearch这类 Ex 命令 -
leader键慎用\—— 中文输入法下常被吞，改用,或space更稳，对应配置是"vim.leader": ","
真正卡住的点往往不在配置本身，而在模式是否激活、焦点是否落在编辑器内容区、以及系统级权限是否到位——尤其是 macOS 的辅助功能授权和 WSL 的剪贴板桥接，这些环节一旦漏掉，再精细的键位映射也出不来效果。
