我们经常发布文档更新,此页面的翻译可能仍在进行中。有关最新信息,请访问英文文档。如果此页面上的翻译有问题,请告诉我们

克隆仓库

在 GitHub 上创建仓库时,它将作为远程仓库存在。 您可以克隆仓库以在计算机上创建本地副本,并在两个位置之间进行同步。

关于克隆仓库

您可以将仓库从 GitHub 克隆到本地计算机,以便修复合并冲突、添加或删除文件以及推送较大的提交。 克隆仓库时,将仓库从 GitHub 复制到本地计算机。

克隆仓库将提取 GitHub 在当时拥有的所有仓库数据的完整副本,包括项目每个文件和文件夹的所有版本。 您可以将更改推送到 GitHub 上的远程仓库,或者从 GitHub 拉取其他人的更改。 更多信息请参阅“使用 Git”。

您可以克隆自己的现有仓库或克隆其他人的现有仓库以参与项目。

提示:您也可以使用 GitHub CLI 克隆仓库。 更多信息请参阅 GitHub CLI 文档中的“gh 仓库克隆”。

使用命令行克隆仓库

  1. 在 GitHub 上,导航到仓库的主页面。

  2. 在文件列表上方,单击 ****Code(代码)。 "代码"按钮

  3. 要使用 HTTPS 克隆仓库,请在“Clone with HTTPS(使用 HTTPS 克隆)”下单击 . 要使用 SSH 密钥克隆仓库,包括由组织的 SSH 证书颁发机构颁发的证书,请单击 Use SSH(使用 SSH),然后单击 。 要使用 GitHub CLI 克隆仓库,请单击使用 GitHub CLI,然后单击 用于复制 URL 以克隆仓库的剪贴板图标

    用于复制 URL 以使用 GitHub CLI 克隆仓库的剪贴板图标

  4. 打开 Terminal(终端)Terminal(终端)Git Bash

  5. 将当前的工作目录更改为您想要存储克隆目录的位置。

  6. 键入 git clone,然后粘贴先前复制的 URL。

    $ git clone https://github.com/YOUR-USERNAME/YOUR-REPOSITORY
  7. Enter 创建本地克隆。

    $ git clone https://github.com/YOUR-USERNAME/YOUR-REPOSITORY
    > Cloning into `Spoon-Knife`...
    > remote: Counting objects: 10, done.
    > remote: Compressing objects: 100% (8/8), done.
    > remove: Total 10 (delta 1), reused 10 (delta 1)
    > Unpacking objects: 100% (10/10), done.

将仓库克隆到 GitHub Desktop

  1. 在 GitHub 上,导航到仓库的主页面。

  2. 在文件列表上方,单击 ****Code(代码)。 "代码"按钮

  3. 单击 使用 GitHub Desktop 打开以使用 GitHub Desktop 克隆并打开仓库。 "使用 GitHub Desktop 打开"按钮

  4. 按照 GitHub Desktop 中的提示完成克隆。

更多信息请参阅“将仓库从 GitHub 克隆到 GitHub Desktop”。

克隆空仓库

空仓库不含任何文件。 如果创建仓库时不使用 README 初始化仓库,通常会出现空仓库。

  1. 在 GitHub 上,导航到仓库的主页面。

  2. 要使用 HTTPS 以命令行克隆仓库,请在“Quick setup(快速设置)”下单击 。 要使用 SSH 密钥克隆仓库,包括组织的 SSH 认证中心颁发的证书,单击 SSH,然后单击 空仓库克隆 URL 按钮

    或者,要在 Desktop 中克隆仓库,请单击 Set up in Desktop(在 Desktop 中设置)并按照提示完成克隆。 空仓库克隆桌面按钮

  3. 打开 Terminal(终端)Terminal(终端)Git Bash

  4. 将当前的工作目录更改为您想要存储克隆目录的位置。

  5. 键入 git clone,然后粘贴先前复制的 URL。

    $ git clone https://github.com/YOUR-USERNAME/YOUR-REPOSITORY
  6. Enter 创建本地克隆。

    $ git clone https://github.com/YOUR-USERNAME/YOUR-REPOSITORY
    > Cloning into `Spoon-Knife`...
    > remote: Counting objects: 10, done.
    > remote: Compressing objects: 100% (8/8), done.
    > remove: Total 10 (delta 1), reused 10 (delta 1)
    > Unpacking objects: 100% (10/10), done.

排查克隆错误

在克隆仓库时,可能会遇到一些错误。

如果无法克隆仓库,请检查:

延伸阅读

此文档对您有帮助吗? 隐私政策

帮助我们创建出色的文档!

所有 GitHub 文档都是开源的。看到错误或不清楚的内容了吗?提交拉取请求。

做出贡献

或, 了解如何参与。