linux或是windows git clone不成功的各种可能原因

原创已于 2025-04-04 16:33:59 修改 · 2k 阅读

1 ·

CC 4.0 BY-SA版权

文章标签：

#git #git clone常见问题 #Windows git客户端 #MacOS git客户端 #CentOS git客户端

于 2021-04-11 21:16:30 首次发布

Linux 同时被 3 个专栏收录

7 篇文章

订阅专栏

Shell

5 篇文章

订阅专栏

运维

5 篇文章

订阅专栏

本文针对在Windows和Linux环境下使用Git时遇到的权限问题提供了解决方案。包括清理本地配置、更新Git版本以及直接指定账号密码进行克隆等方法。

软件环境

Windows git 命令客户端：Git for Windows

Windows git 图形客户端：TortoiseGit – Windows Shell Interface to Git

Mac OS 安装git命令，推荐使用brew安装：

brew install git

Mac OS 安装git命令, 安装包下载: Git - Downloading Package

Cent OS 安装git命令 ，推荐使用yum安装：

sudo yum install git

前提：账号密码一定是正确的

Windows:

报权限问题一般原因:

git密码修改后本地存的配置没有清理，每次使用的原密码，所以clone时一直报密码不对之类的

解决方案：

密码失效：
git config --global http.sslVerify false
git config –global http.emptyAuth true

Linux:

报权限问题一般原因:

1、问题场景一及解决方案同上windows

2、对于登陆账号为邮箱的场景登陆报密码不对也可能是用为linux配置中user.name使用邮箱gitserver不认

解决方案：

需将邮箱@的前面部分设置为user.name，如：

git clone https://username@git.oschina.net/daizd/mycloud.git

另外：linux建议升级git到最新版，比如：2021年最新的centos7自动git-1.8.3, 此时官方最新的版本号为：2.31.1

通用解决方案：

不管是什么操作系统（linux还是windows或是MacOS）,可以不使用配置文件，clone时直接指定账号，如：

git clone https://username:password@git.oschina.net/daizd/mycloud.git

git clone不成功的其他可能原因

URL错误：

确保你输入的仓库URL是正确的。检查是否有拼写错误，例如使用了https而不是http，或者仓库的URL已经变更。

网络问题：

确认你的设备可以访问互联网。
如果你在使用公司或学校的网络，可能存在网络代理或防火墙限制。尝试配置或绕过这些限制。
使用ping命令测试网络连接，例如：ping github.com（如果你在尝试克隆GitHub上的项目）。

Git版本过旧：

确保你的Git版本是最新的。可以通过运行git --version来检查当前版本，然后访问Git官网下载最新版本。
更新Git可以使用包管理器，例如在Ubuntu上使用sudo apt-get install git，在Windows上可以通过Git的官方安装程序更新。

权限问题：

如果你尝试克隆一个私有仓库，确保你有足够的权限。对于私有仓库，你可能需要提供用户名和密码，或者使用SSH密钥认证。
对于SSH密钥，确保你的SSH密钥已添加到你的Git服务账户（如GitHub、GitLab等）中，并且SSH代理正在运行（使用ssh-add）

仓库不存在或已删除：

确认仓库URL指向的仓库是存在的。访问该URL看是否能正常访问到仓库页面。
仓库可能已被删除或重命名，检查是否有最新的文档或通知。

磁盘空间不足：

确认你的本地磁盘有足够的空间来克隆仓库。使用df -h命令查看磁盘空间使用情况。

代理设置问题：

如果你的网络环境需要通过代理访问外网，确保Git配置了正确的代理设置。你可以通过设置环境变量或修改Git配置文件来配置代理，例如：

git config --global http.proxy 'http://proxy.server:port'
git config --global https.proxy 'http://proxy.server:port'

完成后，可以通过git config --global --list来检查代理设置是否正确。

SSL证书问题（较少见）：

如果你在使用HTTPS克隆时遇到SSL证书验证问题，可以尝试使用git clone命令的--depth选项来减少克隆的数据量，或者尝试更新你的Git和操作系统的SSL证书库

使用SSH而非HTTPS：

如果你更倾向于使用SSH方式克隆，确保你的SSH密钥已添加到你的账户设置中，并且SSH客户端配置正确。
使用SSH URL而非HTTPS URL进行克隆，例如：

git clone git@github.com:username/repository.git