VSCode插件安装失败主因是缓存、权限、签名验证或Marketplace源切换；应先重载窗口、清除缓存、检查代理及签名兼容性，再确认VSCode版本匹配、依赖工具安装及离线安装方案。
VSCode 插件安装失败，绝大多数情况不是网络问题，而是插件缓存、权限冲突或 Marketplace 连接策略变更导致的。
插件安装卡在“Installing…” 或提示 Failed to install extension
这是最常见现象，背后原因往往不是下载中断，而是 VSCode 本地扩展管理器校验失败。VSCode 1.85+ 默认启用了更严格的插件签名验证和 Marketplace 域名切换（从 marketplace.visualstudio.com 切到 open-vsx.org 镜像策略），部分插件未及时适配签名格式或未同步到新源。
- 先尝试手动清除插件缓存：
Ctrl+Shift+P→ 输入Developer: Reload Window，再试一次安装 - 若仍失败，打开命令面板执行
Extensions: Show Installed Extensions，右键目标插件 →Uninstall，然后重启 VSCode 再重装 - 检查是否启用了企业代理或防火墙拦截了
https://open-vsx.org；可临时禁用代理或在设置中添加："http.proxyStrictSSL": false（仅调试用，不推荐长期开启）
安装后插件不生效，Extension activation failed 报错
这类错误通常出现在插件依赖的 Node.js 环境或 VSCode 版本不匹配时。VSCode 内置的 Electron/Node 版本与插件编译目标不一致，尤其多见于使用了原生模块（如 fsevents、node-sqlite3）的插件。
- 打开开发者工具（
Help → Toggle Developer Tools），在 Console 标签页里找具体报错，重点看Cannot find module或Module version mismatch - 确认插件是否支持你当前的 VSCode 版本：查看插件页面的
engines.vscode字段，比如"^1.75.0"表示最低需 1.75，而你用的是 1.80 就没问题；但若插件只声明到1.79.0，1.80+ 可能被拒绝加载 - 某些插件（如
ESLint、Prettier）需额外安装全局 CLI 工具，仅装插件不够——检查其 README 是否要求npm install -g eslint
离线环境或国内网络下插件安装超时 / 404
VSCode 默认连接 open-vsx.org（社区镜像），但部分区域 DNS 解析不稳定，或该域名被局部屏蔽。此时 VSCode 会静默 fallback 到旧地址，而旧地址已停用，最终表现为“找不到插件”或“Loading…” 不动。
- 手动指定扩展市场源：在
settings.json中添加："extensions.autoUpdate": false和"extensions.gallery.serviceUrl": "https://marketplace.visualstudio.com/_apis/public/gallery"（注意这不是公开推荐地址，仅作临时绕过） - 更稳妥的做法是离线安装：在能联网的机器上访问
https://marketplace.visualstudio.com/items?itemName=author.name→ 点击 “Download Extension” 得到.vsix文件 → 在目标机器的 VSCode 中执行Extensions: Install from VSIX... - 国内用户可考虑换用
VSCodium+Open VSX组合，避免微软账号绑定和 CDN 路由问题
真正麻烦的不是装不上，而是装上了却没触发激活逻辑——比如插件监听了特定文件类型（languageId），但你的文件没正确识别为对应语言，或者 activationEvents 配置太窄。这种问题不会报错，只会“看起来没反应”，得去插件源码的 package.json 里查它到底在等什么事件。
