VS Code 怎么设置代理：http.proxy、扩展与终端

代理不会改变什么

本文讲的是网络设置。如果你在 VS Code 里用 GitHub Copilot 这类 AI 扩展，服务自己的条款和地区可用性不会因为代理而改变。GitHub 的贸易管制页面说，受制裁地区的用户仍须遵守美国贸易规则，各地区的可用程度不同，合规责任在用户自己。代理不能让服务在原本不可用的地方变得可用，也不会改变它的条款。

• 来源：
• GitHub：GitHub 与贸易管制

先把三个词说清楚

代理，就是替你向互联网发请求的另一台电脑；网站看到的是代理的地址，而不是你的。

HOST 和 PORT 是这台电脑的地址和「门牌号」。USERNAME 和 PASSWORD 用来证明你有权使用它。

扩展，是装在 VS Code 里的小插件。很多扩展（包括 AI 编程助手）会自己去连接互联网。

VS Code 从哪里找代理

VS Code 文档说，VS Code 的代理支持和 Google Chromium 完全一样：通常会自动读取系统里的代理设置，启动参数 --proxy-server、--proxy-pac-url 和 --no-proxy-server 可以覆盖它们。所以对编辑器本身，先看操作系统的代理设置。

同一页还说，扩展还没有获得同样的代理支持；http.proxy、http.proxyStrictSSL、http.proxyAuthorization 仍保留在设置里，但只在两种情形下生效。我读到的那句话没有点明是哪两种，所以在下面的检查确认之前，不要认为这个设置已经起作用。

• 来源：
• Visual Studio Code 文档：网络连接

在哪里设置 http.proxy

打开设置（File → Preferences → Settings）。在左侧点 Application，再点 Proxy。在 Proxy 输入框里填你的代理地址，例如 http://HOST:PORT。GitHub 的 Copilot 文档描述的正是这条路径，输入框旁边还有一个 Proxy Strict SSL 复选框，请保持勾选。然后完全关闭 VS Code 再重新打开。

• 来源：
• GitHub 文档：配置 GitHub Copilot 的网络设置

在哪里设置 http.proxy：示例

{
  "http.proxy": "http://USERNAME:PASSWORD@HOST:PORT"
}

这是同一个设置在 settings.json 里的样子。把 HOST、PORT、USERNAME、PASSWORD 换成「我的资产」里的值。我读到的文档没有把 http.proxy 这个名字和 Proxy 输入框对应起来，请在设置界面里确认你填的输入框就是这一项。

用户名和密码：写在地址里，还是弹窗输入

方式一，写在地址里。GitHub 的 Copilot 文档说，VS Code 里的 Copilot 支持基本认证，凭据可以直接写进代理地址，例如 http://USERNAME:[email protected]:5187/。这是最简单的做法。但密码会以明文保存在设置文件里，所以千万不要分享或提交这个文件。

方式二，弹窗输入。VS Code 文档说，在需要认证的 HTTP 代理后面，应该会出现认证弹窗，支持 Basic、Digest、NTLM 和 Negotiate。如果你没有把凭据写进地址、而弹窗出现了，就在弹窗里填。

如果用户名或密码里有特殊字符，请在地址里改成百分号编码：@ 写成 %40，: 写成 %3A，/ 写成 %2F，# 写成 %23，% 写成 %25。我读到的官方页面没有讲这一点，这是网址的通用规则，请用下面的检查来验证。直接从「我的资产」复制，比手敲更保险。

• 来源：
• Visual Studio Code 文档：网络连接
• GitHub 文档：配置 GitHub Copilot 的网络设置

HTTP 还是 SOCKS5

VS Code 文档说，SOCKS5 代理认证尚未实现，所以带用户名和密码的代理请选 HTTP。Copilot 的网络页面没有提到 SOCKS。

• 来源：
• Visual Studio Code 文档：网络连接
• GitHub 文档：配置 GitHub Copilot 的网络设置

文档没有说明的设置

VS Code 里还有一个叫 http.proxySupport 的设置，但我读到的官方页面都没有说明它的取值，所以本文不建议你改它。想了解的话，在设置里搜索 proxySupport，看那里显示的说明。http.proxyAuthorization 在 VS Code 文档里只出现了名字、没有说明；凭据写在地址里时用不到它。

• 来源：
• Visual Studio Code 文档：网络连接

自己发请求的扩展

很多扩展，尤其是 AI 编程助手，会自己去连接它们的服务。VS Code 文档说，扩展还没有获得和编辑器一样的代理支持，这正是 http.proxy 对它们很重要的原因。具体某个扩展是读取 http.proxy、有自己的代理输入框，还是用别的方式，由这个扩展自己决定：请看它在应用市场的介绍和它的设置。如果做完下面的检查后某个扩展仍然失败，就去它自己的设置里找代理选项。

GitHub Copilot 用的就是上面说的同一个 Proxy 输入框；Copilot 页面有具体步骤和现成预设。Cursor 基于 VS Code，另有自己的开关，见它的专门指南。

• Cursor 怎么设置代理
• GitHub Copilot 代理设置指南
• GitHub Copilot 代理设置

• 来源：
• Visual Studio Code 文档：网络连接
• GitHub 文档：配置 GitHub Copilot 的网络设置

VS Code 里的终端

集成终端运行的是普通命令行程序，每个程序自己决定去哪里找代理。我读到的 VS Code 页面没有讲终端，所以不要指望 http.proxy 会作用在你在终端里运行的程序上。大多数命令行工具读取环境变量或自己的选项。curl 指南列出了 curl 读取的变量以及它们的优先关系；git、npm、pip 等其他工具，请看它们各自的文档。

• curl 怎么设置代理

终端：只对当前窗口生效的示例

export https_proxy="http://USERNAME:PASSWORD@HOST:PORT"
export http_proxy="http://USERNAME:PASSWORD@HOST:PORT"
curl https://ipinfo.io/json

仅作示意：这两个名字是 curl 会读取的（见 curl 指南），其他程序可能读别的名字，或者都不读。这些变量只在当前终端窗口里有效。把 HOST、PORT、USERNAME、PASSWORD 换成「我的资产」里的值。

怎么验证代理是否生效

1. 先在终端里用下面的命令单独测试代理

   它会显示网站看到的 IP、国家和网络。如果这一步失败，问题出在代理信息上，而不是 VS Code。「如何检查代理的 IP、国家和运营商」一文解释了各字段。

   • 如何检查代理的 IP、国家和运营商

2. 完全退出 VS Code 再重新打开

   关掉整个编辑器，而不只是窗口，然后重复刚才失败的操作，例如扩展里的登录或一次聊天请求。

3. 看扩展自己给出的报错

   VS Code 文档没有介绍内置的连接测试，所以请以扩展的报错文字和下面的清单为准。

在编辑器之外检查代理：示例

curl -x http://USERNAME:PASSWORD@HOST:PORT https://ipinfo.io/json

把 HOST、PORT、USERNAME、PASSWORD 换成「我的资产」里的值。返回结果显示网站看到的 IP、国家和网络。

常见错误

• 407 Proxy Authentication Required。代理拒绝了用户名或密码。重新复制信息，并检查百分号编码。

• 证书错误。只有会改写证书的代理才会出现。VS Code 文档把「把代理证书加入操作系统的受信任证书」列为首选做法，并称忽略证书错误是危险的、不推荐。不要为了省事取消勾选 Proxy Strict SSL。

• 编辑器能联网，但某个扩展不行。那个扩展自己发请求：见上面关于扩展的一节。

• 超时。代理在该端口没有响应，或 IP 租期已结束。用 curl 命令测试。

• 来源：
• Visual Studio Code 文档：网络连接

用 Proxy302 怎么做

如果你希望编辑器始终使用同一个地址，静态 ISP 代理比较合适：整个租期内 IP 不变，购买时选择协议。请选 HTTP：VS Code 文档说 SOCKS5 认证尚未实现。产品本身的介绍见静态住宅代理页面。

• 静态住宅（ISP）代理

用 Proxy302 怎么做：步骤

1. 第 1 步

   打开静态 ISP 页面，选择国家，协议选 HTTP，再选租期和数量，核对费用后生成。

2. 第 2 步

   打开「我的资产」，复制 HOST、PORT、USERNAME、PASSWORD。「连接」页会用你自己的信息给出现成示例。HTTP 使用 proxy.proxy302.com 的 2222 端口。

3. 第 3 步

   把这些值填进 Proxy 输入框（http.proxy），按上文所示，完全退出 VS Code 再重新打开。

4. 第 4 步

   用上面的 curl 命令检查出口，并按代理位置检查指南的说明看 country 和 org 字段。

   • 如何检查代理的 IP、国家和运营商

价格与限制

静态 ISP 的 IP 一天 0.50 美元，30 天 7.99 美元（约每天 0.27 美元），各国相同。各国库存每天变化，以下单页显示为准。没有免费试用，最小购买量是 1 个 IP、1 天。

• 来源：
• Proxy302 产品事实与价格表

常见问题

延伸阅读

Cursor 怎么设置代理

在 Cursor 中用 http.proxy 设置代理，处理密码里的特殊字符，流式响应卡住时切换到 HTTP/1.1，并用 Run Diagnostics 验证。

GitHub Copilot 怎么走代理

让 GitHub Copilot 在 VS Code 和 JetBrains 中走 HTTP 代理：代理字段、基本认证、证书，以及用 curl 访问 GitHub 的 ping 地址来验证。

代理 IP 怎么查：IP 地址、国家、运营商

30 秒查清代理的 IP、国家和运营商；为什么不同查询网站城市对不上、纯净度分数看什么。附我们对三家查询服务的实测。

curl 代理设置

在 curl 里使用 HTTP 或 SOCKS5 代理：-x、账号密码、socks5h、环境变量、.curlrc 和出口检查。

静态住宅 IP（ISP 代理）

静态 ISP 代理：一条固定的住宅级 IP，整个租期内保持不变。适合社媒账号、店铺和 AI 工具。支持 HTTP / SOCKS5。

查看配置与价格