VSCode插件市场连不上应优先配置环境变量HTTP_PROXY/HTTPS_PROXY(全大写、带http://前缀)或切换微软中国镜像源https://vscode.cdn.azure.cn/extensions/marketplace.json,而非依赖settings.json中的http.proxy;改完需彻底退出所有Code进程并重启,且镜像仅加速列表加载,.vsix下载仍需确保vscode.blob.core.windows.net可达。

直接改环境变量比动 settings.json 更可靠
VSCode 插件市场连不上,90% 是代理没走对——settings.json 里配的 http.proxy 经常被忽略,尤其在 Windows 双击启动、macOS 从 Dock 启动时。真正起作用的是系统级环境变量:HTTP_PROXY 和 HTTPS_PROXY。它们必须全大写(Linux/macOS 下小写无效),且协议头不能省:http://127.0.0.1:7890 才行,只写 127.0.0.1:7890 会导致超时卡死。
- macOS:加到
~/.zprofile(不是~/.zshrc),然后终端执行code --new-window启动测试 - Windows:系统属性 → 高级 → 环境变量 → 新建系统变量,变量名
HTTPS_PROXY,值填http://127.0.0.1:7890(Clash/Sing-Box 默认 HTTP 代理端口) - Linux:写进
~/.profile,登出重登录,或用env | grep -i proxy确认是否加载
HTTPS_PROXY 必须带 http:// 协议头,SOCKS5 不原生支持
很多用户填 socks5://127.0.0.1:1080,VSCode 会静默失败,控制台只显示 XHR failed,不报具体错误。VSCode 不支持 SOCKS5,必须转成 HTTP 代理。Clash 默认开了 http-port: 7890,直接用它;Sing-Box 或其他工具没开 HTTP 端口的,得额外配 privoxy 或 cntlm 中转。
- 验证代理是否真在运行:
curl -v https://marketplace.visualstudio.com,如果也返回net::ERR_CONNECTION_RESET,说明问题不在 VSCode,在网络设备层 - 若
curl成功但 VSCode 失败,临时加"http.proxyStrictSSL": false到settings.json测试(仅调试用,勿长期开启) - 企业网常见 TLS 握手被 RST,VSCode 1.89+ 默认 TLS 1.3,老旧网关只认 TLS 1.2,此时降级不可行,只能换镜像或离线装
换微软中国镜像源是最省事的兜底方案
国内用户不必硬扛代理,直接切镜像源更稳。VSCode 本身支持自定义扩展市场地址,改的是 Extensions: Gallery Service URL 这个配置项,不是 http.proxy。镜像地址是微软官方提供的:https://vscode.cdn.azure.cn/extensions/marketplace.json,不是第三方魔改版,无安全风险,加载速度和成功率都明显提升。
- 操作路径:Ctrl + , → 搜索
extensions gallery→ 找到Extensions: Gallery Service URL→ 粘贴上面的 URL - 改完不用重启,刷新扩展视图(Ctrl+Shift+X)即可生效;若仍空白,按 Ctrl+Shift+I 打开 DevTools → Console 标签页看有没有 403 或 CORS 报错
- 注意:镜像只加速 marketplace.json 列表加载,插件下载包(.vsix)仍走
vscode.blob.core.windows.net,该域名也要确保能通(企业防火墙常封这个)
手动安装 .vsix 是最后防线,但要注意版本兼容性
当所有网络方案都失效,唯一确定能成功的路径就是跳过 marketplace 请求,直装离线包。VSCode 插件本质是 .vsix 文件,官网每个插件页底部都有 “Download Extension” 按钮。但容易忽略的是:插件 ID(如 ms-python.python)和实际下载链接里的版本号强绑定,比如 python-2024.12.1.vsix,不同 VSCode 版本对插件 API 的要求不同,老版 VSCode 装新版插件可能灰显不可启用。
- 获取正确链接:打开
https://marketplace.visualstudio.com/items?itemName=ms-python.python→ 滚到底部点下载 → 得到完整文件名 - 安装方式:Ctrl+Shift+P → 输入
Extensions: Install from VSIX→ 选中该文件 - 验证是否生效:安装后不要急着重启,先看扩展视图里状态是否为 “已启用”,再检查右下角 Python 解释器选择是否出现;若仍灰显,大概率是 VSCode 内核版本太低,需升级编辑器本身
NO_PROXY——漏配它,本地开发服务器或调试端口(如 127.0.0.1:5678)也可能被代理劫持,导致 Python 调试直接超时。


















