“已安装”不等于可用，需验证命令注册、语言模式切换、状态栏提示、开发者工具无报错；LSP插件须联网首次激活后复制整个目录；依赖插件需通过package.json的extensionDependencies字段逐一安装；版本不匹配或架构不符会导致静默禁用，托盘进程残留会阻碍重载。
插件面板显示“已安装”不等于可用
VSCode 扩展面板里看到插件状态是「已安装」，只是说明 .vsix 文件被解压到了 extensions/ 目录，不代表它能响应命令、提供语法高亮或启动语言服务器。很多用户卡在这一步，反复重装却没查真正入口。
验证必须绕过界面信任，直接看运行时行为：
- 按
Ctrl+Shift+P输入插件注册的命令名（如Python: Select Interpreter），能出现且可执行才算注册成功 - 打开对应类型文件（如
test.py），观察右下角语言模式是否变成Python，不是Plain Text - 检查状态栏是否有插件专属图标或提示（如 Pylance 显示
Ready，而不是Downloading...） - 打开
Developer: Toggle Developer Tools，切到 Console 标签页，刷新后无ERR或Failed to activate extension报错
带 LSP 的插件必须触发一次完整加载
Python、Vue、Rust 等插件的 .vsix 只是前端壳，核心逻辑（pyright-server、volar-server）需首次启用时下载。离线环境下它不会报错，只会静默跳过或卡住。
正确验证方式是：在已联网机器上完成首次激活 → 等状态栏不再闪烁 Downloading → 整个扩展目录（如 ms-python.python-2024.6.0/）复制到离线机 extensions/ 下 → 完全退出 VSCode（含托盘进程）再打开 → 打开 .py 文件，看 Output 面板中 Python 或 Pylance 通道是否有日志输出。
如果 Output 面板里对应通道为空，或报 spawn ENOENT，说明 server 二进制缺失，不是重装 .vsix 能解决的。
依赖插件缺失会导致主插件“半失效”
很多插件不报错，但关键功能消失，根源是隐式依赖没装全。例如 ms-python.python 强依赖 ms-python.pylance，esbenp.prettier-vscode 依赖 bradlc.vscode-tailwindcss（格式化 HTML 时）。
查依赖的唯一可靠方式是解压 .vsix，打开 extension/package.json，找 extensionDependencies 字段。列表里的每个 ID 都得单独下载并安装，顺序无关，但缺一不可。
验证时注意：
-
code --list-extensions输出必须包含所有依赖项 ID，不能只靠扩展面板目视 - 打开
Developer: Show Running Extensions，确认依赖插件状态是Active，不是Inactive - 对 Python 插件，按
Ctrl+Shift+P运行Python: Show Output，看是否列出Pylance日志
路径和版本不匹配会静默降级或禁用
VSCode 对 engines.vscode 版本校验极严。若本地是 1.85.2，而插件 package.json 写的是 "^1.86.0"，它不会报错，而是直接跳过激活，插件面板显示「已安装」但所有功能不可见。
排查步骤：
- 运行
code --version，取前两位（如1.85） - 解压
.vsix，打开extension/package.json，比对engines.vscode值是否 ≤ 本地版本 - 检查 Help → About 中的架构（
x64/arm64），M 系列 Mac 装 x64 版插件会加载失败，但无提示 - Windows 下路径含中文或空格会导致
code --install-extension静默失败，务必用纯英文路径 + 英文双引号包裹
最易被忽略的是托盘进程残留：哪怕窗口关了，右下角图标还在，VSCode 就不会重新加载 extensions 目录。验证前必须右键托盘图标选「Quit」，再启动。
