git连接远程GitHub仓库详细总结 for HTTPS协议

约定不等于承诺〃 2023-10-14 09:54 159阅读 0赞

**git远程连接GitHub有四种传输协议：**

**l 本地协议（local）**

**l git协议**

**l HTTPS**

**l SSH**

由于现在大多数都是远程操作及多人共享，本地协议（local）就有些局限了，因此不常用。而git协议缺乏授权机制，并且搭建也比较困难，因此也不常用。

常用的也就是HTTPS和SSH这两中协议了，这种协议的传输速度都挺快，HTTPS适合开源的项目，SSH协议更适合企业内部项目。

**本篇介绍下通过HTTPS协议连接GitHub仓库；**

**本篇使用Android项目 + Mac来完成操作（Windows系统也差不多一样）。**

### 一、注册GitHub账号（有的话可以忽略此步） ###

登录GitHub官网，点击右上角 sign up，接下来按提示完成就好。

### 二、在GitHub上创建一个项目 ###

登录后点击右上角 + 号，点击New Repository，见下图：

![format_png][]

### 三、安装git（已经安装过的可以忽略此步） ###

1、安装git

Mac：

git --version

Linus：

sudo dnf install git-all

Ubuntu：

sudo apt install git-all

Windows：命令行下载比较麻烦，还得下载依赖库，去官网下载安装即可

2、配置git

git config --global user.name “your namen”

git config --global user.email “your email”

### 四、创建本地git仓库 ###

创建git本地仓库有两种形式（根据自己的需要，选其一中实现即可）：

1、通过git init方式创建

在项目的文件夹下运行git init，这样就会在项目的文件夹下创建.git文件，例如 MyProject是我的项目文件夹，在终端输入：

cd Users/user/MyProject

git init

2、通过git clone方式创建

git clone 是把GitHub上的仓库给拉取下来，说白点就是复制GitHub的仓库粘贴到本 地电脑上，远程的仓库克隆到本地后也就是在本地创建了一个文件夹，同时文件夹内会 自动创建好.git文件。在终端输入：

git clone https://github.com/zhangsan/android-project/MyProjiect.git

注意上面的链接最好复制GitHub仓库中的，这样不容易出错，详见下图：

![format_png 1][]

最后再把自己的项目复制到MyProject里就行了。

### 五、提交代码 ###

完成以上的操作后，本地的git仓库就已经创建好了，接下来就可以看到代码状态和提 交代码了，终端输入以下命令：

git status

git add *

git commit -m "first commit"

### 六、连接远程GitHub仓库 ###

1、创建GitHub令牌

登录GitHub -- 点击 + 号 -- Settings -- Developer Settings -- Personal access tokens

进入后点击右上角生成令牌按钮，弹出页面后按照要求创建就好。

切记要选择令牌的权限，否则最后push的时候会报错，提示没有权限访问。

![format_png 2][]

2、关联远程GitHub仓库

git remote set-url origin https://github.com/zhangsan/android-project/MyProject.git

然后我们可以查看下设置情况

git show remote origin

3、上传代码到GitHub仓库

git push origin master

注意：push的过程中会让输入账号和密码，账号就是你注册GitHub的用户名（用户名区分大小写），密码就是你刚刚生成的令牌。

**你以为新手到这里就完事儿了？**

**接着往下看↓↓↓遇到的坑**

1、git push的时候提示fatal: unable to access '[https://github.com/EdenLiyan/android-project/MyProject.git/'][https_github.com_EdenLiyan_android-project_MyProject.git]: LibreSSL SSL\_connect: SSL\_ERROR\_SYSCALL in connection to [github.com:443][github.com_443]

答：这个问题是提示连接到GitHub时候http请求出错了，因为GitHub是国外网站，本身国内访问就很慢，通过终端操作同样也会出现此问题。解决方案就是重新再push一下就好了

2、git push的时候提示remote: Repository not found. fatal: repository '[https://github.com/android-project/MyProject.git/'][https_github.com_android-project_MyProject.git] not found

答：这个问题的原因有很多，也可以看下[官方回答][Link 1]。我是开始在GitHub上创建仓库是设置的是private，后来又改成public就好了。也可以参考下[StackOverflow上的回答][StackOverflow]。

3、git push的时候提示remote: Permission to EdenLiyan/HealthData.git denied to EdenLiyan. fatal: unable to access '[https://github.com/android-project/MyProject.git/'][https_github.com_android-project_MyProject.git]: The requested URL returned error: 403

答：这个问题就是设置令牌的时候没有勾选权限导致的，可以看下本文中介绍的第六项第1条。

[format_png]: https://img-blog.csdnimg.cn/img_convert/71c1a2b7f8a3062abdc24ebc504bbfba.webp?x-oss-process=image/format,png
[format_png 1]: https://img-blog.csdnimg.cn/img_convert/8066ef917b11672b038d35ef569d3b54.webp?x-oss-process=image/format,png
[format_png 2]: https://img-blog.csdnimg.cn/img_convert/134c715e91db423dafe3e4b17e9b2d8b.webp?x-oss-process=image/format,png
[https_github.com_EdenLiyan_android-project_MyProject.git]: https://links.jianshu.com/go?to=https%3A%2F%2Fgithub.com%2FEdenLiyan%2Fandroid-project%2FMyProject.git%2F%27
[github.com_443]: https://links.jianshu.com/go?to=http%3A%2F%2Fgithub.com%3A443
[https_github.com_android-project_MyProject.git]: https://links.jianshu.com/go?to=https%3A%2F%2Fgithub.com%2Fandroid-project%2FMyProject.git%2F%27
[Link 1]: https://links.jianshu.com/go?to=https%3A%2F%2Fdocs.github.com%2Fen%2Fgithub%2Fcreating-cloning-and-archiving-repositories%2Fcloning-a-repository-from-github%2Ferror-repository-not-found%23checking-your-permissions
[StackOverflow]: https://links.jianshu.com/go?to=https%3A%2F%2Fstackoverflow.com%2Fquestions%2F37813568%2Fgit-remote-repository-not-found