Skip to main content

克隆仓库

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

关于克隆仓库

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

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

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

克隆仓库

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

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

  3. 复制存储库的 URL。

    • 要使用 HTTPS 克隆仓库,在“HTTPS”下单击
    • 要使用 SSH 密钥克隆仓库,包括组织的 SSH 认证中心颁发的证书,单击 SSH,然后单击
    • 要使用 GitHub CLI 克隆存储库,请单击 GitHub CLI,然后单击 用于复制 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 CLI 的更多信息,请参阅“关于 GitHub CLI”。

要在本地克隆仓库,请使用 repo clone 子命令。 用仓库名称替换 repository 参数。 例如, octo-org/octo-repomonalisa/octo-repoocto-repo。 如果省略了 OWNER/REPO 仓库参数的 OWNER/ 部分,将默认使用认证用户的名称。

gh repo clone repository

您也可以使用 GitHub URL来克隆仓库。

gh repo clone https://github.com/cli/cli
  1. 在 GitHub.com 上,导航到仓库的主页面。
  2. 在文件列表上方,单击 ****Code(代码)。 "代码"按钮
  3. 单击 使用 GitHub Desktop 打开以使用 GitHub Desktop 克隆并打开仓库。 "使用 GitHub Desktop 打开"按钮
  4. 按照 GitHub Desktop 中的提示完成克隆。

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

克隆空仓库

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

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

  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.

排查克隆错误

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

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

延伸阅读