关于克隆仓库
您可以将仓库从 GitHub 克隆到本地计算机,以便修复合并冲突、添加或删除文件以及推送较大的提交。 克隆仓库时,将仓库从 GitHub 复制到本地计算机。
克隆仓库将提取 GitHub 在当时拥有的所有仓库数据的完整副本,包括项目每个文件和文件夹的所有版本。 您可以将更改推送到 GitHub 上的远程仓库,或者从 GitHub 拉取其他人的更改。 更多信息请参阅“使用 Git”。
您可以克隆自己的现有仓库或克隆其他人的现有仓库以参与项目。
提示:您也可以使用 GitHub CLI 克隆仓库。 更多信息请参阅 GitHub CLI 文档中的“gh 仓库克隆
”。
使用命令行克隆仓库
-
在 GitHub 上,导航到仓库的主页面。
-
在文件列表上方,单击 ****Code(代码)。
-
要使用 HTTPS 克隆仓库,请在“Clone with HTTPS(使用 HTTPS 克隆)”下单击 . 要使用 SSH 密钥克隆仓库,包括由组织的 SSH 证书颁发机构颁发的证书,请单击 Use SSH(使用 SSH),然后单击 。 要使用 GitHub CLI 克隆仓库,请单击使用 GitHub CLI,然后单击 。
-
打开 Terminal(终端)Terminal(终端)Git Bash。
-
将当前的工作目录更改为您想要存储克隆目录的位置。
-
键入
git clone
,然后粘贴先前复制的 URL。$ git clone https://github.com/YOUR-USERNAME/YOUR-REPOSITORY
-
按 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
-
在 GitHub 上,导航到仓库的主页面。
-
在文件列表上方,单击 ****Code(代码)。
-
单击 使用 GitHub Desktop 打开以使用 GitHub Desktop 克隆并打开仓库。
-
按照 GitHub Desktop 中的提示完成克隆。
更多信息请参阅“将仓库从 GitHub 克隆到 GitHub Desktop”。
克隆空仓库
空仓库不含任何文件。 如果创建仓库时不使用 README 初始化仓库,通常会出现空仓库。
-
在 GitHub 上,导航到仓库的主页面。
-
要使用 HTTPS 以命令行克隆仓库,请在“Quick setup(快速设置)”下单击 。 要使用 SSH 密钥克隆仓库,包括组织的 SSH 认证中心颁发的证书,单击 SSH,然后单击 。
或者,要在 Desktop 中克隆仓库,请单击 Set up in Desktop(在 Desktop 中设置)并按照提示完成克隆。
-
打开 Terminal(终端)Terminal(终端)Git Bash。
-
将当前的工作目录更改为您想要存储克隆目录的位置。
-
键入
git clone
,然后粘贴先前复制的 URL。$ git clone https://github.com/YOUR-USERNAME/YOUR-REPOSITORY
-
按 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 连接。 更多信息请参阅“HTTPS 克隆错误”。
- 您有权访问要克隆的仓库。 更多信息请参阅“错误:找不到仓库”。
- 要克隆的默认分支仍然存在。 您有权访问要克隆的仓库。 更多信息请参阅“错误:远程 HEAD 引用不存在的 ref,无法检出”。
延伸阅读
- "连接问题故障排除"