Git无法连接远程仓库90%非Git本身问题，需逐层排查：先验DNS解析，再查SSH端口与私钥权限（600），HTTPS则关注证书、凭据管理器及访问令牌，最后核对URL准确性。
Git无法连接远程仓库，90%不是Git本身的问题，而是网络、协议或凭据卡在了某一层——得一层层剥开看。
检查域名能否解析（先确认系统连得上那个地址）
Git报 fatal: unable to access 或直接卡住，第一反应不该是改remote或重配密钥，而是看系统能不能把远程域名转成IP。很多公司内网、校园网或代理环境里，gitcode.net 或 github.com 根本解析不出来。
- 执行
nslookup gitcode.net（把域名换成你实际用的）；如果返回server can't find或超时，就是DNS问题 - 试公共DNS：
nslookup gitcode.net 8.8.8.8，能通说明本地DNS异常 - 检查
/etc/hosts（macOS/Linux）或C:\Windows\System32\drivers\etc\hosts（Windows），删掉可能存在的错误映射行 - 切手机热点再试一次：能通就坐实是当前网络环境限制
验证SSH端口与私钥权限（仅限SSH协议）
SSH失败时，Permission denied (publickey) 常被误判为“密钥没加”，其实更大概率是端口不通，或私钥权限太松导致OpenSSH直接拒绝加载。
Convert Github Repository
下载
适用于以下场景：（1）用户提供 GitHub 仓库 URL 或本地仓库路径，并请求将其转换为其他格式；（2）用户请求导出 GitHub 仓库……
- 测试端口连通性：
nc -zv gitcode.net 22（无nc可用telnet gitcode.net 22）；卡住或超时，说明22端口被防火墙屏蔽 - 私钥必须是600权限：
chmod 600 ~/.ssh/id_rsa，否则OpenSSH不认 - 公钥是否已粘贴到GitCode？注意别多空格、少换行，也别用GitHub CLI生成的密钥去配GitCode
- 用
ssh -T git@gitcode.net测试，看到 welcome 信息才算通
HTTPS方式下凭据与证书问题（别关sslVerify）
HTTPS报 SSL certificate problem 或 401 Unauthorized，常见于企业代理、自建Git服务或老旧OpenSSL版本。直接关掉验证是危险操作——尤其当你用账号密码认证时，后续所有请求都会明文传密码。
- 更安全做法：导出企业根证书为PEM文件，然后指定路径：
git config --global http.sslCAInfo /path/to/company-ca.pem - Windows用户常因凭据管理器存了旧密码导致失败，用
git credential reject清理（回车后手动填protocol=https、host=gitcode.net） - GitCode等平台已停用密码登录，必须用访问令牌（Personal Access Token）代替密码；令牌需在平台设置中创建，并勾选
repo权限 - URL中含
@或?时需URL编码，否则Git解析会错乱
确认远程URL是否匹配且仓库真实存在
执行 git remote -v 查看当前配置的URL，和你在GitCode网页端看到的仓库地址逐字比对。漏写 .git、多一个 /、用户名写错、仓库名大小写不一致，都可能导致 Repository not found。
- 浏览器直接打开该URL，看是否能正常访问仓库首页；打不开，说明仓库不存在、已被删除、或你没权限
- 私有仓库需确认自己已在
Settings → Collaborators列表中；不在就联系管理员 - 若URL正确但仍是404，可能是仓库被重命名或迁移，需更新remote：
git remote set-url origin https://gitcode.net/新用户名/新仓库名.git
真正麻烦的不是某一步错了，而是多个环节叠加：比如DNS解析慢 + 私钥权限不对 + 凭据管理器存了过期令牌。建议按顺序排查，每步验证输出，别跳步。特别是SSH和HTTPS混用时，git remote -v 输出的URL类型必须和你的认证方式一致。
