克隆存储库

在 GitHub.com 上创建存储库时，它将作为远程存储库存在。你可以克隆你的存储库，在你的计算机上创建一个本地副本，并在两个位置之间同步。

平台导航

本文内容

关于克隆存储库

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

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

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

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

你可以克隆你现有的存储库或克隆其他人的现有存储库以对项目做出贡献。

克隆存储库

  1. 在 GitHub.com 上，导航到存储库的主页。

  2. 在文件列表上方，单击 代码.

    Screenshot of the list of files on the landing page of a repository. The "Code" button is highlighted with a dark orange outline.

  3. 复制存储库的 URL。

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

    • 要使用 SSH 密钥（包括你的组织的 SSH 证书颁发机构颁发的证书）克隆存储库，请单击SSH，然后单击 .

    • 要使用 GitHub CLI 克隆存储库，请单击GitHub CLI，然后单击 .

      Screenshot of the "Code" dropdown menu. To the right of the HTTPS URL for the repository, a copy icon is outlined in dark orange.

  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.

若要了解有关 GitHub CLI 的更多信息，请参阅“关于 GitHub CLI”。

若要克隆本地存储库，请使用 repo clone 子命令。将 repository 参数替换为存储库名称。例如，octo-org/octo-repo、monalisa/octo-repo 或 octo-repo。如果省略 OWNER/REPO 存储库参数的 OWNER/ 部分，则默认为验证用户的名称。

gh repo clone REPOSITORY

您还可以使用 GitHub URL 克隆存储库。

gh repo clone https://github.com/PATH-TO/REPOSITORY

  1. 在 GitHub.com 上，导航到存储库的主页。

  2. 在文件列表上方，单击 代码.

    Screenshot of the list of files on the landing page of a repository. The "Code" button is highlighted with a dark orange outline.

  3. 若要使用 GitHub Desktop 克隆并打开存储库，请单击 使用 GitHub Desktop 打开.

    Screenshot of the "Code" dropdown for a repository. A button, labeled "Open with GitHub Desktop" is outlined in dark orange.

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

有关更多信息，请参阅“从 GitHub 克隆存储库到 GitHub Desktop”。

克隆空存储库

空存储库不包含任何文件。在创建存储库时未使用自述文件初始化存储库时，通常会创建空存储库。

  1. 在 GitHub.com 上，导航到存储库的主页。

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

    Screenshot of the quick setup instructions for an empty repository. To the right of the HTTPS URL for the repository, a copy icon is outlined in dark orange.

    或者，若要在 Desktop 中克隆存储库，请单击 在 Desktop 中设置，然后按照提示完成克隆。

    Screenshot of the quick setup instructions for an empty repository. A button, labeled with a download icon and "Set up in Desktop," is outlined in dark orange.

  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 连接。有关更多信息，请参阅“排查克隆错误”。
  • 您有权访问要克隆的存储库。有关更多信息，请参阅“排查克隆错误”。
  • 您想要克隆的默认分支仍然存在。有关详细信息，请参阅“解决克隆错误”。

延伸阅读