VS Code + WSL 环境下 GitHub 及 Copilot 连接异常修复方案
在 Windows 上使用 VS Code 配合 WSL 开发时，经常会遇到 GitHub 克隆失败，或者 Copilot、Codex 等 AI 助手长时间卡在 "Thinking..." 状态。这通常不是软件本身的 bug，而是网络出口配置的问题。
问题现象
- Git clone 报错
fatal: unable to access 'https://github.com/...': Failed to connect to 172.xx.xx.xx port xxxx - AI 助手无响应
- Copilot/Codex 无法生成补全
- 日志提示连接境外服务超时或失败
核心原因：WSL 的网络结构
理解这一点至关重要。WSL 的网络环境分为三层：
| 层级 | 归属 | 特点 |
|---|---|---|
| Windows 主机 | VS Code 本体、代理软件 | 使用主机物理网卡 |
| WSL Linux | Git、Copilot 后台进程 | 127.0.0.1 指向 WSL 自身 |
| Remote WSL 扩展 | VS Code 与 WSL 的桥梁 | 依赖两端网络互通 |
关键点： WSL 中的 127.0.0.1 是 Linux 内部地址，不是 Windows。当需要访问 GitHub 等境外服务时，WSL 必须通过主机的网络出口（通常是 172.x.x.x）转发流量。
可以通过以下命令查看当前 WSL 的主机出口 IP：
cat /etc/resolv.conf | grep nameserver
示例输出：
nameserver 172.25.176.1
注意这个 IP 每次重启电脑可能会变，这也是为什么手动配置容易失效的原因。
解决步骤
1. 清理错误的代理配置
首先确保没有残留的旧配置干扰。在 WSL 终端执行：
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. 测试直连能力
尝试直接访问 GitHub，确认基础连通性：
curl -I https://github.com
如果返回 HTTP/2 200，说明网络层已通畅。
3. 配置 VS Code 设置
打开 VS Code 设置（JSON 格式），添加以下配置。注意不要写死代理地址，让 VS Code 继承环境变量即可：
{
"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 是动态的。
自动化方案：一键修复脚本
为了应对 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 不再卡住，能正常返回内容
- 重启电脑后无需重复配置
总结
| 问题 | 根因 | 解决方案 |
|---|---|---|
| Git clone 失败 | 出口 IP 变化、未正确连接外部服务 | 在 WSL 中更新主机出口 IP |
| Copilot 卡住 | VS Code 未继承正确的网络代理 | VS Code 使用 WSL 环境变量 |
| 每次重启都要重新设置 | 主机 IP 每次变化 | 使用自动修复脚本 |
只要掌握了 WSL 网络转发的原理，配合上述脚本，就能在本地获得稳定的远程开发体验。
