基于SSH协议clone GitHub远端仓库到本地-git

经常逛 GitHub 的可能都知道，在 clone 远端仓库的时候，会有两个选项，如下图：

首先我们来说明一下两种方式的区别。

使用 HTTPS url 克隆对初学者来说会比较方便，复制HTTPS url 然后到 git Bash 里面直接用 clone 命令克隆到本地就好了，但是每次 fetch 和 push 代码都需要输入账号和密码，这也是HTTPS 方式的麻烦之处。而使用 SSH url 克隆却需要在克隆之前先配置和添加好SSH key，因此，如果你想要使用SSH url克隆的话，你必须是这个项目的拥有者或管理员。否则你是无法添加 SSH key 的，另外 SSH 默认是每次 fetch 和 push 代码都不需要输入账号和密码，如果你想要每次都输入账号密码才能进行 fetch 和 push 也可以另外进行设置，但一般人不这么做。

以下对如何配置 SSH key 和 使用 SSH url 克隆作详细说明：（以下操作均在 Terminal 中进行）

① 查看自己是否已经创建了 SSH key

$ cd ~/.ssh
$ ls

这两个命令就是检查是否已经存在 id_rsa.pub 或 id_dsa.pub 文件，如果文件已经存在，那么你可以跳过步骤 2，直接进入步骤 3。

如果没有 SSH key ，是不会存在该文件夹的。

如果不存在 SSH key，或是 SSH key 不可用，那么备份并删除该文件夹，重新生成 SSH key 。（进入步骤 2）

② 生成秘钥

$ ssh-keygen -t rsa -C "CoderZYWang@yeah.net"

-t 指定密钥类型，默认是 rsa ，可以省略。

-C 设置注释文字，比如邮箱。（一定要是关联你 GitHub 的注册邮箱，也就是用户名）

-f 指定密钥文件存储文件名。

在上面的命令行中我省略了 -f 参数，因此，运行上面那条命令后会让你输入一个文件名，用于保存刚才生成的 SSH key 代码，如下：

Generating public/private rsa key pair.
Enter file in which to save the key (/Users/bpb/.ssh/id_rsa):

当然，你也可以不输入文件名，使用默认文件名（推荐），那么就会生成 id_rsa 和 id_rsa.pub 两个秘钥文件。

/Users/bpb/.ssh/id_rsa already exists.
Overwrite (y/n)? y<span style="font-size:14px;">
</span>

接着又会提示你输入两次密码（该密码是你 push 文件的时候要输入的密码，而不是 GitHub 管理者的密码），

GitHub

Enter passphrase (empty for no passphrase):
Enter same passphrase again:

之后会显示如下提示，表示 SSH key 已经创建成功。

Your identification has been saved in /Users/bpb/.ssh/id_rsa.
Your public key has been saved in /Users/bpb/.ssh/id_rsa.pub.
The key fingerprint is:
SHA256:rxneWu2eUcd6M5DKFt2J9aeDZhxpNczajN89HRoqZZg CoderZYWang@yeah.net
The key's randomart image is:
+---[RSA 4096]----+
|                 |
|             o   |
|              =. |
|          o .B=oo|
|        SE +**++=|
|         .+++=+==|
|        ..o=B.=+=|
|       . *o+ o o+|
|        =...+    |
+----[SHA256]-----+

③ 添加 SSH key 到 GitHub 上去

确保启用 SSH 代理：

$ eval "$(ssh-agent -s)"

为 SSH key 启用 SSH 代理

$ ssh-add ~/.ssh/id_rsa

如果你使用一个现有的SSH密钥，而不是产生一个新的SSH密钥，您需要与您现有的私钥文件名命令取代 id_rsa。（当然使用旧密钥就不需要执行上面一行命令行）

拷贝 id_rsa.pub 文件的内容，你可以用编辑器打开文件复制，也可以用 git 命令复制该文件的内容，如下：

Mac 端 copy 操作：

$ pbcopy < ~/.ssh/id_rsa.pub
# Copies the contents of the id_rsa.pub file to your clipboard

Windows 端 copy 操作：

$ clip < ~/.ssh/id_rsa.pub
# Copies the contents of the id_rsa.pub file to your clipboard

Linux 端操作：

sudo apt-get install xclip
# Downloads and installs xclip. If you don't have `apt-get`, you might need to use another installer (like `yum`)

xclip -sel clip < ~/.ssh/id_rsa.pub
# Copies the contents of the id_rsa.pub file to your clipboard

登录你的github账号，从右上角的设置（Account Setting ）进入，然后点击菜单栏的 SSH key 进入页面添加 SSH key。

点击 Add SSH key 按钮添加一个 SSH key 。把你复制的 SSH key 代码粘贴到 key 所对应的输入框中，记得 SSH key 代码的前后不要留有空格或者回车。当然，上面的 Title 所对应的输入框你也可以输入一个该 SSH key 显示在 github 上的一个别名。默认的会使用你的邮件名称。如下图：

④ 测试你的 SSH key 是否配置成功

$ ssh -T git@github.com

当你输入以上代码时，会有一段警告代码，如：

The authenticity of host 'github.com (207.97.227.239)' can't be established.
# RSA key fingerprint is 16:27:ac:a5:76:28:2d:36:63:1b:56:4d:eb:df:a6:48.
# Are you sure you want to continue connecting (yes/no)?

这是正常的，你输入 yes 回车既可。如果你创建 SSH key 的时候设置了密码，接下来就会提示你输入密码，如：

Enter passphrase for key '/c/Users/Administrator/.ssh/id_rsa':

当然如果你密码输错了，会再要求你输入，知道对了为止。

注意：输入密码时如果输错一个字就会不正确，使用删除键是无法更正的。

密码正确后你会看到下面这段话，如下：

Enter passphrase for key '/c/Users/Administrator/.ssh/id_rsa':

⑤ clone 远端仓库到本地吧 ~

$ git clone git@github.com:kahowu/benpaobao_ios.git

然后看到如下命令行：

Cloning into 'XXXXXXX'...
remote: Counting objects: 5133, done.
remote: Compressing objects: 100% (24/24), done.
Receiving objects:  43% (2224/5133), 4.84 MiB | 1024 bytes/s
remote: Total 5133 (delta 0), reused 0 (delta 0), pack-reused 5109
Receiving objects: 100% (5133/5133), 26.98 MiB | 75.00 KiB/s, done.
Resolving deltas: 100% (2922/2922), done.
Checking connectivity... done.

然后切换到本地项目的根目录下，拉取远端仓库的分支（Vayne）：

$ git fetch origin Vayne

接着看到如下命令行：

remote: Counting objects: 29, done.
remote: Compressing objects: 100% (29/29), done.
remote: Total 29 (delta 1), reused 0 (delta 0), pack-reused 0
Unpacking objects: 100% (29/29), done.
From github.com:kahowu/benpaobao_ios
 * branch            Vayne      -> FETCH_HEAD
   74b0c3f..40beaf1  Vayne      -> origin/Vayne

查看本地已经存在的远端分支：（发现只有一个 master 分支）

git branch
* master

新建本地 Vayne 分支，然后把拉取下来的远端 Vayne 分支进行合并：

注意下列命令行，是相对于我们拉下来的 Vayne 远端分支作为基准进行创建的 Vayne 本地分支，也就是说创建出来的本地 Vayne 分支是和远端的 Vayne 分支的代码保持一致的。和普通创建本地分支有一些小小的差异。（一般我们创建的出来的本地分支是基于当前所在的本地分支进行创建的，在此处也就是 master。但是由于我们在后面拼接了 origin/Vayne ，所以说此处并不是基于 master 分支创建的 Vayne 分支）

git checkout -b Vayne origin/Vayne

上面一句代码可以直接运行，不用 fetch，但是 fetch 的好处是可以先暂时拉取并查看。当然现在本地也没有 Vayne 分支，所以直接拉取也是合适的。

合并成功：

Branch Vayne set up to track remote branch Vayne from origin.
Switched to a new branch 'Vayne'