vscode插件安装后没反应，核心原因是未启用、激活事件未触发或被快捷键/设置冲突抑制；必须确认启用状态、打开匹配文件类型、禁用esc劫持命令，并验证vimstate是否存在。
装完插件没反应？不是配置错了，是VSCode根本没把焦点交给Vim状态机——必须打开真实文件、禁用冲突插件、确认启用状态，三者缺一不可。
插件装了但Esc不退出插入模式
这不是插件坏了，是VSCode原生快捷键劫持了Esc。默认workbench.action.showCommands和workbench.action.terminal.toggleTerminal都绑定了Esc，直接吞掉Vim监听。
- 打开快捷键设置：
Cmd+K Cmd+S（macOS）或Ctrl+K Ctrl+S（Windows/Linux） - 搜索
escape，找到上述两条命令，右键「删除键绑定」 - 同时检查设置里
vim.useCtrlKeys是否为true（某些远程开发环境默认false） - 别在空标签页或设置页测试——必须打开
index.js这类真实文件，且光标要落在编辑器内
复制粘贴和系统剪贴板不通
y复制后p粘不出，或者外部复制的内容p不出来，90%是因为剪贴板没打通。
- 在
settings.json中加这一行："vim.useSystemClipboard": true - 如果用了WSL或Remote-SSH，还要确保
DISPLAY或X11转发正常，否则unnamedplus行为不可用 - 别依赖
.vimrc里的set clipboard=unnamedplus——vscodevim不解析这行，它只认自己的配置项
想用jj代替Esc却按了没反应
这个映射不能靠UI设置完成，必须进keybindings.json手动写，而且when条件漏一个字就失效。
- 执行
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说明插件压根没加载
自定义nnoremap映射不生效
vscodevim不读.vimrc，所有nnoremap都得转成JSON格式，且语法不兼容原生vimscript。
- 用
vim.normalModeKeyBindingsNonRecursive字段，避免递归展开引发意外 -
before里填按键序列，比如[" ", "f", "f"]对应<space>ff</space>，不能写"<space>ff"</space> -
commands只能填VSCode命令ID（如"workbench.action.files.newUntitledFile"）或扩展命令（如"extension.vim_noHighlight"），不支持:nohlsearch这种Ex命令 - Leader键慎用
\——中文输入法下常被吞，改用,或space更稳，对应配置是"vim.leader": ","
最常被忽略的点：Vim模式不是“装完即用”，它是基于编辑器焦点和插件初始化状态的双重判断。状态栏没显示-- NORMAL --，先别调配置，去控制台看vimState是否存在——不存在，说明插件根本没跑起来，所有后续配置都是白搭。
