GitHub Copilot 在 VS Code 中出现登录失败、补全长时间转圈或连接超时,不一定是节点完全不可用。Copilot 的请求通常由 VS Code 扩展、编辑器内置网络模块和认证流程分别发起,访问的域名、代理读取方式和 TLS 连接过程也可能不同。浏览器能够打开 GitHub,只能说明浏览器当前路径可用,不能直接证明 Copilot 已经使用了同一个 Clash 代理。

排查时建议按照“本地端口 → VS Code 代理 → Clash 规则 → DNS 与节点 → Copilot 扩展日志”的顺序进行。每次只修改一个因素,并在修改后重新登录或重新加载窗口。这样可以判断问题究竟发生在 VS Code 没有走代理、Clash 规则误判、DNS 解析异常,还是节点本身无法稳定连接 GitHub 相关服务。

GitHub Copilot 连不上?Clash 超时排查与修复方法

先确认 Clash 内核和代理端口正在运行

打开 Clash Verge、Clash Verge Rev 或其他 Mihomo 客户端,先确认当前配置处于已启用状态,内核没有因为 YAML 解析失败、端口冲突或权限问题而停止。客户端界面显示“已启动”并不总能代表所有功能正常,最好同时观察运行日志和连接页面。

优先记录当前实际使用的端口。常见配置可能包含 HTTP 端口、SOCKS 端口或 mixed-port,但不同客户端的默认值并不完全一致。下面的配置只是说明端口关系,不能替代客户端中显示的生效配置:

mixed-port: 7890
socks-port: 7891
allow-lan: false
mode: rule

如果配置使用 mixed-port,可以把它作为同时支持 HTTP 和 SOCKS5 的本地入口。VS Code 的代理设置通常填写 HTTP 形式,例如 http://127.0.0.1:7890,即使最终连接的目标地址是 HTTPS,也不应因为目标是 HTTPS 就擅自把本地代理地址改成 https://。

Windows 可以在 PowerShell 中检查端口是否有进程监听:

Get-NetTCPConnection -LocalPort 7890 -State Listen

netstat -ano | findstr 7890

macOS 或 Linux 可以使用以下命令:

lsof -nP -iTCP:7890 -sTCP:LISTEN

ss -lntp | grep 7890

如果没有监听结果,先不要修改 Copilot 或 VS Code 设置。应回到 Clash 的内核日志中检查端口是否被其他程序占用、配置是否加载成功,以及客户端是否只启动了界面却没有启动内核。如果端口被占用,可以更换 Clash 端口,但更换后必须同步更新 VS Code、终端环境变量和其他使用该代理的应用。

用 curl 分开测试本地代理与目标连接

确认端口监听后,可以使用 curl 显式指定代理。显式指定的好处是绕过系统代理开关和 VS Code 设置,直接测试“命令行到本地 Clash 端口”以及“Clash 从节点访问目标站点”这两段链路。

curl.exe -I -x http://127.0.0.1:7890 https://github.com

curl.exe -I -x http://127.0.0.1:7890 https://api.github.com

macOS 与 Linux 可以使用相同的命令;如果本机同时提供 SOCKS 端口,也可以测试:

curl -I --proxy socks5h://127.0.0.1:7891 https://github.com
curl -I --proxy socks5h://127.0.0.1:7891 https://api.github.com

socks5h 中的 h 表示由代理端解析目标域名。它有助于减少本地 DNS 结果对测试的干扰。如果 HTTP 代理和 SOCKS5 代理都失败,问题更可能在 Clash 内核、节点或 DNS;如果显式代理成功,而 VS Code 中仍然失败,则重点检查 VS Code 是否读取了错误端口、是否存在代理覆盖设置,或者扩展运行在远程环境中。

测试过程中应打开 Clash 的连接记录,观察访问 github.com 和 api.github.com 时实际命中的规则、代理组和节点。不要只看 curl 是否返回 HTTP 状态码,因为请求可能已经成功连接,却被错误地分配到了直连或不稳定的节点。

检查 VS Code 的代理设置与扩展运行方式

VS Code 可以读取系统代理,也可以在自身设置中使用独立代理配置。两者同时存在时,最终行为取决于 VS Code 版本、设置项和扩展的网络实现。打开设置搜索 proxy,重点检查 http.proxy、http.proxySupport 和 http.proxyStrictSSL。

如果 Clash 的 HTTP 端口是 7890,可以在 VS Code 的 settings.json 中临时写入:

{
  "http.proxy": "http://127.0.0.1:7890",
  "http.proxySupport": "override"
}

override 会让 VS Code 更明确地使用 http.proxy,适合用来判断系统代理读取是否存在问题。测试完成后,如果团队环境或系统策略不需要强制覆盖,可以恢复为默认行为,避免其他扩展被固定到一个已经变化的本地端口。

不建议把 http.proxyStrictSSL 设为 false 作为常规修复方法。关闭严格证书校验可能暂时绕过某些 TLS 错误,但会降低连接安全性,也可能掩盖系统时间错误、企业代理证书未安装或网络中存在 HTTPS 检查的问题。只有在明确了解企业网络证书链的情况下,才应按照组织的证书部署方案处理。

修改设置后执行“Developer: Reload Window”重新加载窗口,再打开 Copilot Chat 或编辑器中的补全功能。若 VS Code 使用的是 Remote SSH、Dev Container 或 WSL,还要确认 Copilot 扩展实际运行在哪一侧:

如果本机 VS Code 能够工作,但连接到远程窗口后 Copilot 失败,不要继续反复切换本机节点。此时应在远程终端中执行 curl 测试,并确认远程环境是否能访问本机代理端口。远程主机与本机不在同一网络时,本机 Clash 也不会自动成为远程主机的代理。

修正 GitHub 与 Copilot 相关的分流规则

Copilot 并不是只访问一个网页域名。登录、账户验证、扩展服务、API 请求和补全请求可能使用不同的 GitHub 相关域名。配置规则时,不应只添加 github.com 就认为所有请求都会被正确代理,也不应为了省事把所有流量永久切换到全局代理。

可以在自有配置的规则段中,为常见 GitHub 服务设置清晰的域名后缀规则。下面是结构示例,策略组名称必须替换成当前配置中真实存在的名称:

rules:
  - DOMAIN-SUFFIX,github.com,PROXY
  - DOMAIN-SUFFIX,githubusercontent.com,PROXY
  - DOMAIN-SUFFIX,githubcopilot.com,PROXY
  - DOMAIN-SUFFIX,copilot-proxy.githubusercontent.com,PROXY
  - DOMAIN-SUFFIX,githubassets.com,PROXY
  - MATCH,DIRECT

不同版本的 Copilot 扩展和服务端可能使用不同的域名,上述列表不能视为永久完整清单。更可靠的做法是先触发一次登录或补全请求,再在 Clash 的连接记录中查看实际出现的域名。对于确认属于 Copilot 服务、但没有匹配现有规则的域名,再按实际域名增加规则。

要特别注意规则顺序。Clash 通常从上到下匹配,连接命中第一条适用规则后就不会继续检查。如果在 GitHub 规则之前存在较宽泛的 GEOIP,CN,DIRECT、某个大范围 DOMAIN-SUFFIX 或规则集引用,那么目标可能先被分配到直连。自定义 GitHub 规则应放在会提前命中的宽泛规则之前,但仍要保留最终的 MATCH 兜底项。

排查 DNS、IPv6 与 TLS 连接问题

Copilot 连接超时有时发生在代理建立之前:域名解析得到的地址不可达、系统优先使用了异常的 IPv6、Fake IP 规则与某个应用不兼容,都可能表现为“扩展一直加载”。因此,不能只更换节点而忽略 DNS。

如果 Clash 使用增强 DNS,可以先确认 DNS 模式、上游服务器和 Fake IP 过滤列表。部分应用或企业网络对 Fake IP、IPv6 或自定义证书链处理不一致。排查时可以暂时使用更简单的 DNS 配置,关闭 IPv6 或切换到 redir-host 进行对照测试,但每次只改变一个项目,并记录恢复方法。

dns:
  enable: true
  ipv6: false
  enhanced-mode: redir-host
  nameserver:
    - 223.5.5.5
    - 1.1.1.1

这段内容只适合用作排查思路,实际字段支持和默认行为取决于所用 Mihomo 版本及客户端覆写。若客户端自动生成 DNS 配置,不要直接编辑会被订阅更新覆盖的文件,应使用客户端提供的覆写入口。

可以分别查看系统解析结果与代理侧解析结果:

nslookup github.com
nslookup api.github.com

curl -I --proxy socks5h://127.0.0.1:7891 https://github.com

如果系统解析失败,但 socks5h 测试成功,说明本地 DNS 不一定是唯一可用路径,应用应尽量让代理侧处理域名。若系统和代理解析都成功,但 HTTPS 仍然超时,则重点查看节点连通性、IPv6 路径、TLS 握手日志以及本机安全软件是否拦截了 VS Code。

不要为了绕过证书错误而关闭 proxyStrictSSL 或系统证书验证。先确认操作系统日期和时间正确,更新 VS Code 与 Copilot 扩展,检查企业网络是否要求安装根证书,并查看 Clash 日志中是否出现握手失败、连接被重置或上游超时。

通过 Copilot 日志定位认证与补全阶段

当普通 GitHub 页面和 API 都能访问,但 Copilot 仍然失败时,问题可能已经从网络层进入认证或扩展层。此时应打开 VS Code 的“输出”面板,在下拉列表中查看 GitHub、GitHub Copilot、GitHub Copilot Chat 等相关日志。不同版本的扩展名称可能略有差异,重点是记录错误发生的阶段。

如果日志中包含请求 ID、账户信息、访问令牌或完整 URL,分享问题时应先打码。不要把包含认证令牌的日志、订阅地址或完整配置直接发布到公开平台。需要对比时,保留错误类型、时间、目标域名和状态码即可。

还可以执行“Developer: Show Running Extensions”确认 Copilot 扩展是否正常启动,执行“Developer: Toggle Developer Tools”查看网络相关错误。开发者工具中的错误信息可能包含敏感参数,同样应在复制前清理。

按最小改动流程完成修复

如果前面的检查发现多个问题,不建议一次性重装 VS Code、替换配置、切换 DNS 和更换节点。更稳妥的修复顺序如下:

  1. 确认 Clash 内核运行。记录当前配置名称、内核版本、本地 HTTP 或 mixed-port,并检查端口确实处于监听状态。
  2. 显式测试代理。使用 curl 访问 GitHub 和 API,确认本地端口、节点和基本 DNS 路径可用。
  3. 固定一个稳定节点。暂时不要使用自动选择或频繁测速的策略组,避免测试结果不断变化。
  4. 核对 VS Code 设置。确认 http.proxy 指向正确端口,必要时临时使用 http.proxySupport: override 验证。
  5. 检查连接记录。触发一次登录和一次补全,记录所有实际访问的 GitHub 相关域名及命中规则。
  6. 补充最小规则。只为确认过的域名增加代理规则,并将其放在会提前命中的宽泛规则之前。
  7. 再处理 DNS。对照测试 IPv6、Fake IP、上游 DNS 和代理侧解析,确认改变 DNS 后是否真正改善。
  8. 重新加载并观察日志。执行 VS Code 窗口重载,重新登录 Copilot,等待连接记录和扩展输出稳定后再恢复自动策略。

修复完成后,可以逐项恢复原来的设置:先恢复自动节点选择,再恢复原 DNS 模式,最后移除临时的 VS Code 代理覆盖。每恢复一项就测试一次。如果某一步重新出现超时,基本可以确定问题范围,避免以后再次遇到同样故障时从头猜测。

下载Clash