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

克隆仓库

When you create a repository on GitHub, it exists as a remote repository. You can clone your repository to create a local copy on your computer and sync between the two locations.

本文内容

Did this doc help you?

关于克隆仓库

You can clone a repository from GitHub to your local computer to make it easier to fix merge conflicts, add or remove files, and push larger commits. When you clone a repository, you copy the repository from GitHub to your local machine.

克隆仓库将提取 GitHub 在当时拥有的所有仓库数据的完整副本,包括项目每个文件和文件夹的所有版本。 You can push your changes to the remote repository on GitHub, or pull other people's changes from GitHub. 更多信息请参阅“使用常见的 Git 命令”。

You can clone your existing repository or clone another person's existing repository to contribute to a project.

Tip: You can also clone a repository using the GitHub CLI. For more information, see "gh repo clone" in the GitHub CLI documentation.

使用命令行克隆仓库

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

  2. Above the list of files, click Code.

    "Code" button

  3. To clone the repository using HTTPS, under "Clone with HTTPS", click . To clone the repository using an SSH key, including a certificate issued by your organization's SSH certificate authority, click Use SSH, then click . To clone a repository using GitHub CLI, click Use GitHub CLI, then click .

    The clipboard icon for copying the URL to clone a repository

    The clipboard icon for copying the URL to clone a repository with 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. Above the list of files, click Code.

    "Code" button

  3. Click Open with GitHub Desktop to clone and open the repository with GitHub Desktop.

    "Open with GitHub Desktop" button

  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.

排查克隆错误

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

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

延伸阅读

Did this doc help you?