如何在VSCode中配置局域网代理(Proxy)解决插件商店下载失败的问题

梦枫吖_8406

梦枫吖_8406

2026-04-04

1200人浏览

原创

vscode代理配置不生效的主因是未在内部显式设置http.proxy,且windows/macos默认绕过localhost导致127.0.0.1:7890请求不走代理;需手动配置http.proxy并验证代理服务监听状态及https中转能力。

如何在vscode中配置局域网代理(proxy)解决插件商店下载失败的问题

VSCode 代理配置不生效的常见原因

VSCode 的代理设置只影响它自身发起的网络请求(比如插件安装、更新、GitHub 登录),**不会自动读取系统代理或浏览器代理**。很多人改了系统代理或开了 Clash/Shadowrocket,但 VSCode 依然连不上 Marketplace,就是因为没在 VSCode 内部显式配置 http.proxy。

另一个高频问题是:代理地址写成了 http://127.0.0.1:7890,但实际代理服务监听的是 0.0.0.0:7890 或仅 127.0.0.1:7890 —— 这本身没问题;真正出问题的是 Windows/macOS 上启用了「绕过本地地址」逻辑,默认把 localhost 和 127.0.0.1 排除在代理外,导致 VSCode 发往 127.0.0.1:7890 的请求根本没走代理进程。

  • 确认代理服务(如 Clash for Windows、v2rayN、Proxyman)已开启且 HTTP 代理端口处于监听状态(可用 curl -x http://127.0.0.1:7890 https://httpbin.org/ip 验证)
  • 避免用 localhost,统一用 127.0.0.1(部分 VSCode 版本对 localhost 解析异常)
  • 如果代理运行在另一台局域网机器上(如 192.168.1.100:8080),确保该机器防火墙放行端口,且代理软件配置允许局域网连接(Clash 需设 allow-lan: true)

手动设置 http.proxy 配置项(推荐)

VSCode 的代理由 http.proxy 控制,它优先级高于系统环境变量,也比命令行启动时传参更稳定。直接修改用户设置(Settings UI 或 settings.json)即可:

打开命令面板(Ctrl+Shift+P / Cmd+Shift+P),输入并选择 Preferences: Open Settings (JSON),在右侧面板中添加或修改:

{
  "http.proxy": "http://127.0.0.1:7890",
  "http.proxyStrictSSL": false
}

http.proxyStrictSSL 设为 false 是为了兼容自签名证书的代理(如某些企业中间人代理或旧版 Charles),若你用的是 Clash、Surge 等标准代理可省略此项。

VSCode
VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载
  • 代理需带协议前缀(http://),不能只写 127.0.0.1:7890,否则 VSCode 会静默忽略
  • 如果代理需要认证,格式为 http://user:pass@127.0.0.1:7890,注意 URL 编码特殊字符(如 @ → %40)
  • 修改后无需重启 VSCode,插件市场刷新或重试安装即可生效

为什么不用 environment variable 或 --proxy 启动参数

虽然可以设置 HTTP_PROXY 环境变量或用 code --proxy-server="http://127.0.0.1:7890" 启动,但这两者都有明显短板:

  • HTTP_PROXY 环境变量对 VSCode 无效(它只读 http.proxy 设置,不继承系统变量)
  • --proxy-server 是 Electron 底层参数,仅影响渲染进程的 fetch/XHR,**不控制 Extension Host 的 npm 安装行为**,所以插件下载仍可能失败
  • 通过命令行启动还容易被桌面快捷方式覆盖,不如配置项一劳永逸

验证代理是否真正起作用

最直接的方式是看 VSCode 底部状态栏:成功配置后,左下角会出现一个代理图标(?),悬停显示当前代理地址;但这个图标有时延迟或不出现,更可靠的是抓包验证:

打开代理工具的流量日志页(如 Clash Dashboard 的「Profiles → Logs」),然后在 VSCode 中点击「Install」某个插件(例如 ms-python.python)。如果日志里出现类似 marketplace.visualstudio.com 或 vscode.blob.core.windows.net 的出站请求,说明代理已生效。

如果仍失败,检查 VSCode 输出面板(Ctrl+Shift+U)→ 切换到 Extension Management 或 Log (Window),搜索关键词 proxy 或 ECONNREFUSED,常见错误如:

  • Failed to fetch extension from ... Error: connect ECONNREFUSED 127.0.0.1:7890 → 代理进程未运行,或端口不对
  • getaddrinfo ENOTFOUND marketplace.visualstudio.com → 代理本身无法联网(比如 Clash 规则全直连、DNS 设置错误)
  • 无任何错误但卡在“Installing…” → 可能是代理响应超时,尝试调大 http.proxyTimeout(单位毫秒,默认 10000)

局域网代理配置的关键不在“填对地址”,而在于确认代理服务本身能正常中转 HTTPS 流量,并且 VSCode 的 Extension Host 进程确实把请求交给了它——这两步漏掉任何一环,都会表现为“明明配了却还是下不了”。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

vscode

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

2023.08.07

2155

5

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.23

3322

1

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

2023.10.13

1116

3

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

2025.09.10

3819

7

curl_exec
curl_exec

curl_exec函数是PHP cURL函数列表中的一种,它的功能是执行一个cURL会话。给大家总结了一下php curl_exec函数的一些用法实例,这个函数应该在初始化一个cURL会话并且全部的选项都被设置后被调用。他的返回值成功时返回TRUE, 或者在失败时返回FALSE。

2023.06.14

3663

6

linux常见下载安装工具
linux常见下载安装工具

linux常见下载安装工具有APT、YUM、DNF、Snapcraft、Flatpak、AppImage、Wget、Curl等。想了解更多linux常见下载安装工具相关内容,可以阅读本专题下面的文章。

2023.10.30

835

4

scripterror怎么解决
scripterror怎么解决

scripterror的解决办法有检查语法、文件路径、检查网络连接、浏览器兼容性、使用try-catch语句、使用开发者工具进行调试、更新浏览器和JavaScript库或寻求专业帮助等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.18

989

5

500error怎么解决
500error怎么解决

500error的解决办法有检查服务器日志、检查代码、检查服务器配置、更新软件版本、重新启动服务、调试代码和寻求帮助等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.25

3000

5

github中文官网入口 github中文版官网网页进入
github中文官网入口 github中文版官网网页进入

github中文官网入口https://docs.github.com/zh/get-started,GitHub 是一种基于云的平台,可在其中存储、共享并与他人一起编写代码。 通过将代码存储在GitHub 上的“存储库”中,你可以: “展示或共享”你的工作。 持续“跟踪和管理”对代码的更改。

2026.01.21

8565

27

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程