插件显示“已安装”但灰色不可用，通常因 activationEvents 未触发、依赖缺失、配置错误、远程模式不支持或插件声明不完整所致，需结合开发者工具报错、package.json 声明及环境配置综合排查。
插件显示“已安装”但灰色不可用
这通常不是插件本身损坏，而是 VSCode 没有完成激活流程。最常见原因是插件依赖的 package.json 中声明的 activationEvents 未被触发——比如插件只在打开特定语言文件时才加载，而你当前是空窗口或纯文本标签页。
- 打开命令面板（
Ctrl+Shift+P/Cmd+Shift+P），运行Developer: Toggle Developer Tools，切换到Console标签页，刷新后看是否有类似Activating extension 'xxx' failed的报错 - 检查插件详情页里的
Activation Events字段（在插件市场网页或 VSCode 插件面板里点「ⓘ」图标），确认是否需要打开对应文件类型（如onLanguage:python）或执行某条命令（如onCommand:extension.xxx）才能激活 - 尝试手动触发：新建一个该插件支持的语言文件（如
test.py），保存为对应后缀，再看插件是否变亮
启用时报错 “Cannot find module” 或 “Cannot resolve dependency”
这类错误多见于从 VSIX 手动安装、或插件使用了非标准打包方式（如未将 node_modules 打包进发布包）的情况。VSCode 不会自动运行 npm install，所有依赖必须由插件作者提前构建好。
- 卸载插件后，前往插件安装目录手动清理残留：
~/.vscode/extensions/（macOS/Linux）或%USERPROFILE%\.vscode\extensions\（Windows），删除对应插件文件夹（文件夹名含作者名和插件名，如ms-python.python-2024.6.0） - 重启 VSCode，再通过扩展市场搜索安装（避免使用第三方下载的 VSIX）
- 若必须用 VSIX，安装前先用
unzip -l xxx.vsix | grep node_modules（macOS/Linux）或 7-Zip 查看压缩包内是否包含node_modules/子目录；缺失则大概率无法运行
插件启用后功能不生效，但无任何报错
这往往是因为配置项未正确设置，或与其他插件冲突。VSCode 的插件机制允许覆盖同名设置，后加载的插件可能静默接管了关键配置键。
- 运行
Preferences: Open Settings (JSON)，检查是否有插件要求的必填配置，例如prettier.path、eslint.packageManager等——漏配会导致插件启动但不工作 - 禁用其他同类插件（如同时装了
esbenp.prettier-vscode和esbenp.mdx），再逐个启用测试 - 在设置中搜索插件名（如
@ext:ms-python.python），确认所有相关开关（如python.defaultInterpreterPath、python.languageServer）都处于合理值，尤其注意路径是否存在且可执行
插件在远程开发（SSH/Containers）中无法启用
VSCode 的远程扩展模型要求插件明确声明支持远程模式。如果插件未在 package.json 中设置 extensionKind，它只会运行在本地端，即使你连接的是远程服务器，插件也不会加载到远端环境。
- 查看插件市场页面的「Details」区域，确认是否标注了
Runs on: Remote或Runs on: Desktop - 若插件只标了
Desktop，但在远程窗口里仍想用，可右键插件 →Install in SSH: [host]（或Dev Container），强制安装到远端（前提是插件代码本身兼容 Node.js 远程运行时） - 某些插件（如依赖 GUI 或系统命令行工具的）即使强行安装到远端，也会因缺少依赖（如
git、curl、X11）而失败；此时需登录远程机器手动补全依赖
// 示例：检查插件是否声明支持远程运行
// 在插件 package.json 中应包含：
{
"extensionKind": ["ui", "workspace"]
// 或更常见的：
"extensionKind": ["workspace"]
}
// 若缺失 extensionKind，默认为 ["ui"]，即只在本地 UI 进程运行
插件加载问题的根因往往藏在控制台日志或 package.json 的声明细节里，而不是界面显示的“已安装”状态。动手前先开开发者工具看一眼报错，比反复重装高效得多。 
