先确认插件已启用、打开真实文件并聚焦编辑器，状态栏显示-- normal --才算vim.mode激活；否则需重载窗口、禁用冲突插件，并配置vim.usesystemclipboard和keybindings.json中jj映射。
插件装完按 Esc 没反应？先确认 vim.mode 是否真激活
VSCode 安装 vscodevim.vim 后，默认只是「安装」，不是「启用」——它不会自动接管编辑器输入流。你按 Esc 没反应、hjkl 输成字符，大概率是模式根本没起来。
- 打开扩展面板（
Ctrl+Shift+X），搜Vim，确认vscodevim.vim状态是「已启用」（不是灰色的「已安装」） - 不能在空标签页、设置页、输出面板里测试；必须打开一个真实文件（如
index.js），且光标落在编辑器内容区 - 按
Esc后看状态栏左下角：出现-- NORMAL --才算成功；若仍是-- INSERT --或无提示，说明状态机没加载 - 执行
Ctrl+Shift+P→ 输入Developer: Reload Window回车，某些远程环境或旧版本需重载才能触发初始化 - 禁用其他键盘映射插件（如
Emacs Keymap、Sublime Text Keymap），它们会劫持Ctrl+Shift+P等关键组合，导致 Vim 初始化失败
y/p 复制粘贴失效？缺 vim.useSystemClipboard
y 复制后 Ctrl+V 粘不到终端或浏览器，外部复制的内容 p 也粘不出来——这不是 bug，是默认行为：VSCode-Vim 默认只用内部寄存器（以 " 开头），不走系统剪贴板。
- 在
settings.json中加这一行："vim.useSystemClipboard": true（必须写进 JSON，GUI 设置界面改无效） - macOS 用户额外注意：需在「系统设置 → 隐私与安全性 → 辅助功能」中给 VSCode 打开权限，否则仍无效
- Windows/Linux 若用 WSL 或 Remote-SSH，要确保
DISPLAY或 X11 转发正常，否则unnamedplus行为不可用 - 别指望
.vimrc里的set clipboard=unnamedplus生效——vscodevim不解析这行，只认自己的配置项
想用 jj 退出插入模式？必须手写 keybindings.json
jj 或 jk 退出插入模式不是开箱即用的功能，VSCode-Vim 插件靠 extension.vim_escape 命令 + 精确条件监听实现，UI 设置完全无法配置。
- 执行
Ctrl+Shift+P→ 输入Preferences: Open Keyboard Shortcuts (JSON)打开keybindings.json - 在数组里添加（注意逗号分隔）：
{ "key":"j j", "command":"extension.vim_escape", "when":"editorTextFocus && vim.mode == 'InsertMode'" } -
when条件必须严格匹配：vim.mode == 'InsertMode'，不能写成'insert'或'-- INSERT --' - 别漏掉
editorTextFocus，否则在非编辑器区域（比如侧边栏）按jj也会触发 - 保存即生效，不用重启；若无效，在开发者控制台输
console.log(vimState)，报ReferenceError说明插件压根没加载
要不要全局开启 Vim 模式？按语言 ID 单独启用更安全
全局开启 "vim.enable": true 容易误操作：在 .json 里按 dd 删整行，或在 .md 里按 i 却跳进插入模式打断写作流。
- 先关全局：
"vim.enable": false - 再为具体语言启用，语法必须严格：
"[javascript]": {"vim.enable": true },<br>"[typescript]": {"vim.enable": true },<br>"[python]": {"vim.enable": true } - 语言 ID 必须小写，且和 VSCode 内部识别一致；不确定时，
Ctrl+Shift+P→Developer: Inspect Editor Tokens and Scopes可查当前语言 ID - 别在
settings.json里混用大小写或多余空格，JSON 解析失败会导致整个 Vim 配置静默失效
真正卡住人的地方，往往不是“怎么配”，而是“配了但没生效”——状态栏没显示 -- NORMAL -- 就动手改配置，或者把 vim.useSystemClipboard 写进 GUI 设置里，结果全白忙。先验证基础状态，再动配置，比反复试错快得多。
