VSCode Vim插件不生效，先确认三件事：确保处于普通模式、安装的是vscodevim官方插件、关闭其他键盘映射插件并重启VSCode。
VSCode Vim 插件装不上或装完没反应？先确认这三件事
插件不生效，大概率不是配置问题，而是基础环境没对齐。VSCode 的 Vim 插件（由 vscodevim 官方维护）依赖编辑器本身处于“普通模式”才能触发按键映射——如果你一打开文件就自动在插入模式，hjkl 会直接输入字符，根本不会移动光标。
常见错误现象：Esc 按了没反应、:w 报错 command not found、自定义的 nnoremap 完全不触发。
- 确保已安装的是
Vim插件（作者：vscodevim），不是vscode-neovim或其他仿 Vim 的轻量替代品 - 关闭所有其他键盘映射类插件（比如
Emacs Keymap、Sublime Text Keymap），它们会劫持按键事件 - 重启 VSCode —— 插件启用后必须重启才加载 Vim 模式状态机，热重载不保证模式切换逻辑完整
怎么让 VSCode 读取你本地的 .vimrc 文件
VSCode Vim 插件默认不读 .vimrc，它只认自己的配置项。想复用原有映射，得手动桥接。最可靠的方式是把关键映射转成插件支持的 JSON 格式，而不是指望它自动解析 vimscript。
使用场景：你有一堆习惯的 nnoremap j gj、inoremap jj <esc></esc>，不想重学一套配置语法。
-
"vim.normalModeKeyBindingsNonRecursive"对应nnoremap，推荐用这个，避免递归展开导致意外行为 - 键名必须用 VSCode 的按键标识符，比如
"key"填"j"，但组合键要写成"ctrl+shift+p"，不能用<C-p> - 命令值填 VSCode 内置命令 ID（如
"editor.action.insertLineAfter"）或 Vim 插件扩展的命令（如"vim.remap"），不支持原生 vimscript 函数调用
示例：把 nnoremap <space> :nohlsearch<CR> 转成：
"vim.normalModeKeyBindingsNonRecursive": [
{
"before": [" "],
"commands": ["extension.vim_noHighlight"]
}
]
leader 键失效或被系统/输入法吞掉？换一个更稳的键
VSCode 默认把 <leader></leader> 映射为 \，但它在中文输入法下常被拦截，在 macOS 上还可能和 Spotlight 冲突。这不是配置写错了，是平台级冲突。
性能影响不大，但兼容性差会导致整套自定义映射瘫痪——尤其当你依赖 <leader>ff</leader> 打开文件搜索时，按了没反应，容易误判为插件故障。
- 改用
,或space更稳妥，它们在几乎所有输入法和系统中都可被捕获 - 修改方式：在
settings.json中加"vim.leader": ","，注意不要加反斜杠 - 如果坚持用
\，Windows 用户需关掉“切换输入法”的快捷键（默认是Alt+Shift，和\组合易冲突）
为什么有些 Vim 命令在 VSCode 里就是不工作？看它到底支不支持
VSCode Vim 插件不是 Neovim 移植版，它只实现了常用子集。像 :terminal、:lua、autocmd 这类重度依赖 Vim runtime 的功能，压根没实现。硬写进配置只会静默失败。
容易踩的坑：照抄 .vimrc 里的 autocmd BufWritePre *.js :call JsPreprocess()，结果保存 JS 文件时什么都没发生——因为插件根本不解析或执行 autocmd。
- 查支持列表最准的方式是看插件 GitHub 的
CONTRIBUTING.md或 issues 里搜关键词，比如搜support :sort - 复杂逻辑建议用 VSCode 原生方式替代：比如用
files.associations关联文件类型，比autocmd更稳定 - 映射到外部命令（如
!git status）基本不可用，插件没提供 shell 环境，这类操作得靠 VSCode 的 Tasks 或 Terminal 面板手动触发
真正难搞的从来不是怎么写映射，而是得时刻记住：你写的不是 Vim 脚本，是在给一个模拟层喂指令。哪条指令能被翻译，哪条会被丢弃，得靠试，别信文档没写全的部分。
