Skip to main content

Cloning a repository

When you create a repository on your enterprise, 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.

About cloning a repository

You can clone a repository from your enterprise 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 your enterprise to your local machine.

Cloning a repository pulls down a full copy of all the repository data that your enterprise has at that point in time, including all versions of every file and folder for the project. You can push your changes to the remote repository on your enterprise, or pull other people's changes from your enterprise. For more information, see "Using Git".

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

Cloning a repository

  1. On your enterprise, navigate to the main page of the repository.

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

  3. 复制存储库的 URL。

    • 要使用 HTTPS 克隆存储库,在“HTTPS”下单击
    • 要使用 SSH 密钥克隆存储库,包括组织的 SSH 证书颁发机构颁发的证书,请单击“SSH”,然后单击
    • 要使用 GitHub CLI 克隆存储库,请单击“GitHub CLI”,然后单击 用于复制 URL 以使用 GitHub CLI 克隆存储库的剪贴板图标
  4. 打开终端终端Git Bash

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

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

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

    $ git clone https://hostname/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”。

To clone a repository locally, use the repo clone subcommand. Replace the repository parameter with the repository name. For example, octo-org/octo-repo, monalisa/octo-repo, or octo-repo. If the OWNER/ portion of the OWNER/REPO repository argument is omitted, it defaults to the name of the authenticating user.

gh repo clone REPOSITORY

You can also use the GitHub URL to clone a repository.

gh repo clone https://github.com/PATH-TO/REPOSITORY
  1. On your enterprise, navigate to the main page of the repository.
  2. 在文件列表上方,单击 “代码”。 “代码”按钮
  3. 单击 “使用 GitHub Desktop 打开”,以使用 GitHub Desktop 克隆并打开存储库。 “使用 GitHub Desktop 打开”按钮
  4. Follow the prompts in GitHub Desktop to complete the clone.

For more information, see "Cloning a repository from GitHub to GitHub Desktop."

Cloning an empty repository

An empty repository contains no files. It's often made if you don't initialize the repository with a README when creating it.

  1. On your enterprise, navigate to the main page of the repository.

  2. To clone your repository using the command line using HTTPS, under "Quick setup", click . To clone the repository using an SSH key, including a certificate issued by your organization's SSH certificate authority, click SSH, then click . Empty repository clone URL button

    Alternatively, to clone your repository in Desktop, click Set up in Desktop and follow the prompts to complete the clone. Empty repository clone desktop button

  3. 打开终端终端Git Bash

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

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

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

    $ git clone https://hostname/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.

Troubleshooting cloning errors

When cloning a repository it's possible that you might encounter some errors.

If you're unable to clone a repository, check that: