离线安装插件后灰色不可用，主因是VSCode默认禁用+激活事件未触发+依赖缺失；需手动启用、完整迁移插件目录、检查activationEvents及node_modules路径，并彻底重启VSCode。
离线安装插件后显示“已安装”但灰色不可用，不是插件坏了，而是 VSCode 没触发激活流程或关键依赖缺失——多数情况只需手动启用 + 完整迁移插件目录，而非重装。
插件列表里是灰色的，根本点不了「启用」
这是 VSCode 离线安装后的默认行为：插件状态被设为 disabled，GUI 不提示，也不允许点击启用按钮。
- 打开命令面板（
Ctrl+Shift+P/Cmd+Shift+P），输入并执行Developer: Toggle Developer Tools - 切换到 Console 标签页，刷新页面，看是否有类似
Extension 'ms-python.python' is disabled的日志 - 直接在终端中运行：
code --enable-proposed-api ms-python.python（替换为你的插件 ID）强制启用 - 更稳妥的做法：完全退出 VSCode（任务管理器里确认无
Code.exe或Code Helper进程），再启动
点开文件后插件仍不加载，Output 面板报 spawn ENOENT
这说明插件已启用，但首次运行时尝试调用的二进制文件（如 pyright、volar-server、prettier）根本不存在——离线环境下 LSP/CLI 下载被跳过，不是“没下载完”，是压根没机会下载。
- 必须从一台已联网且完整启用过该插件的机器上，拷贝整个插件目录（如
ms-python.python-2024.6.0/），不能只拷.vsix文件 - 重点检查目录下是否存在
node_modules/@microsoft/pyright（Python）、node_modules/@volar/vue-language-server/bin/（Vue）等子路径 - Linux/macOS 路径：
~/.vscode/extensions/；Windows 路径：%USERPROFILE%\AppData\Roaming\Code\Extensions\ - 拷完后务必彻底重启 VSCode，否则旧进程仍会读缓存
code --install-extension 报 “not compatible with Code” 却找不到原因
这个错误不指向网络，只说明版本校验失败，但 VSCode 不告诉你具体哪一环不匹配——常见于 engines.vscode 字段、架构或构建平台不一致。
- 运行
code --version，取前两位（如1.92.2→ 实际比对用1.92） - 用
unzip -p plugin.vsix extension/package.json | grep engines查插件要求的最低版本（如"vscode": "^1.93.0"） - Help → About 里看括号内架构（
x64/arm64），ARM Mac 装 x64 版本的插件必失败 - 别改
package.json后重打包：签名失效会导致插件被禁用，且 VSCode 可能拒绝加载
插件启用了，但功能没反应，命令面板也搜不到
这往往是因为 activationEvents 没被触发，或者配置项缺失导致插件启动后立即退场——它没崩溃，只是“空转”。
- 检查插件详情页的
Activation Events字段（VSCode 插件面板点「ⓘ」图标），确认是否需打开特定类型文件（如onLanguage:python）才激活 - 新建一个对应后缀文件（如
test.py、index.vue），保存后再试，不要在纯文本标签页里等 - 运行
Preferences: Open Settings (JSON)，确认有无插件强依赖的配置项，例如：python.defaultInterpreterPath、prettier.path、eslint.packageManager - 禁用其他同类插件（如同时装了
esbenp.prettier-vscode和esbenp.mdx），避免配置键被覆盖
最容易被忽略的是：插件目录迁移后，VSCode 仍可能读取旧缓存；必须彻底杀掉所有 Code 进程再启动，否则 spawn ENOENT 和 activation failed 会反复出现。
