“已安装”不等于可用，需验证命令注册、语言模式切换、状态栏提示、开发者工具无报错；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 时）。

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

查依赖的唯一可靠方式是解压 .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」，再启动。