使用SSH协议克隆云端仓库到本地

前提条件

用户操作前应确保您的网络可以访问代码托管服务，请参考验证网络连通性。

使用SSH协议在Git Bash客户端克隆代码

本节内容描述如何使用Git Bash客户端克隆代码托管服务的云端仓库到本地环境中。

1. 下载并安装Git Bash客户端。
2. 设置SSH密钥。
3. 获取仓库地址。（没有仓库？如何新建仓库？）

   在仓库主页中，单击“克隆/下载”按钮，获取SSH地址，通过这个地址，可以在本地计算机连接云端仓库。

   

4. 打开Git Bash客户端。

   在本地计算机上新建一个文件夹用于存放代码仓库，在空白处单击鼠标右键，打开Git Bash客户端。

   

   克隆仓库时会自动初始化，无需执行init命令。

5. 输入如下命令，克隆云端仓库。

   git clone 仓库地址

   命令中“仓库地址”即3中获取的SSH地址。

   如果您是第一次克隆仓库，会询问您是否信任远程仓库，输入“yes”即可。

   执行成功后，您会看到多出一个与您在云端新建的仓库同名的文件夹，并且其中有一个隐藏的.git文件夹，则说明克隆仓库成功。

6. 此时您位于仓库上层目录，执行如下命令，进入仓库目录。

   cd 仓库名称

   进入仓库目录，可以看到此时Git默认为您定位到master分支。

   

7. （可选）您也可以执行以下命令将云端仓库里指定的分支拉取到本地，并在本地创建一个分支与该云端仓库分支进行关联。

   git checkout 分支名称

客户端在git clone 代码仓库时失败的原因排查：

• 确保您的网络可以访问代码托管服务。

  请在git客户端使用如下测试命令验证网络连通性。

  ssh -vT git@code**********.com

  如果返回内容含有“Could not resolve hostname code**********.com: Name or service not known”，如下图所示。

  

• 请检查建立的SSH密钥配对关系，必要时重新生成密钥并到代码托管控制台进行配置。
• 只有开启IP白名单的机器才可以在Git客户端克隆。

使用SSH协议在TortoiseGit客户端克隆代码

本节内容描述如何使用TortoiseGit客户端克隆代码托管服务的云端仓库到本地环境中。

1. 下载并安装TortoiseGit客户端。
2. 获取仓库地址。（没有仓库？如何新建仓库？）

   在仓库主页中，单击“克隆/下载”按钮，获取SSH地址，通过这个地址，可以在本地计算机连接云端仓库。

3. 进入您的本地仓库目录下，右键选择“Git克隆”菜单选项，如下图所示。

   

4. 在弹出的窗口中将上述复制的SSH地址粘贴到URL输入框中，勾选“加载Putty密钥”并选择私钥文件，最后单击“确定”，如下图所示。

   

5. 单击“确定”之后即开始克隆仓库，如果您是第一次克隆TortoiseGit客户端会询问您是否信任远程仓库，单击“是”即可。
6. 克隆用时受仓库大小影响，克隆的动作如下图所示。

   

使用SSH协议在Linux或Mac中克隆仓库

在配置完Linux Git客户端或Mac Git客户端环境后，Linux或Mac上Git客户端的克隆操作和使用SSH协议在Git Bash客户端克隆代码的操作完全一样。