VSCode扩展安装失败_扩展市场无法访问或安装问题

VS Code 扩展安装失败主因是国内无法访问默认市场 marketplace.visualstudio.com，需改用 open-vsx.org 镜像源并在 settings.json 中配置 serviceUrl 和 itemUrl，重启后即可正常安装；微软官方扩展缺失时可手动安装 .vsix 文件。

VS Code 扩展安装失败，大概率不是你网络或操作的问题，而是 VS Code 默认扩展市场（marketplace.visualstudio.com）在国内被限访问，且客户端未配置代理或镜像源。

为什么扩展市场打不开、安装总卡在“正在安装”或报错 Unable to fetch extensions

VS Code 1.80+ 版本默认使用 httpS 直连微软官方市场，但该域名在国内 DNS 解析常超时或返回空响应。常见错误包括：connect ETIMEDOUT、getaddrinfo ENOTFOUND marketplace.visualstudio.com、安装按钮灰掉无反应。

• 不是插件本身损坏，也不是 VS Code 安装不完整
• 不是必须换梯子——可本地配置镜像源绕过限制
• windows/macos/linux 行为一致，但配置路径略有不同

快速修复：改用国内可用的扩展市场镜像源

推荐使用由社区维护的 open-vsx.org 镜像（非微软官方，但兼容性好、更新及时），需手动修改 VS Code 设置。

• 打开 VS Code 设置（Ctrl+, 或 Cmd+,），搜索 extensions.gallery
• 点击 Edit in settings.json，在 settings.json 中添加以下字段：

{   "extensions.autoUpdate": true,   "extensions.gallery": {     "serviceUrl": "https://open-vsx.org/vscode/gallery",     "itemUrl": "https://open-vsx.org/vscode/item"   } }

• 保存后重启 VS Code，再打开扩展面板（Ctrl+Shift+X），搜索/安装即可正常工作
• 注意：部分微软自家扩展（如 ms-python.python）可能不在 open-vsx 上，此时需单独下载 .vsix 文件手动安装

手动安装 .vsix 文件时常见的坑

从官网或 gitHub 下载的 .vsix 文件双击无效？或提示 Extension is not compatible with current version of VS Code？

• 确认 VS Code 版本与扩展要求匹配：查看扩展页面的 engines.vscode 字段，例如 "^1.75.0" 表示最低需 1.75
• 不要拖拽到窗口里安装——应使用命令面板：Ctrl+Shift+P → 输入 Extensions: Install from VSIX... → 选择文件
• 如果提示签名问题（尤其 macOS），需在终端执行：xattr -d com.apple.quarantine /path/to/extension.vsix
• 已启用 Workspace Trust 的文件夹中，扩展可能被禁用，检查右下角状态栏是否显示 Restricted Mode

代理配置仅在有稳定 HTTP/HTTPS 代理时才推荐

如果你已有公司代理或本地代理（如 Clash、Surge），可通过设置生效，但比镜像源更易出错。

• 在 settings.json 中添加："http.proxy": "http://127.0.0.1:7890"（端口按实际调整）
• 务必同时设置："http.proxyStrictssl": false，否则自签名证书会拦截市场请求
• 不建议开启 http.proxySupport 的 override 模式，容易导致内置终端、调试器等组件异常
• 代理失效时 VS Code 不会自动降级，扩展安装会直接失败，而镜像源是静态地址，稳定性更高

真正卡住的地方往往不是“怎么装”，而是没意识到 VS Code 的扩展市场本身就是一个可替换的 HTTP 接口——改 URL 就行。别反复重装 VS Code，也别迷信所有扩展都必须来自微软商店。