Skip to main content

克隆仓库

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

Platform navigation

关于克隆仓库

你可以将存储库从 GitHub.com 克隆到本地计算机或 codespace,以便更轻松地修复合并冲突、添加或删除文件以及推送较大的提交。 克隆存储库时,将存储库从 GitHub.com 复制到本地计算机 ,或者在创建 codespace 后复制到远程虚拟机。 有关克隆到 codespace 的详细信息,请参阅“为存储库创建 codespace

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

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

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

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

克隆仓库

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

  2. 在文件列表上方,单击 “代码”。

    存储库登陆页面上的文件列表的屏幕截图。 “代码”按钮以深橙色轮廓突出显示。

  3. 复制存储库的 URL。

    • 要使用 HTTPS 克隆存储库,请在“HTTPS”下单击

    • 要使用 SSH 密钥克隆存储库,包括组织的 SSH 证书颁发机构颁发的证书,请单击“SSH”,然后单击

    • 要使用 GitHub CLI 克隆存储库,请单击“GitHub CLI”,然后单击

      “代码”下拉菜单的屏幕截图。 在存储库的 HTTPS URL 的右侧,复制图标以深橙色框出。

  4. 打开终端终端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.
    

Note

若要详细了解 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/PATH-TO/REPOSITORY
  1. 在 GitHub 上,导航到存储库的主页面。

  2. 在文件列表上方,单击 “代码”。

    存储库登陆页面上的文件列表的屏幕截图。 “代码”按钮以深橙色轮廓突出显示。

  3. 若要使用 GitHub Desktop 克隆并打开存储库,请单击 “使用 GitHub Desktop 打开”。

    存储库的“代码”下拉列表的屏幕截图。 标记为“使用 GitHub Desktop 打开”的按钮以深橙色标出。

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

有关详细信息,请参阅“将仓库从 GitHub 克隆到 GitHub Desktop”。

克隆空仓库

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

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

  2. 要使用 HTTPS 通过命令行克隆存储库,请在“快速设置”下单击 。 要使用 SSH 密钥克隆存储库,包括组织的 SSH 证书颁发机构颁发的证书,请单击“SSH”,然后单击

    空存储库的快速设置说明的屏幕截图。 在存储库的 HTTPS URL 的右侧,复制图标以深橙色标出。

    或者,要在 Desktop 中克隆存储库,请单击 “在 Desktop 中进行设置”,然后按照提示完成克隆。

    空存储库的快速设置说明的屏幕截图。 标有下载图标和“在 Desktop 中进行设置”的按钮以深橙色标出。

  3. 打开终端终端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.
    

排查克隆错误

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

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

  • 您可以使用 HTTPS 连接。 有关详细信息,请参阅“排查克隆错误”。
  • 您有权访问要克隆的仓库。 有关详细信息,请参阅“排查克隆错误”。
  • 要克隆的默认分支仍然存在。 有关详细信息,请参阅“排查克隆错误”。

延伸阅读