GitHub仓库克隆指南：HTTPS、SSH和GitHub CLI等多种方式详解

GitHub仓库克隆指南：HTTPS、SSH和GitHub CLI等多种方式详解

引用

github

1.

https://docs.github.com/zh/enterprise-server@3.16/repositories/creating-and-managing-repositories/cloning-a-repository

克隆仓库是将GitHub上的存储库复制到本地计算机的过程，这使得开发者可以在本地进行代码编辑、冲突解决和版本控制等操作。本文将详细介绍如何克隆仓库，包括使用HTTPS、SSH和GitHub CLI等多种方式，并提供克隆空仓库和错误排查的指导。

关于克隆仓库

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

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

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

克隆仓库

1. 在 GitHub 上，导航到存储库的主页面。
2. 在文件列表上方，单击“代码”。
3. 复制存储库的 URL。

• 要使用 HTTPS 克隆存储库，请在“HTTPS”下单击。
• 要使用 SSH 密钥克隆存储库，包括组织的 SSH 证书颁发机构颁发的证书，请单击“SSH”，然后单击。
• 要使用 GitHub CLI 克隆存储库，请单击“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”。

若要在本地克隆存储库，请使用 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

8. 在 GitHub 上，导航到存储库的主页面。
9. 在文件列表上方，单击“代码”。
10. 若要使用 GitHub Desktop 克隆并打开存储库，请单击“使用 GitHub Desktop 打开”。

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

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

克隆空仓库

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

1. 在 GitHub 上，导航到存储库的主页面。
2. 要使用 HTTPS 通过命令行克隆存储库，请在“快速设置”下单击。 要使用 SSH 密钥克隆存储库，包括组织的 SSH 证书颁发机构颁发的证书，请单击“SSH”，然后单击。
3. 或者，要在 Desktop 中克隆存储库，请单击“在 Desktop 中进行设置”，然后按照提示完成克隆。
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.

排查克隆错误

在克隆仓库时，可能会遇到一些错误。如果无法克隆仓库，请检查：

• 网络连接是否正常
• Git 是否正确安装
• SSH 密钥是否配置正确（如果使用 SSH 方式）
• URL 是否正确复制
• 本地磁盘空间是否充足

如果问题仍然存在，可以查看 Git 的错误日志以获取更多信息。