VSCode快捷键映射插件不能仅靠插件名离线安装，必须使用准确ID（如vscodevim.vim）和对应.vsix文件，配合keybindings.json手动迁移才能完整生效。
快捷键映射插件不能靠“插件名”离线安装
VSCode 里没有叫「快捷键映射插件」的独立扩展——所有快捷键行为都由 keybindings.json 文件控制，或由某些语言/功能类插件附带（如 vim、emacs-plus、intellij-idea-keybindings）。这些插件本身仍是普通扩展，必须用 ID 安装，不能只写“Vim”或“Emacs”。
常见错误：在新电脑上运行 code --install-extension Vim → 报错 Extension 'Vim' not found in the marketplace。因为真实 ID 是 vscodevim.vim（注意大小写和点号）。
- 查 ID 的唯一可靠方式：在旧电脑打开 VSCode，执行
code --list-extensions --show-versions，从输出中找对应行 - 若旧电脑已不可用，去插件市场页面（如 vscodevim.vim）URL 末尾的
itemName=xxx就是 ID - 含空格或特殊字符的 ID（如
johnstoncode.svn-scm）必须原样复制，不能删减或改大小写
离线安装 vim/emacs 等键位插件必须带 .vsix 文件
仅靠 code --install-extension vscoevim.vim 在无网时大概率失败：VSCode 会尝试联网校验签名、拉取更新、甚至下载配套 LSP 二进制（如 vim 插件依赖的 node 模块），卡住或静默跳过。
真正离线可用的方式是提前下载好 .vsix 文件：
- 在外网机器访问插件市场页 → 点击右侧
Download Extension→ 得到vscodevim.vim-1.24.5.vsix这类文件 - 把
.vsix拷到内网机，用 GUI 安装：VSCode 扩展面板右上角 ⋯ →Install from VSIX... - 或命令行安装（需绝对路径）：
code --install-extension "/path/to/vscodevim.vim-1.24.5.vsix" --force - 安装后务必手动点击启用（扩展面板里点「启用」按钮），否则快捷键不生效
keybindings.json 才是快捷键的最终载体
即使你成功离线装了 vscodevim.vim，它默认只提供基础 Vim 键位；你自定义的 Esc 映射 :q、jj 退出插入模式等，全存在 keybindings.json 里，跟插件无关。
这个文件才是你「快捷键配置」的完整备份，必须单独迁移：
- 路径：Windows 是
%APPDATA%\Code\User\keybindings.json，macOS 是~/Library/Application Support/Code/User/keybindings.json，Linux 是~/.config/Code/User/keybindings.json - 直接复制该文件到新电脑同路径下，VSCode 会热重载，无需重启
- 别用 Settings Sync 或插件导出命令替代——它们不保证同步全部自定义键位，尤其涉及条件匹配（
when字段）或非标准作用域的映射
native 插件（如 vim）在离线环境容易加载失败
像 vscodevim.vim 这类重度依赖 Node.js 运行时和 native 模块的插件，在离线时可能报 Cannot find module 'oniguruma' 或启动后无响应——不是安装失败，而是运行时缺依赖。
根本原因：VSCode 内置的 Electron/Node 版本与插件编译时目标版本不一致，且离线无法自动下载预编译二进制。
- 解决方案一：用旧电脑导出插件时加
--show-versions，确保新电脑安装**完全相同版本**的.vsix - 解决方案二：安装前关闭自动更新：
"extensions.autoCheckUpdates": false（写入settings.json） - 验证是否真生效：打开命令面板（
Ctrl+Shift+P），输入Vim:看是否有命令补全；进入编辑器按Esc看是否切换到 Normal 模式
最易被忽略的一点：快捷键冲突不报错。比如你装了 vim 插件又保留了原生的 Ctrl+P（快速打开），两者会同时注册，实际生效的是后加载的那个——这种问题只能靠手动测试，没法靠日志发现。
