VS Code 代理设置教程:扩展市场打不开、Copilot 连接失败的处理
VS Code 里有哪几路网络请求
VS Code 不是一个单一的程序,里面有几部分各自联网,搞清楚这一点才知道该改哪里。
| 发起方 | 典型用途 | 是否遵守 http.proxy |
|---|---|---|
| 编辑器本体 | 扩展市场搜索与下载、检查更新、设置同步 | 遵守 |
| 扩展 | Copilot、各类语言服务、远程数据请求 | 多数遵守,取决于扩展的实现方式 |
| 扩展自带的外部程序 | 语言服务器下载依赖、扩展调用的命令行工具 | 不一定,往往只看环境变量 |
| 集成终端 | git、npm、pip、curl 等命令 | 不遵守,走终端自己的环境 |
| 远程主机上的服务端 | Remote SSH 等远程开发场景 | 请求从远程主机发出,与本机代理无关 |
「扩展市场打不开」对应第一行,「Copilot 连接失败」对应第二行,「终端里 git 推送超时」对应第四行。现象不同,要动的地方也不同。
第一步:确认系统代理是否生效
在没有任何手动设置的情况下,VS Code 会尝试读取操作系统的代理设置,也会读取启动时环境里的 http_proxy、https_proxy 变量。所以先做最简单的检查:
- 确认代理客户端的「系统代理」开关已打开,浏览器能正常访问境外网站;
- 完全退出 VS Code 再重新打开。关掉窗口不一定等于退出,macOS 上要用退出命令,Windows 上确认任务栏里没有残留;
- 打开扩展面板搜索任意扩展,看列表能否加载。
很多「不生效」只是因为 VS Code 是在开代理之前启动的,重启一次就好了。
第二步:在设置里配置 http.proxy
系统代理没被正确识别时,直接告诉 VS Code 代理在哪里。
- 打开代理客户端的设置页,记下本地代理端口,例如 7890,以客户端设置页显示为准;
- 在 VS Code 里打开设置,在搜索框输入
proxy; - 找到
Http: Proxy一项,填入http://127.0.0.1:7890,端口换成你自己的; - 完全退出并重新打开 VS Code。
也可以打开用户设置的 JSON 文件直接写:
{
"http.proxy": "http://127.0.0.1:7890"
}
同一组设置里还有几项相关的:
http.proxySupport:控制扩展的网络请求是否由 VS Code 统一套用代理设置,保持默认值即可。http.noProxy:列出不走代理的地址,公司内网的代码托管或私有扩展源可以填在这里。http.proxyStrictSSL:下一节单独说。
手动填了 http.proxy 之后要记住一件事:代理客户端没开的时候,VS Code 的联网功能会全部报连接被拒绝。不用代理时把这一项清空。
http.proxyStrictSSL 是什么,为什么不建议关
这项设置默认开启,意思是:VS Code 通过代理访问 HTTPS 地址时,要严格校验对方服务器的证书,证书不可信就拒绝连接。
网上不少教程遇到扩展装不上,第一步就让人把它改成 false。这样做确实能让某些报错消失,但代价是 VS Code 不再验证「对面是不是真正的扩展市场」。扩展是能在你电脑上执行代码的东西,下载通道失去校验,等于给中间人篡改留了口子。
更重要的是,普通的机场代理并不会触发证书错误。本地代理只是把加密流量原样转发,证书还是目标网站自己的。如果出现了证书相关的报错,真正的原因通常是下面几种:
- 电脑的系统时间不准,证书被判定为未生效或已过期;
- 所在的公司网络会解密检查 HTTPS 流量,使用的是公司自己签发的证书;
- 安全软件开启了 HTTPS 扫描功能;
- 代理客户端里开启了解密 HTTPS 的功能却没有正确信任证书。
对应的处理是校准时间、按公司 IT 的要求安装并信任公司证书、关闭不需要的 HTTPS 扫描。把校验关掉只是把问题盖住了。确实要临时关闭来验证判断时,测试完立刻改回来。
扩展有各自的网络行为
填了 http.proxy,扩展市场正常了,但某个扩展依然连不上,这种情况并不少见。
扩展运行在独立的扩展宿主进程里。使用标准网络接口的扩展会被 VS Code 套上代理设置,GitHub Copilot 属于这一类,正确设置 http.proxy 后一般就能连接。但有些扩展会自己启动一个外部程序来干活,比如某种语言的语言服务器、扩展内置的命令行工具,这些程序不知道 VS Code 的设置,只看系统环境变量,或者有自己的配置项。
处理思路:
- 打开输出面板,在下拉列表里选中这个扩展对应的通道,查看具体报错,确认是网络问题而不是账号或授权问题;
- 看扩展的设置里有没有自带的代理选项;
- 都没有的话,用下文的 TUN 模式。
Copilot 连接失败还要排除非网络因素:是否已登录 GitHub 账号、订阅是否有效。另外,AI 补全和对话依赖持续的连接,节点在后台自动切换会造成中断或反复验证,建议手动固定一个节点,原因见 AI 工具频繁验证。使用这类服务时请遵守其服务条款和所在地的法律法规,本文只涉及网络设置。
Remote SSH:请求发生在远程主机上
用 Remote SSH 连到一台服务器写代码时,情况和本地完全不同。
这种模式下,VS Code 会在远程主机上运行一个服务端程序,大部分扩展也安装并运行在远程主机上。这意味着这些扩展的网络请求、终端里的命令,全部是从远程主机发出的。你本机的代理客户端开得再好,也帮不到远程主机。
常见的两种现象:
- 连接时卡在安装服务端。 首次连接需要把服务端程序放到远程主机上。远程主机访问不了下载地址时就会卡住。Remote SSH 扩展的设置里有一项可以改为由本机下载后再传到远程主机,在设置里搜索
remote.SSH可以找到。 - 连上之后远程扩展装不上。 这是远程主机的网络问题。需要远程主机自己有可用的网络出口,然后在 VS Code 的远程设置里配置
http.proxy,指向远程主机能够访问到的代理地址。
VS Code 的设置分为用户设置和远程设置两层,连上远程主机后在设置页顶部可以切换。本机的 http.proxy 填的是本机的 127.0.0.1,对远程主机没有意义,两边要分别配置。
远程主机是公司或学校的服务器时,在上面配置代理之前先确认是否符合单位的规定。
更省事的方案:TUN 模式
如果不想逐项设置,或者有扩展和外部程序怎么都不认代理,可以在代理客户端里开启 TUN 模式。虚拟网卡会接管整台电脑的流量,编辑器本体、扩展、扩展启动的外部程序、集成终端全部覆盖,VS Code 里不需要任何代理设置。
开 TUN 之后建议把 http.proxy 清空,避免两层代理叠加。TUN 的原理见系统代理与 TUN 模式,开不起来时看 TUN 模式开启失败。
注意 TUN 同样只管本机。Remote SSH 场景下远程主机的网络仍然要在远程主机上解决。
集成终端仍需单独设置
不开 TUN 的话,VS Code 集成终端里运行的 git、npm、pip 不会使用 http.proxy。终端是一个普通的 shell,只认环境变量。在 macOS 和 Linux 的终端里临时设置:
export http_proxy=http://127.0.0.1:7890
export https_proxy=http://127.0.0.1:7890
Windows PowerShell 里对应的是:
$env:HTTP_PROXY="http://127.0.0.1:7890"
$env:HTTPS_PROXY="http://127.0.0.1:7890"
这样设置只对当前终端窗口有效。写进 shell 配置文件的长期方案、git 的单独设置,见终端代理设置教程。在容器里开发的话,容器内还要另外处理,见 Docker 代理设置。
让远程主机借用本机的代理
Remote SSH 场景下,远程主机自己没有可用的代理,而本机的代理客户端是通的。这时可以利用 SSH 的远程端口转发,把本机的代理端口「带」到远程主机上去。
做法是在本机的 SSH 配置文件里,给这台主机加一行转发设置:
Host my-server
HostName 服务器地址
User 用户名
RemoteForward 7890 127.0.0.1:7890
含义是:SSH 连接建立后,远程主机上的 127.0.0.1:7890 会通过这条 SSH 连接转发到你本机的 127.0.0.1:7890,也就是本机代理客户端的端口。端口换成你自己的,前后两个数字可以不同,前一个是远程主机上的端口,后一个是本机的。
之后在 VS Code 的远程设置里把 http.proxy 填成 http://127.0.0.1:7890,远程主机上的扩展就会经过这条转发使用你本机的代理。远程主机终端里的命令行工具,同样把代理环境变量指到这个地址。
需要知道的几点:
- 转发只在 SSH 连接存在期间有效,断开后远程主机上的这个端口就没有了;
- 远程主机上的 7890 端口已经被别的程序占用时,转发会失败,换一个端口号;
- 这样做会让远程主机的一部分流量经过你的本机和你的机场套餐,消耗的是你的流量;
- 远程主机是公司或学校的服务器时,这种做法可能不符合单位的网络规定,使用前先确认。
WSL 和开发容器里的情况
在 Windows 上用 WSL,或者用开发容器写代码,和 Remote SSH 是同一类问题:VS Code 的服务端和大部分扩展运行在另一个环境里,那里的 127.0.0.1 不一定是你的 Windows 本机。
WSL。 默认的网络模式下,WSL 有自己的虚拟网络,在 WSL 里访问 127.0.0.1:7890 找不到 Windows 上的代理客户端。两种解决思路:
- 在 Windows 的代理客户端里开启 TUN 模式。WSL 的流量经过 Windows 出去时一般会被一并接管,WSL 里不需要任何设置。这是最省事的办法;
- 不开 TUN 的话,在代理客户端里打开「允许局域网连接」,然后在 WSL 里把代理环境变量指向 Windows 主机在虚拟网络中的地址,而不是
127.0.0.1。较新的 WSL 版本提供了镜像网络模式,启用后 WSL 和 Windows 共用本机地址,可以直接用127.0.0.1。
开发容器。 容器里的 127.0.0.1 指的是容器自己。容器内的程序要用宿主机上的代理,需要把代理地址写成容器能访问到的宿主机地址,并且宿主机的代理客户端要允许来自本机以外的连接。镜像构建阶段和容器运行阶段的代理还要分别设置,细节见Docker 代理设置。
残留设置造成的「突然连不上」
VS Code 的网络问题里,有相当一部分不是没设置,而是以前设置过的东西还留着。
http.proxy指向一个已经不存在的端口。 换了代理客户端、端口变了,或者今天没开代理,这项设置还指着旧地址,结果扩展市场和 Copilot 全部报连接被拒绝。不用代理时把它清空;- 环境变量残留。 在 shell 配置文件或系统环境变量里写过
http_proxy、https_proxy,VS Code 启动时会继承它们。代理没开时,这些变量会让 VS Code 和终端里的工具全部去连一个关闭的端口。在终端里查看这几个变量当前的值,不需要时删掉; - 设置同步带来的。 开启了设置同步的话,
http.proxy这类用户设置会同步到你登录的其他电脑上。另一台电脑上没有代理客户端,或者端口不同,就会出现「什么都没改,突然全部连不上」。可以在设置同步的选项里把这一项排除在同步之外。
排查时在设置页搜索 proxy,分别切换到用户、远程、工作区几个标签,看每一层各写了什么。
常见问题
扩展市场一直加载不出来,有不依赖网络设置的安装办法吗?
可以离线安装。用浏览器打开 VS Code 扩展市场的网页,在扩展页面下载 VSIX 格式的安装包,然后在 VS Code 扩展面板右上角的更多菜单里选择从 VSIX 安装。这适合临时救急,扩展的后续更新仍然需要网络通畅,所以还是应该把代理设置理顺。
设置了 http.proxy 之后要重启 VS Code 吗?
建议完全退出后重新打开。部分进程只在启动时读取代理设置,只重新加载窗口可能不够。同样,代理客户端的端口改了之后,这里也要跟着改并重启。
浏览器能访问 GitHub,为什么 Copilot 还是提示连接失败?
浏览器走的是系统代理,VS Code 可能没有读到。按顺序处理:完全重启 VS Code;手动填写 http.proxy;在输出面板查看 Copilot 通道的报错;把节点固定为手动选择的一个。如果报错信息与证书有关,按前文检查系统时间和 HTTPS 扫描,而不是关闭证书校验。
VS Code 和 Cursor 的代理设置是一样的吗?
基础部分一样。Cursor 基于 VS Code,http.proxy 这组设置的含义相同。区别在于 Cursor 的 AI 功能有它自己的连接方式和相关选项,专门的排查顺序见 Cursor 代理设置。
公司电脑上 VS Code 提示证书错误怎么办?
多半是公司网络在检查 HTTPS 流量,需要信任公司的根证书。这属于公司 IT 的管理范围,应该按 IT 部门的指引处理,而不是关闭 http.proxyStrictSSL 或在公司电脑上自行安装代理工具。相关的边界见公司网络和校园网的限制。
换了一台电脑登录后,VS Code 突然什么都连不上是为什么?
很可能是设置同步把另一台电脑上的 http.proxy 同步了过来,而这台电脑上没有对应的代理端口。到设置里搜索 proxy,把 http.proxy 清空或改成这台电脑上的正确地址。不想再发生的话,在设置同步里把这一项设为不同步。
WSL 里的终端和扩展怎么使用 Windows 上的代理?
最省事的是在 Windows 的代理客户端里开启 TUN 模式,WSL 的流量一般会一并被接管。不开 TUN 时,在代理客户端里打开允许局域网连接,再把 WSL 里的代理地址指向 Windows 主机在虚拟网络中的 IP;启用了镜像网络模式的 WSL 可以直接使用 127.0.0.1。
用 AI 编程工具对节点有什么要求、该怎么选机场,可以看 AI 用机场怎么选。
本文中的套餐与价格整理自公开资料,核对日期为 2026年11月14日,未经本站实测,购买前请以官网为准。整理方法见这里。
接着读
ChatGPT 反复验证、Too Many Requests 原因:网络角度解释
从网络角度解释 ChatGPT 反复验证、Too Many Requests 的原因:共享 IP 请求密集、IP 频繁切换、数据中心 IP 信誉等,并说明固定节点、换同地区节点、减少并发等做法,账号与地区政策以官方为准。
Claude Code 代理设置、Codex CLI 代理:TUN 与长任务断连
Claude Code 代理设置、Codex CLI 代理都依赖终端网络环境:本文讲代理环境变量与 TUN 模式两种方案,长任务中节点切换导致断连的处理方法,以及企业网络与证书问题的一般思路。
Cursor 代理设置教程:Cursor 连接失败、对话中断的原因与排查顺序
Cursor 代理设置与 Cursor 连接失败排查:如何在设置里配置 http.proxy,什么时候改用 TUN 模式,长连接为什么会被节点自动切换打断,并给出一套从易到难的排查顺序。
Docker 代理设置教程:拉取镜像、构建镜像、容器内三种情况分别怎么配
Docker 代理设置分三种场景:docker pull 超时要给守护进程配代理,构建镜像时用 build-arg 传入,容器运行时用环境变量或 config.json。附各场景命令与 127.0.0.1 不通的原因。