离线安装 VSCode 的 Vim/Emacs 插件需用联网机器通过 VSCode 内置市场右键“Download Extension VSIX”获取匹配版本，不可从网页下载或手动拼 URL，否则易版本不兼容导致激活失败。
离线安装 VSCode 的 Vim 或 Emacs 键位映射插件（如 vscodevim.vim、lunarwatcher.emacs）和其他插件没本质区别，但这类插件对启动顺序、依赖和首次启用行为更敏感——装完不生效、快捷键没反应、甚至卡在“Activating…”，八成不是插件坏了，而是离线环境下没过掉几个关键检查点。
怎么下载 vim/emacs 插件的 .vsix 文件
必须用有网络的机器提前下载，且优先选官方推荐方式：打开 VSCode → Ctrl+Shift+X → 搜索 vim 或 emacs → 找到 vscodevim.vim（Star 最高、维护最活跃）或 lunarwatcher.emacs → 右键 → 选择 Download Extension VSIX。这个操作会自动下载匹配你当前 VSCode 版本的最新兼容版。
别去 Marketplace 网页找“Download”按钮——它早在 2024 年底就已移除；也别手动拼 URL，容易下错版本或被重定向到无效路径。
如果右键没出现该选项，说明你用的是旧版 VSCode（vsce：vsce package vscodevim.vim（需提前 npm install -g vsce）。
拖拽安装后快捷键仍不生效？检查这三件事
装完 vscodevim.vim 后按 Esc 没反应，不是插件失效，而是离线环境触发了它的“懒加载”机制：
- 插件默认安装后是禁用状态，必须手动点「启用」或重启 VSCode（仅 reload window 不够）
-
vscodevim.vim依赖ms-vscode.vscode-typescript-next（非强制但影响 TypeScript 文件体验），离线时不会自动装，得一并下载安装 - 首次启用会尝试拉取 Vim 配置 schema 和 help 文档，离线会卡在「Loading vim help…」——此时要关掉设置里的
vim.showHelp和vim.enableNeovim（后者需额外二进制）
code --install-extension 安装失败常见报错及对策
执行 code --install-extension vscodevim.vim-1.27.0.vsix 报错，优先看错误类型：
command not found: code → 在 VSCode 里按 Ctrl+Shift+P 输入 Shell Command: Install 'code' command in PATH 回车；Windows 用户注意路径含空格必须加双引号：code --install-extension "D:\ext\vscodevim.vim-1.27.0.vsix"
INVALID_SIGNATURE → 离线无法连微软证书服务器验签，必须加 --allow-unverified 参数：code --install-extension vscodevim.vim-1.27.0.vsix --allow-unverified
Extension is not compatible with Code → 用压缩工具打开 .vsix，解压看 extension/package.json 里的 engines.vscode 字段，比如 "^1.85.0" 就不能装在 1.82 上；要么降级插件，要么升级 VSCode
为什么装了 vim 插件，但 .py 文件里还是不能用 ci"？
因为 vscodevim.vim 对不同语言的支持是分层激活的：基础移动（hjkl）开箱即用，但文本对象（ci"、dat）和操作符待命（c、d）需要对应语言扩展提供 AST 支持。离线时，ms-python.python 插件若未装或未启用，Vim 插件就收不到 Python 语法树，ci" 会退化为普通字符删除。
所以离线部署 Python + Vim 组合，至少要打包三个 .vsix：ms-python.python、ms-python.pylance（强依赖）、vscodevim.vim，且安装顺序无关，但启用顺序建议先启语言服务，再启 Vim。
真正麻烦的不是“装不上”，而是“装上了却以为没装上”——Vim 插件在离线环境里不报错、不弹窗，只默默降级功能，这点特别容易被忽略。
