# 下载代码仓库到本地
开发人员进行代码文件的操作前，需要使用Git Bash客户端和TortoiseGit客户端下载代码仓库文件到本地环境中。
#### 前提条件
操作前应确保您的网络可以访问CodeArts的代码托管服务，请参考[验证网络连通性]。
 #### 使用SSH协议在Git Bash客户端克隆代码
本节内容指导如何使用Git Bash客户端克隆代码托管服务的仓库到本地环境中。
1. [下载并安装Git Bash客户端](https://support.huaweicloud.com/usermanual-codeartsrepo/codeartsrepo_03_0003.html)。
2. [配置SSH密钥](https://support.huaweicloud.com/usermanual-codeartsrepo/codeartsrepo_03_0011.html)。
3. 获取仓库地址。
   
   在仓库主页中，单击"克隆/下载"，获取SSH地址，通过这个地址，可以在本地计算机连接代码托管仓库。
   如果您未配置SSH密钥，您可单击下图中**"SSH密钥管理"** 链接进行配置，详情请参考[SSH密钥](https://support.huaweicloud.com/usermanual-codeartsrepo/codeartsrepo_03_0026.html)。
   您可在代码托管服务仓库列表中"仓库地址"下获取SSH地址。
   ![](https://support.huaweicloud.com/usermanual-wisestudio/zh-cn_image_0000002007733230.png)
   
   
4. 打开Git Bash客户端。 
   在本地计算机上新建一个文件夹用于存放代码仓库，在空白处单击鼠标右键，打开Git Bash客户端。
   克隆仓库时会自动初始化，无需执行init命令。
   
   
5. 输入如下命令，克隆代码托管仓库。 
   git clone*仓库地址*
   命令中"仓库地址"即[3]中获取的SSH地址。
   如果您是第一次克隆仓库，会询问您是否信任远程仓库，输入"yes"即可。
   执行成功后，您会看到多出一个与您在代码托管服务新建的仓库同名的文件夹，并且其中有一个隐藏的.git文件夹，则说明克隆仓库成功。
   
   
6. 此时您位于仓库上层目录，执行如下命令，进入仓库目录。 
   cd*仓库名称*
   进入仓库目录，可以看到此时Git默认为您定位到master分支。
   ![](https://support.huaweicloud.com/usermanual-wisestudio/zh-cn_image_0000002043772997.png)
   
   
![](https://support.huaweicloud.com/usermanual-wisestudio/public_sys-resources/note_3.0-zh-cn.png)
客户端在git clone代码仓库时失败的原因排查：
- 确保您的网络可以访问代码托管服务。
  请在git客户端使用如下测试命令验证网络连通性（其中"\*\*\*\*\*\*\*\*\*\*.com"为代码仓库地址）。
  ssh -vT git@**********.com
  如果返回内容含有"Could not resolve hostname \*\*\*\*\*\*\*\*\*\*.com: Name or service not known"，则您的网络被限制，无法访问代码托管服务，请求助您本地所属网络管理员。
  
- 请检查建立的SSH密钥配对关系，必要时重新生成密钥并到代码托管控制台进行配置。
- 只有[开启IP白名单](https://support.huaweicloud.com/usermanual-codeartsrepo/codeartsrepo_03_0041.html#section4)的机器才可以在Git客户端克隆。
 
#### 使用SSH协议在TortoiseGit客户端克隆代码
本节内容指导如何使用TortoiseGit客户端克隆代码托管服务的仓库到本地环境中。
1. [下载并安装TortoiseGit客户端](https://support.huaweicloud.com/usermanual-codeartsrepo/codeartsrepo_03_0003.html)。
2. 获取仓库地址。 
   在仓库主页中，单击"克隆/下载"，获取SSH地址，通过这个地址，可以在本地计算机连接代码托管仓库。
   您可在代码托管服务仓库列表中"仓库地址"下获取SSH地址。
   
   
3. 进入您的本地仓库目录下，右键选择"Git克隆"菜单选项，如下图所示。 
   ![](https://support.huaweicloud.com/usermanual-wisestudio/zh-cn_image_0000002043773001.png)
   
   
4. 在弹出的窗口中将上述复制的SSH地址粘贴到URL输入框中，勾选"加载Putty密钥"并选择私钥文件，最后单击"确定"，如下图所示。 
   ![](https://support.huaweicloud.com/usermanual-wisestudio/zh-cn_image_0000002043772993.png)
   
   
5. 单击"确定"之后即开始克隆仓库，如果您是第一次克隆TortoiseGit客户端会询问您是否信任远程仓库，单击"是"即可。
6. 克隆用时受仓库大小影响，克隆的动作如下图所示。 
   ![](https://support.huaweicloud.com/usermanual-wisestudio/zh-cn_image_0000002007574988.png)
   
   
 
#### 使用SSH协议在Linux或Mac中克隆仓库
在配置完[Linux Git客户端](https://git-scm.com/download/linux)或[Mac Git客户端](https://git-scm.com/download/mac)环境后，Linux或Mac上Git客户端的克隆操作和[使用SSH协议在Git Bash客户端克隆代码]的操作完全一样。