# 第 24 天：使用 GitHub 远端仓库 - 入门篇

GitHub 是目前全世界最多人采用的 Git 线上管理平台，他包含了完整的 Git 远端仓库实作，还有完整的议题追踪机制与报表，更有成千上万的开源码项目都在 GitHub 进行 Git 版本控制。即便在我们公司，也有许多项目采用 GitHub 当成我们主要的 Git 平台。本篇文章主要带大家上手 GitHub 最基本的使用方式。

我们先来说明在 GitHub 建立项目的两种不同的方式。

## 在 GitHub 建立一个「**没有版本**」的空白 Git 仓库

先登入 GitHub，再进入 GitHub 首页： <https://github.com>

点选右上角你的使用者名称进入个人首页：

![image](https://1991450022-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fj2h2C95aFkfa08k9hVd3%2Fuploads%2Fgit-blob-50ce2350b38fdd610e02f8ee0b8533b0f01fb18b%2F01.png?alt=media)

切换到 **Repositories** 页签：

![image](https://1991450022-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fj2h2C95aFkfa08k9hVd3%2Fuploads%2Fgit-blob-6effc33e5e993b9ccf2ede5ac6e764ed7138591b%2F02.png?alt=media)

再点选右边绿色的 **New** 按钮，以建立一个你自己的 GitHub 项目 (包含 Git 远端仓库)：

![image](https://1991450022-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fj2h2C95aFkfa08k9hVd3%2Fuploads%2Fgit-blob-57e167239d095102675bbc7e714e8d14e69d8140%2F03.png?alt=media)

如果你要建立一个「**没有版本**」的空白 Git 仓库，最重要的就是最下方的 **Initialize this repository with a README** 不要勾选，还有 **Add .gitignore** 与 **Add a licenes** 都保留预设的 **None** 选项：

![image](https://1991450022-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fj2h2C95aFkfa08k9hVd3%2Fuploads%2Fgit-blob-76a09701250a59683688bbdbfe364938a1d9f155%2F04.png?alt=media)

最后按下 **Create repository** 即可建立完成，当你建立起一个「**没有版本**」的空白 Git 仓库之后，画面最下方也提到了几个让你上传本地 Git 仓库的指令教学，照着打就可以把本地仓库的变更上传到 GitHub 的远端仓库中。

![image](https://1991450022-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fj2h2C95aFkfa08k9hVd3%2Fuploads%2Fgit-blob-1aca1dfde6af8f6b99c30705f21601424552b8f7%2F05.png?alt=media)

## 在 GitHub 建立一个「**有初始化版本**」的 Git 仓库

建立一个「**有初始化版本**」的空白 Git 仓库，其实就是在 GitHub 建立项目时，勾选了一些初始化的文件，在建立的过程 GitHub 会依据你所挑选的选项，先帮你建立好一个初始化的 Git 版本：

![image](https://1991450022-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fj2h2C95aFkfa08k9hVd3%2Fuploads%2Fgit-blob-03fe5b54ab6fe852452ad5a0fbc291f7725f1071%2F06.png?alt=media)

建立完成后，在 GitHub 上显示的内容会不太一样，因为你已经有一个 commit 版本在上面了：

![image](https://1991450022-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fj2h2C95aFkfa08k9hVd3%2Fuploads%2Fgit-blob-6e3bbb1338e68f51290a7553b3affe73a48e6a3c%2F07.png?alt=media)

## 将本地仓库的变更上传到远端仓库的方法

我有在【第 03 天：建立仓库】这篇文章中提到如何取得从 GitHub 建立的远端仓库 (remote repository)，不过若要将本地变更送上 GitHub 则有好几种不同的方式，其中包括：

1. 在 GitHub 建立一个「**没有版本**」的空白 Git 仓库，然后通过 `git clone` 取得远端仓库，再建立版本后上传
2. 在 GitHub 建立一个「**没有版本**」的空白 Git 仓库，然后直接将现有的本地 Git 仓库上传到指定的 GitHub 项目
3. 在 GitHub 建立一个「**有初始化版本**」的 Git 仓库，然后通过 `git clone` 取得远端仓库，再建立版本后上传
4. 在 GitHub 建立一个「**有初始化版本**」的 Git 仓库，然后直接将现有的本地 Git 仓库上传到指定的 GitHub 项目

以上就是我们首次使用 GitHub 时，最常见的四种上传方式。严格说起来，上述四种上传方式，应该只有两种而已，也就是：

1. 通过 `git clone` 取得远端仓库，再建立版本后上传
2. 直接将现有的本地 Git 仓库上传到指定的 GitHub 项目

为什么我想拆成四个来讲呢？主要有两个原因：

1. 【通过 `git clone` 取得远端仓库，再建立版本后上传】的这种方式，因为「**没有版本**」的空白 Git 仓库，连预设的 `master` 分支都没有，所以用预设的指令无法上传到远端仓库。所以在指令操作上会有两种用法。
2. 【直接将现有的本地 Git 仓库上传到指定的 GitHub 项目】的这种方式，因为通常一个 Git 仓库只会有一个「初始 commit 物件」，如果你在本地仓库已经建立了几个版本，代表在你的本地仓库中已经有了自己的「初始 commit 物件」，这将会与 GitHub 建立的「**有初始化版本**」的 Git 仓库相互冲突，所以上传的指令也会有些不同。

以下我们先来说明【**通过 `git clone` 取得远端仓库，再建立版本后上传**】这个方法。

## 通过 `git clone` 取得远端仓库，再建立版本后上传

这个方法最简单，因为你还没有本地仓库的存在，什至连工作目录都还没有，所以我们直接利用 `git clone` 即可把项目下载。然而，在使用 GitHub 的时候，最简单的方法就是利用 GitHub for Windows 工具。你只要点击 **Clone in Desktop** 按钮，即可自动启动 GitHub for Windows 工具帮你下载 Git 项目：

* 「**没有版本**」的空白 Git 仓库

  ![image](https://1991450022-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fj2h2C95aFkfa08k9hVd3%2Fuploads%2Fgit-blob-9f0c10444278a506fc6d19fafed0650ee1d06015%2F08.png?alt=media)
* 「**有初始化版本**」的 Git 仓库

  ![image](https://1991450022-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fj2h2C95aFkfa08k9hVd3%2Fuploads%2Fgit-blob-e836d292447fc25b78f0af1be87767854d56362d%2F09.png?alt=media)

你也可以直接复制 GitHub 提供的 URL 网址，然后利用 `git clone` 指令下载，例如：

![image](https://1991450022-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fj2h2C95aFkfa08k9hVd3%2Fuploads%2Fgit-blob-633ff90521eaa92f7501d1cce2c11d8954e2703f%2F10.png?alt=media)

如果你用 `git clone https://github.com/doggy8088/sandbox-empty.git` 复制一个 「**没有版本**」的空白 Git 仓库，将会得到一个 **warning: You appear to have cloned an empty repository.** 警告消息，不过这不影响你上传本地的变更。

如果你用 `git clone https://github.com/doggy8088/sandbox-initialized.git` 复制一个 「**有初始化版本**」的 Git 仓库，将会直接从 GitHub 下载拥有完整变更历史的「远端仓库」，所以你会看到有下载物件数量、压缩、解压缩等信息。

我们以 `sandbox-empty` 这个项目为例，由于这是一个 「**没有版本**」的空白 Git 仓库，在 GitHub 上的远端仓库是完全空的，连预设的 `master` 分支都没有，所以在下达 `git push` 指令时必须加上 `-u` 参数，才能成功地把本地仓库上传到 GitHub 上的远端仓库，其指令是 `git push -u origin master`

![image](https://1991450022-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fj2h2C95aFkfa08k9hVd3%2Fuploads%2Fgit-blob-a76d1ad78f905aa91b946b94e0d8ceee18d54d0b%2F11.png?alt=media)

![image](https://1991450022-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fj2h2C95aFkfa08k9hVd3%2Fuploads%2Fgit-blob-5675fcd287d80d48c25df8cc1b12224b91bdbb0c%2F12.png?alt=media)

我们再以 `sandbox-initialized` 这个项目为例，由于这是一个 「**有初始化版本**」的 Git 仓库，在 GitHub 上的远端仓库已经有一个版本，同时也建立好预设的 `master` 分支，所以在下达 `git push` 指令时可以不用加上 `-u` 参数，就成功地把本地仓库上传到 GitHub 上的远端仓库，其指令是 `git push origin master`

![image](https://1991450022-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fj2h2C95aFkfa08k9hVd3%2Fuploads%2Fgit-blob-dc9570d509950655afde1b7cd6918699767ad968%2F13.png?alt=media)

当你第二次建立版本时，直接执行 `git push` 就会自动上传成功：

![image](https://1991450022-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fj2h2C95aFkfa08k9hVd3%2Fuploads%2Fgit-blob-d95c17761714b648e0fdaab0fd7d8ab9b58cdffb%2F14.png?alt=media)

![image](https://1991450022-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fj2h2C95aFkfa08k9hVd3%2Fuploads%2Fgit-blob-57cbf8cf39f1a9ef9b5763a0d64e9ff7fa80879f%2F15.jpg?alt=media)

不过，当你执行简单版本的 `git push` 会出现一段提示，告诉你要设定 `push.default` 这个选项，因为这种简写的 `git push` 方法，Git 的预设行为将会在 Git 2.0 之后发生改变，建议你通过设定 `push.default` 选项的方式明确指定 push 的方法。详细说明请参见 `git help config` 的说明文件，搜寻 `push.default` 即可找到相关说明。我建议各位设定成 `simple`，以利跟日后的 Git 指令列工具的预设值相同，指令如下：

```
git config --global push.default simple
```

设定好之后，下次执行 `git push` 就不会再出现提示消息了：

![image](https://1991450022-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fj2h2C95aFkfa08k9hVd3%2Fuploads%2Fgit-blob-2709f9388b62704a4fd3d5f3aed37ee34cffe129%2F16.png?alt=media)

之后的操作，在我们这两个练习用的工作目录都完全一样。

![image](https://1991450022-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fj2h2C95aFkfa08k9hVd3%2Fuploads%2Fgit-blob-7ef0db8ef9ec07076df7e2ac8fccc259748a9c64%2F17.png?alt=media)

## 直接将现有的本地 Git 仓库上传到指定的 GitHub 项目

接下来我们再来说明【**直接将现有的本地 Git 仓库上传到指定的 GitHub 项目**】这个方法。但由于练习用的 GitHub 项目已经被上传一些物件，所以请各位重新再建立两个新项目，分別是一个「**没有版本**」的空白 Git 仓库，与另一个「**有初始化版本**」的 Git 仓库。

一个「**没有版本**」的 Git 仓库，项目名称：`sandbox-empty2` 一个「**有初始化版本**」的空白 Git 仓库，项目名称：`sandbox-initialized2`

接着我们建立两个本地仓库与工作目录，指令如下：

```
mkdir sandbox-empty2
cd sandbox-empty2

git init

echo a > a.txt
git add .
git commit -m "Initial commit"

cd ..
mkdir sandbox-initialized2
cd sandbox-initialized2

git init

echo a > a.txt
git add .
git commit -m "Initial commit"
```

我们先以 `sandbox-empty2` 项目为例，由于我们本地仓库跟 GitHub 上的远端仓库完全没有关联，所以必须告诉 Git 远端仓库在哪。这时我们可以输入 `git remote add origin https://github.com/doggy8088/sandbox-empty2.git` 建立一个名为 `origin` 的参照名称，并指向 `https://github.com/doggy8088/sandbox-empty2.git` 位址，也就是我们在 GitHub 上的远端仓库位址。接着就跟我们先前讲解的步骤一模一样，如下图示：

![image](https://1991450022-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fj2h2C95aFkfa08k9hVd3%2Fuploads%2Fgit-blob-c1d19551e44b8c10183d6dcbed3d8246508728d8%2F18.png?alt=media)

接着我们再以 `sandbox-initialized2` 项目为例，请记得复制到正确的 URL 位址：

![image](https://1991450022-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fj2h2C95aFkfa08k9hVd3%2Fuploads%2Fgit-blob-2e2a9fd05ab2a1773461ec6d75717d7b7d108656%2F19.png?alt=media)

然后输入跟以上相同的指令 (记得改 URL 喔)：`git remote add origin https://github.com/doggy8088/sandbox-initialized2.git`

![image](https://1991450022-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fj2h2C95aFkfa08k9hVd3%2Fuploads%2Fgit-blob-e4e9f074aa57028e2804ffe59efc2bdd3c41d6d5%2F20.png?alt=media)

你可以发现，这次的 `git push` 动作被 GitHub 拒绝了！因为你不能把两个完全无关的 Git 版本直接上传到 GitHub 上的远端仓库。

解决的方法很简单，只要把远端仓库的 `master` 分支，成功合并回我本地的分支，即可建立两个不同版本库之间的关联，这样你就可以把本地的 `master` 分支推送到 GitHub 上远端仓库的 `master` 分支了。

将远端仓库的 `master` 分支取回，并合并到本地仓库的 `master` 分支，有两种方法：

1. 使用 `git pull origin master` 指令
2. 使用 `git fetch` 指令后再执行 `git merge origin/master` 合并动作 (这个方法会在后续的文章详述)

先用 `git --version` 查看自己的版本，若你的 Git 版本是 `2.8.4` (包含)以前，你可以成功合并，

成功执行的过程如下图示：

![image](https://1991450022-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fj2h2C95aFkfa08k9hVd3%2Fuploads%2Fgit-blob-0148c041a4fbfa24c7257feb7ae01653c9d79f82%2F21.png?alt=media)

但是从 `Git 2.9.0` 开始，预设行为不允许合并没有共同祖先的分支：

![image](https://1991450022-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fj2h2C95aFkfa08k9hVd3%2Fuploads%2Fgit-blob-1865df2707a52b953342d78abdd755402e8c2191%2F23.png?alt=media)

需要加上 `--allow-unrelated-histories` 允许 Git 合并没有共同祖先的分支。

因此完整指令为 `git pull origin master --allow-unrelated-histories`：

![image](https://1991450022-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fj2h2C95aFkfa08k9hVd3%2Fuploads%2Fgit-blob-4e5c69a1d2835e1c48a48a8f9c9acd764734e40e%2F24.png?alt=media)

## 今日小结

本篇文章完整的介绍如何将本地仓库上传到 GitHub 上的远端仓库，虽然过程有点麻烦，但如果你通过 GitHub for Windows 操作的话，要上传到 GitHub 只要简单的按下 **sync** 按钮，就可以自动上传了，连账号密码都不用输入，这样是不是简单很多。 (^\_^)

![image](https://1991450022-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fj2h2C95aFkfa08k9hVd3%2Fuploads%2Fgit-blob-8d2fa97cf079ad822bd51cd23a6db0c010f2fefc%2F22.png?alt=media)

我重新整理一下本日学到的 Git 指令与参数：

* git push origin master
* git push -u origin master
* git pull origin master
* git config --global push.default simple
* git push
* git fetch
* git merge origin/master
* git --version
* git pull origin master --allow-unrelated-histories

***

* [HOME](https://kerryhuangs-organization.gitbook.io/kerry-de-bi-ji-ben/git/30-tian-jing-tong-git-ban-ben-kong-guan)
* [回目录](https://kerryhuangs-organization.gitbook.io/kerry-de-bi-ji-ben/git/30-tian-jing-tong-git-ban-ben-kong-guan/zh-cn)
* [前一天：修正 commit 过的版本历史记录 Part 5 (rebase 2)](https://kerryhuangs-organization.gitbook.io/kerry-de-bi-ji-ben/git/30-tian-jing-tong-git-ban-ben-kong-guan/zh-cn/23)
* [下一天：使用 GitHub 远端仓库 - 观念篇](https://kerryhuangs-organization.gitbook.io/kerry-de-bi-ji-ben/git/30-tian-jing-tong-git-ban-ben-kong-guan/zh-cn/25)

***