离线安装后插件“已安装”但没反应，90%是vscode静默卡在版本校验、lsp未加载或activationevents未触发；需比对code --version与vsix中engines.vscode版本、完整拷贝含native二进制的插件目录、并新建对应语言文件手动激活。
离线安装后插件“已安装”但没反应，90% 不是插件坏了，而是 VSCode 在静默加载阶段卡在版本校验、LSP 启动或依赖路径上——它不报错，只挂起或禁用。
检查 engines.vscode 版本是否匹配
VSCode 不兼容时不会弹窗提示，只会拒绝加载。必须手动比对本地版本与插件声明的最低要求：
- 运行
code --version，取前两位（如1.92.2→1.92） - 解压
.vsix：用unzip -p your.vsix extension/package.json | grep engines查看"vscode": "^1.93.0" - 本地版本必须 ≥ 插件要求的最小值；差一个小版本（如
1.92vs^1.93.0）就会静默跳过 - Help → About 里确认架构（
x64/arm64），M 系列 Mac 装 x64 插件会功能缺失，不是报错
语言类插件首次启用卡住？缺的是 LSP 目录，不是 .vsix 文件
装完 ms-python.python 或 Vue Language Features (Volar) 后没语法提示，大概率是语言服务器（pyright、volar-server）根本没加载——离线时下载环节被跳过，且无任何提示。
- 在有网机器上打开一个
.py或.vue文件并保存一次，等状态栏不再显示 “Downloading…” - 找到完整插件目录：
$HOME/.vscode/extensions/ms-python.python-2024.6.0/（Linux/macOS）或%USERPROFILE%\.vscode\extensions\ms-python.python-2024.6.0\（Windows） - 整文件夹拷贝到内网机对应路径，**不能只拷
.vsix，也不能只拷node_modules** —— native 二进制（如out/server/pyright）藏在子目录里 - 彻底退出 VSCode（任务管理器中确认无
Code Helper进程），再启动
code --install-extension 报错或没反应？CLI 命令根本没注册
command not found 不是网络问题，是 code 命令未写入系统 PATH。官方 .deb/.rpm 和 macOS ZIP 版默认不配置它。
- 先运行
which code：无输出 = 命令不可见 - 临时解决：用绝对路径，如
/Applications/Visual Studio Code.app/Contents/Resources/app/bin/code --install-extension /path/to/xxx.vsix（macOS） - 永久修复：VSCode 中按
Ctrl+Shift+P→ 输入Shell Command: Install 'code' command in PATH→ 回车 → 重启终端 - 别加
sudo：否则插件装到 root 用户目录，普通用户启动后看不到
插件列表里显示“已安装”但灰色不可用？activationEvents 没触发
很多插件（尤其是语言类）默认只在打开特定文件类型时才激活，空窗口或纯文本标签页下它就是灰色的，不是故障。
- 打开命令面板（
Ctrl+Shift+P），运行Developer: Toggle Developer Tools，切到 Console 标签页，刷新后看是否有Activating extension 'xxx' failed - 查插件详情页的
Activation Events字段（点插件右上角 ⓘ），常见值如onLanguage:python、onCommand:extension.format - 手动触发：新建
test.py并保存，或运行插件声明的命令（如Format Document） - 若报
Cannot find module，说明.vsix内部缺失node_modules—— 用unzip -l xxx.vsix | grep node_modules验证
真正难排查的从来不是“装没装上”，而是“为什么没启动”。VSCode 的静默机制会让所有失败都消失在日志深处，而最有效的验证方式永远是：关掉所有 VSCode 进程，清空对应插件目录，用完整离线包重来一遍。
