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，也别迷信所有扩展都必须来自微软商店。
