WSL2中Git配置失败求助：无法访问GitHub
2026-8-4
WSL中Git配置及访问GitHub错误解决方法
一、确认Git安装状态
- 先检查Git是否已安装：
git --version - 未安装的话，根据WSL发行版执行安装命令：
- Ubuntu/Debian：
sudo apt update && sudo apt install git -y - CentOS/RHEL：
sudo dnf install git -y
- Ubuntu/Debian：
二、基础Git配置
- 设置全局用户名：
git config --global user.name "你的GitHub用户名" - 设置全局邮箱：
git config --global user.email "你的GitHub绑定邮箱" - 验证配置：
git config --list，能看到刚才设置的name和email即为生效
三、解决"fatal: unable to access 'https://github.com'"错误
这个错误大多和网络、证书或连接方式有关，按以下步骤排查：
1. 检查网络连通性
- 测试能否访问GitHub：
ping github.com - 若不通，先重启WSL：在Windows终端执行
wsl --shutdown，再重新打开WSL - 如果主机用了代理，需要给WSL设置代理环境变量（替换成你的代理IP和端口）：
主机IP可通过WSL内执行export http_proxy=http://192.168.xx.xx:xxxx export https_proxy=http://192.168.xx.xx:xxxxcat /etc/resolv.conf查看nameserver后的地址
2. 修复SSL证书问题
- 临时关闭SSL验证（仅测试用）：
git config --global http.sslVerify false - 正规做法是更新系统证书：Ubuntu/Debian执行
sudo apt install ca-certificates -y && sudo update-ca-certificates
3. 改用SSH连接（推荐长期使用）
HTTPS容易出网络问题，SSH连接更稳定：
- 生成SSH密钥：
ssh-keygen -t ed25519 -C "你的GitHub绑定邮箱"，全程回车用默认设置 - 复制公钥内容：
cat ~/.ssh/id_ed25519.pub - 登录GitHub，进入「Settings」→「SSH and GPG keys」，点击「New SSH key」，粘贴公钥并保存
- 测试连接：
ssh -T git@github.com，看到Hi xxx! You've successfully authenticated...即为成功 - 设置Git默认用SSH替代HTTPS：
git config --global url."git@github.com:".insteadOf "https://github.com/"
内容的提问来源于stack exchange，提问作者hola
相关产品推荐
相关产品推荐
