VS Code + WSL 环境下 GitHub 访问及 Copilot 连接问题解决方案
最近排查了一个典型的开发环境问题：在 VS Code 配合 WSL 时，GitHub 克隆失败，Copilot 和 Codex 长时间卡在 "Thinking..."。这里记录一下完整的排查思路和解决步骤。
一、问题现象
在使用 VS Code + WSL 进行开发时，可能会遇到以下两个核心痛点：
- Git clone 失败
fatal: unable to access 'https://github.com/...': Failed to connect to 172.xx.xx.xx port xxxx - Copilot / Codex 一直 "Thinking…"
- 无法生成代码补全
- 界面长时间转圈
- VS Code 日志提示连接境外服务失败
二、核心原因：理解 WSL 网络结构
要解决这个问题，必须先搞清楚 WSL 的网络层级。WSL 的网络其实分三层：
| 层级 | 归属 | 特点 |
|---|---|---|
| Windows 主机 | VS Code 本体、代理软件运行处 | 使用主机物理网络出口 |
| WSL Linux | Git、curl、Copilot 后台进程 | 127.0.0.1 指的是 WSL 内部 |
| Remote WSL 扩展 | VS Code 与 WSL 的桥梁 | 依赖两端配置同步 |
关键点在于： WSL 中的 127.0.0.1 并不是 Windows 主机，而是 Linux 自身。
当需要访问 GitHub 或 Copilot 等境外服务时，WSL 必须正确转发到主机的网络出口。你可以通过以下命令查询当前 WSL 的主机出口地址：
cat /etc/resolv.conf | grep nameserver
示例输出：
nameserver 172.25.176.1
注意这个地址每次重启电脑可能会变，所以硬编码 IP 的方案很容易失效。
三、Git Clone 不稳定的修复方案
1. 清理错误的代理配置
有时候之前的配置残留会导致冲突，建议先彻底清理：
git config --unset http.proxy
git config --unset https.proxy
git config --global --unset http.proxy
git config --global --unset https.proxy
unset HTTP_PROXY HTTPS_PROXY http_proxy https_proxy ALL_PROXY all_proxy
2. 测试直连能力
执行以下命令检查 WSL 是否能直接访问 GitHub：
curl -I https://github.com
如果返回 HTTP/2 200，说明直连正常。
3. 配置动态代理（如需）
如果你使用了网络加速工具，需要在 WSL 中写入对应的主机出口地址。假设你的中转端口是 7890：
export HTTP_PROXY="http://172.25.176.1:7890"
export HTTPS_PROXY="http://172.25.176.1:7890"
git config --global http.proxy http://172.25.176.1:7890
git config --global https.proxy http://172.25.176.1:7890
⚠️ 注意：这里的 IP 地址不要写死，因为重启后它可能会变。
四、VS Code Copilot/Codex 卡 "Thinking" 的解决步骤
修改 VS Code 配置
打开设置 JSON 文件（快捷键 Ctrl + Shift + P → Preferences: Open Settings (JSON)），添加或修改以下内容：
{
"http.proxySupport": "on",
"http.systemProxy": false,
"http.proxyStrictSSL": false,
"terminal.integrated.env.linux": {
"NO_PROXY": "localhost,127.0.0.1,::1,.local"
}
}
⚠️ 不要在这里写死
"http.proxy"，因为主机出口 IP 是会变化的。VS Code 会自动继承 WSL 的环境变量。
五、永久解决：自动检测并更新网络出口脚本
为了应对 IP 变化导致的问题，我整理了一个自动化脚本。它能自动读取当前的网关 IP 并配置环境变量。
将下面的内容保存为 ~/fix_vscode_wsl_proxy.sh：
#!/usr/bin/env bash
set -e
# ==============================
# VS Code + WSL 外网连通性一键修复脚本
# 可在访问境外开发资源（如 GitHub、Copilot）异常时使用
# ==============================
PORT="${PORT:-7890}"
echo "🔍 正在读取主机出口 IP ..."
HOST_IP=$(awk '/^nameserver/ {print $2; exit}' /etc/resolv.conf || true)
if [ -z "$HOST_IP" ]; then
echo "❌ 未找到 nameserver，请手动检查 /etc/resolv.conf"
exit 1
fi
echo "✅ 主机出口 IP: ${HOST_IP}"
echo " 使用端口：${PORT}"
export HTTP_PROXY="http://${HOST_IP}:${PORT}"
export HTTPS_PROXY="http://${HOST_IP}:${PORT}"
echo ""
echo "🧪 正在测试 Copilot 连接 ..."
set +e
curl -I --max-time 5 --proxy "http://${HOST_IP}:${PORT}" https://api.githubcopilot.com
set -e
echo ""
echo "📝 写入 ~/.bashrc 自动配置 ..."
BASHRC="${HOME}/.bashrc"
MARK="WSL auto network config"
if ! grep -q "${MARK}" "$BASHRC" 2>/dev/null; then
cat >> "$BASHRC" <<EOF
# === ${MARK} ===
HOST_IP=\$(awk '/^nameserver/ {print \$2; exit}' /etc/resolv.conf)
if [ -n "\$HOST_IP" ]; then
export HTTP_PROXY="http://\${HOST_IP}:${PORT}"
export HTTPS_PROXY="http://\${HOST_IP}:${PORT}"
fi
# === End of ${MARK} ===
EOF
echo "✅ 已写入 ~/.bashrc"
else
echo "ℹ️ 自动配置已存在"
fi
echo "🎉 完成，重启 VS Code (Remote WSL) 可立即生效。"
使用方法
nano ~/fix_vscode_wsl_proxy.sh
chmod +x ~/fix_vscode_wsl_proxy.sh
./fix_vscode_wsl_proxy.sh
source ~/.bashrc
六、验证是否成功
完成上述操作后，请确认以下几点：
- Git 能正常 clone 仓库
- curl 可以正常访问 GitHub
- Copilot 能正常返回响应
- VS Code 不再卡在 "Thinking…"
- 重启电脑后无需手动重新配置
七、总结
| 问题 | 根因 | 解决方案 |
|---|---|---|
| Git clone 失败 | 出口 IP 变化、未正确连接外部服务 | 在 WSL 中更新主机出口 IP |
| Copilot 卡住 | VS Code 未继承正确的网络代理 | VS Code 使用 WSL 环境变量 |
| 每次重启都要重新设置 | 主机 IP 每次变化 | 使用自动修复脚本 |
通过这套组合拳，基本能解决国内环境下 WSL 开发遇到的大部分网络阻塞问题。