VSCode 中文输入法下 Esc 失效，主因是 VSCode 自身劫持了 Esc 键绑定，需在快捷键设置中删除 workbench.action.showCommands 等绑定，并确保 vim.useCtrlKeys 和 vim.useSystemClipboard 为 true，且在真实代码文件中测试；jj/jk 退出插入模式需在 settings.json 中配置 vim.insertModeKeyBindings；Ctrl+C/V 乱跳应通过 vim.handleKeys 精准放行并补充 Normal 模式复制绑定；剪贴板同步必须设 vim.useSystemClipboard: true，不支持 .vimrc 的 set clipboard；macOS 需关闭 ApplePressAndHoldEnabled 并授权辅助功能，WSL/Remote-SSH 需 DISPLAY 或 x11 转发；命令面板焦点被劫持时，推荐用 Ctrl+[ 退出。
Esc 按下没反应？先查 VSCode 自己劫持了它
中文输入法下 Esc 失效，90% 不是插件问题，而是 VSCode 把 Esc 绑给了 workbench.action.showCommands 或 workbench.action.terminal.toggleTerminal。输入法激活时更敏感，连带导致 Vim 模式收不到退出信号。
打开快捷键设置：Ctrl+K Ctrl+S（Windows/Linux）或 Cmd+K Cmd+S（macOS），搜索 escape，找到对应命令条目，右键 →「删除键绑定」。
确认 vim.useCtrlKeys 为 true（新版默认开启，但 Remote-SSH 或 WSL 环境常为 false）；vim.useSystemClipboard 也建议设为 true，否则后续复制粘贴会断链。
别在空文件、设置页、输出面板里测试——Vim 模式只在真实代码文件的编辑器区域生效，且光标必须落在文本内容中。
中文输入法下 jj/jk 退出插入模式总失效？JSON 配置不能少一个字符
中文输入法启用时，jj 或 jk 映射容易被吞掉或延迟响应，根本原因是插件监听的是插入模式下的按键序列，不是普通快捷键，UI 设置无法覆盖。
必须在 settings.json 中添加：
"vim.insertModeKeyBindings": [
{
"before": ["j", "j"],
"after": ["<esc>"]
},
{
"before": ["j", "k"],
"after": ["<esc>"]
}
]注意：before 是字符串数组，每个按键单独一项；<esc> 必须用英文尖括号和小写 esc，不能写成 Esc、escape 或 <ESC>；配置只在插入模式触发，不影响正常打字，但若你高频输入 jj（如写 Python 注释 # jj），会有约 150ms 延迟。
如果仍无效，打开命令面板 Ctrl+Shift+P → 输入 Developer: Toggle Developer Tools，在控制台执行 console.log(vimState)。报 ReferenceError 说明插件根本没加载，所有映射都是白搭。
Ctrl+C/V 在中文输入法下乱跳？别让 vim.handleKeys 全盘接管
默认开启 vim.useCtrlKeys 后，Ctrl+C 在 Normal 模式下不复制，而是进可视模式；Ctrl+V 也不块选，而是触发寄存器粘贴——这在中文输入法下极易误触发，比如想切回英文却按出 Ctrl+V，光标瞬间跳到行首。
推荐做法是精准放行：
- 在
settings.json中设"vim.handleKeys": { "<c-c>": false, "<c-v>": false, "<c-s>": false } - 再单独加一条 Normal 模式下的复制绑定：
{"key": "ctrl+c", "command": "editor.action.clipboardCopyAction", "when": "editorTextFocus && vim.mode == 'Normal'"} -
Ctrl+Z和Ctrl+Y始终由 VSCode 管理，无需、也不能交给 vim 插件
特别注意：macOS 用户还需关闭系统级按键重复，否则 Esc 长按会反复触发，干扰模式切换。终端执行：defaults write com.microsoft.VSCode ApplePressAndHoldEnabled -bool false，重启 VSCode 生效。
剪贴板不同步、y/p 粘不出外部内容？别信 .vimrc 里的 set clipboard
VSCode-Vim 插件**完全不解析** ~/.vimrc 中的 set clipboard=unnamedplus。你在里面写了这行，对 y/p 行为毫无影响。
正确路径只有两条：
- 直接在
settings.json中加"vim.useSystemClipboard": true（最简单，推荐） - 或启用
vim.vimrc.enable，再配合插件支持的极少数.vimrc指令（但clipboard不在其中）
macOS 上必须确保 VSCode 已获「辅助功能」权限（系统设置 → 隐私与安全性 → 辅助功能），否则 useSystemClipboard 会静默失败；WSL/Remote-SSH 环境则需确认 DISPLAY 正常或启用 x11 转发，不然剪贴板同步不可用。
最后提醒：中文输入法下，Ctrl+Shift+P 呼出命令面板时，焦点可能被输入法框劫持，导致 Esc 无法回落到 Vim 模式。此时最稳的退出方式是连按两次 Ctrl+[，比单次 Esc 更可靠。
