VS Code + WSL 环境下 GitHub 及 Copilot 连接异常修复方案

VS Code + WSL 环境下 GitHub 及 Copilot 连接异常修复方案

在 Windows 上使用 VS Code 配合 WSL 开发时，经常会遇到 GitHub 克隆失败，或者 Copilot、Codex 等 AI 助手长时间卡在 "Thinking..." 状态。这通常不是软件本身的 bug，而是网络出口配置的问题。

问题现象

1. Git clone 报错

   fatal: unable to access 'https://github.com/...': Failed to connect to 172.xx.xx.xx port xxxx
   

2. 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 网络转发的原理，配合上述脚本，就能在本地获得稳定的远程开发体验。