vscode无法将vim或neovim作为底层编辑器使用，其vim插件（vscodevim）仅为纯javascript按键模拟层，不加载vimrc、不运行vim/nvim进程、不支持:command和lua；启用vim.enableneovim:true后仅能桥接neovim进程处理部分文本操作，ui与调试仍由vscode负责。
VSCode 不能把 Vim 或 Neovim 当成“底层”来用——它最多桥接 Neovim 进程，但 Vim 本身完全不支持这种集成。所谓“Vim 作为底层”是常见误解；VSCode 的 Vim 插件（vscodevim）纯 JS 实现，不加载 vimrc、不运行 vim 进程、也不支持 :command 或 Lua。只有启用 vim.enableNeovim: true 后，才可能让 VSCode 前端把部分操作转发给本地 Neovim 实例处理。
VSCode 装的是 Vim 插件，不是 Vim 编辑器
你安装的 “Vim” 扩展（作者 vscodevim）只是按键模拟层：它监听键盘、切换模式、复现 ciw、zz 等语义，但所有逻辑都在 VSCode 渲染进程里跑。它不会读取你的 ~/.vimrc，也不会执行 :terminal 或 :lua。如果你按 :Telescope 报错 E492: Not an editor command，这不是配置漏了，是根本没这能力。
常见错误现象：
- 按
Esc没反应 → 其实是输入法/远程桌面/键盘固件吞了事件，不是插件失效 -
:w报command not found→ 正常，插件只认它自己注册的命令（如extension.vim_noHighlight） - 自定义
nnoremap <space> :nohlsearch<cr></cr></space>不生效 → 因为插件不解析 vimscript，必须转成 JSON 格式
想用 Neovim 做实际后端？路径和版本必须严格对齐
启用 vim.enableNeovim: true 后，VSCode 会尝试启动你指定路径的 neovim 可执行文件，并通过 MessagePack-RPC 通信。但这不是“替换编辑器”，而是让 Neovim 处理部分文本操作（比如寄存器、gq 格式化、LSP 调用），VSCode 仍负责 UI、文件管理、调试等。
关键条件：
- 必须安装 Neovim 0.10 或更高版本（旧版不兼容 RPC 协议）
-
vim.neovimPath必须指向可执行文件，不是目录（例如 Linux 是/usr/bin/nvim，不是/usr/bin/neovim） - 路径错误时插件静默回退到内置模拟器，不会报错，但
init.lua里的vim.keymap.set完全不生效 - Neovim 的
init.lua中定义的用户命令（如:FormatCurrent）需显式暴露给 VSCode，靠vim.api.nvim_create_user_command注册
自定义键绑定必须分清模式和递归性
VSCode Vim 插件提供两套绑定入口：vim.normalModeKeyBindings（递归）和 vim.normalModeKeyBindingsNonRecursive（非递归）。选错会导致行为失控。
使用场景与区别：
- 映射保存+关闭：用
NonRecursive，避免workbench.action.files.save返回值被二次解析成新按键流 - 实现
gl→`→'多跳逻辑：必须用normalModeKeyBindings（递归），否则第二步不触发 -
before数组必须是连续击键，中间不能有延迟；写["j","j"]就无法再输入两个 j 字符 - 组合键写法必须用 VSCode 规范：
"ctrl+shift+p"，不能写<c-p></c-p>
Leader 键失效？大概率是输入法或系统级拦截
vim.leader 默认设为 \，但它在中文输入法下几乎必被吞，在 macOS 上还和 Spotlight 冲突。这不是配置问题，是平台限制。
更稳的选择：
- 设为
,：几乎所有输入法都放行，且远离主键区不易误触 - 设为
space：需配合vim.handleKeys显式放开（"<space>": false</space>），否则 VSCode 原生快捷键会劫持 - 绝对不要用
ctrl+[当 leader——它和Esc同义，只能用于退出插入模式，不能当前缀键
复杂点在于：一旦启用 Neovim 桥接，leader 键行为就由两端共同决定——VSCode 控制是否捕获，Neovim 控制后续映射是否加载。若 init.lua 里写了 vim.keymap.set('n', ',w', ':w<cr>')</cr>，但 VSCode 没把 , 传过去，整条链就断了。这种跨层协同，调试时得两边日志一起看。
