更新时间:2024-10-28 GMT+08:00
分享

下载代码仓库到本地

开发人员进行代码文件的操作前,需要使用Git Bash客户端和TortoiseGit客户端下载代码仓库文件到本地环境中。

前提条件

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

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

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

  1. 下载并安装Git Bash客户端
  2. 配置SSH密钥
  3. 获取仓库地址。

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

    如果您未配置SSH密钥,您可单击上图中“SSH密钥管理”链接进行配置,详情请参考SSH密钥

    您可在代码托管服务仓库列表中“仓库地址”下获取SSH地址。

  4. 打开Git Bash客户端。

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

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

  5. 输入如下命令,克隆代码托管仓库。

    git clone 仓库地址

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

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

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

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

    cd 仓库名称

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

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

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

    请在git客户端使用如下测试命令验证网络连通性(其中“**********.com”为代码仓库地址)。

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

    如果返回内容含有“Could not resolve hostname **********.com: Name or service not known”,则您的网络被限制,无法访问代码托管服务,请求助您本地所属网络管理员。

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

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

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

  1. 下载并安装TortoiseGit客户端
  2. 获取仓库地址。

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

    您可在代码托管服务仓库列表中“仓库地址”下获取SSH地址。

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

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

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

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

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

相关文档