将 GitHub 仓库克隆到本地计算机的分步指南

由 Mux 主办的 DEV 全球展示挑战赛：展示你的项目！

您找到了一个感兴趣的 GitHub 代码库，想要探索、贡献代码，或者将其作为自己项目的起点。要在本地使用该代码库，您需要先将其克隆。本指南将一步步指导您如何将 GitHub 代码库克隆到您的计算机。

下面，您将学习两种克隆方法：使用 Git 命令行和 GitHub Desktop 应用。这样，您可以根据自己的喜好选择最适合的方法，无论您更喜欢使用终端还是图形用户界面 (GUI)。最后，您将在本地计算机上拥有一个可用的代码仓库，可以开始编写代码了。

本文将涵盖以下内容：

• 什么是 GitHub 仓库？为什么要克隆它？
• 准备克隆环境
• 如何使用 Git 命令行克隆 GitHub 仓库
• 如何使用 GitHub Desktop 克隆 GitHub 仓库
• 克隆代码库的最佳实践
• 克隆存储库时常见问题的故障排除
• 结论：开始克隆和贡献

什么是 GitHub 仓库？为什么要克隆它？

GitHub 代码库是一个在线存储空间，您可以在其中存储项目的所有文件、代码和文档。它允许您跟踪更改、共享您的工作以及在同一个代码库上进行协作。

从 GitHub “克隆”仓库时，会在您的计算机上创建一个完整的项目副本，包括所有文件、文件夹、分支和完整的版本历史记录。通常，您只需在项目开始时执行一次此过程。之后，您可以直接从远程仓库拉取最新更改来更新本地副本。

为什么要克隆 GitHub 代码库？

以下是一些你可能想要克隆 GitHub 代码库的主要原因：

• 要在本地访问和处理项目，克隆 GitHub 仓库可以让您在自己的计算机上离线处理项目，并进行与原始仓库不同的更改。

• 为开源项目做贡献。GitHub托管了许多流行的开源工具和框架。克隆仓库后，您可以提出改进建议、修复错误，然后通过拉取请求将您的贡献提交回原始仓库。

• 协作。在团队项目中，克隆 GitHub 代码库可以让您与他人共享和同步工作。每个协作者都可以拥有自己的本地副本，独立进行修改，然后将他们的工作合并回主代码库。

• 用于备份和版本控制。通过克隆自己的 GitHub 仓库，您可以创建本地备份，并跟踪代码随时间推移的更改。如果远程仓库出现问题或您需要回滚到以前的版本，克隆的副本可以让您访问项目的完整历史记录。

• 学习和实验。克隆代码仓库是学习其他开发者代码和项目的绝佳方式。您可以研究代码库，了解项目结构，并尝试进行修改而不会影响原始项目。

准备克隆环境

在开始克隆 GitHub 存储库之前，您需要满足一些先决条件。

• Git 已安装：请确保您的计算机上已安装 Git。如果您尚未安装，可以按照此Git 安装指南下载并安装。

• GitHub 账号：虽然并非绝对必要，但为了顺利完成克隆过程，建议您拥有一个 GitHub 账号。请查看GitHub 注册指南以创建您的账号。

• GitHub Desktop：如果您更喜欢可视化界面而不是命令行，可以选择安装 GitHub Desktop。以下是如何在您的计算机上安装 GitHub Desktop（支持 Windows 和 macOS）。开始之前，请务必使用您的 GitHub 帐户进行身份验证。

如何使用 Git 命令行克隆 GitHub 仓库

如果您熟悉终端或命令提示符的使用，可以按照以下步骤使用 Git 命令行轻松地从 GitHub 克隆存储库。

步骤 1：打开终端或命令提示符。首先，打开终端（macOS 或 Linux 系统）或命令提示符（Windows 系统）。您将在这里执行 Git 命令来克隆仓库。

步骤 2：导航到本地路径。使用cd命令，后跟计算机上的目录路径，导航到要存储克隆存储库的位置。

例如，您想将代码仓库克隆到桌面名为“Projects”的目录中。对于 macOS，请运行：cd ~/Desktop/Projects。对于 Windows，请运行：cd %USERPROFILE%\Desktop\Projects。

步骤 3：前往您想要克隆的 GitHub 仓库。访问 GitHub.com 上的仓库主页。该仓库可以是您自己的、公开的，或者您有权访问的私有仓库。点击页面顶部附近的绿色“< > 代码”按钮，即可显示克隆选项。

步骤 4：复制仓库 URL。在“克隆”部分，您会看到仓库的 URL。您可以根据偏好的身份验证方式选择 HTTPS 或 SSH。点击URL 旁边的剪贴板图标即可复制。

如果要克隆一个空仓库（一个还没有任何文件或提交的仓库），请在“快速设置”部分下，点击URL 旁边的剪贴板图标进行复制。

步骤 5：运行 Git clone 命令。返回终端或命令提示符，输入git clone并粘贴您从 GitHub 复制的 URL。此命令将在您的计算机上创建仓库的本地副本。它应该类似于这样：

git clone https://github.com/username/repository.git

请务必将“username”和“repository”替换为实际的GitHub用户名和仓库名称。

步骤 6：开始克隆仓库。按Enter 键运行 `git clone` 命令。Git 将开始克隆仓库，下载所有文件和分支，并将历史记录提交到本地计算机。克隆完成后，您将看到一条消息，确认克隆成功。现在您可以开始在本地处理项目了。

如何使用 GitHub Desktop 克隆 GitHub 仓库

GitHub Desktop 提供了一个用户友好的界面来克隆仓库，对于喜欢可视化操作的用户来说，这是一个不错的选择。以下是使用 GitHub Desktop 克隆仓库的步骤：

第一步：打开GitHub桌面。在您的计算机上启动GitHub桌面应用程序并登录您的GitHub帐户。

步骤 2：导航至克隆存储库窗口。在顶部菜单栏的“文件”菜单中，选择“克隆存储库”。

步骤 3：选择“URL”选项卡。在“克隆存储库”窗口中，您会看到几个选项卡。单击“URL”选项卡，即可通过输入存储库的 URL 来克隆该存储库。

如果您想克隆自己的代码仓库，也可以使用“GitHub.com”选项卡。此选项卡会显示与您的 GitHub 帐户关联的所有代码仓库。只需单击您想要克隆的代码仓库即可。

第四步：前往您想要克隆的 GitHub 仓库。假设您想要手动输入 URL，请导航至 GitHub.com 上的仓库主页。点击页面顶部附近的绿色“< > 代码”按钮，即可显示克隆选项。

步骤 5：在 GitHub Desktop 中打开仓库。 在“克隆”部分，点击“使用 GitHub Desktop 打开”按钮。它将自动启动 GitHub Desktop 并预先填充仓库 URL。

同样地，如果您想克隆一个空的存储库，请点击“在桌面上设置”按钮。

或者，您仍然可以手动复制存储库 URL（HTTPS 或 SSH），方法是单击URL 旁边的剪贴板图标，然后将其粘贴到GitHub Desktop 的“URL”字段中。

步骤 6：选择本地路径。在“本地路径”字段旁边，单击“选择...”按钮。这将打开一个文件资源管理器窗口，您可以在其中浏览并选择要存储克隆存储库的本地目录。

步骤 7：开始克隆仓库。点击窗口底部的“克隆”按钮。GitHub Desktop 会将项目的所有数据下载到您的本地目录。克隆完成后，仓库将出现在 GitHub Desktop 应用程序中。然后，您可以进入本地目录，并使用您喜欢的代码编辑器或 IDE 开始处理文件。

克隆代码库的最佳实践

克隆代码仓库时，为了获得流畅高效的工作流程，您应该遵循一些最佳实践。让我们一起来看看。

• 验证克隆的仓库。使用命令检查远程 URL git remote -v，确保它与原始仓库的 URL 匹配。此外，您还可以运行命令来确认所有分支是否已成功克隆git branch -a。另一种方法是将 GitHub 上的仓库大小与本地克隆的大小进行比较，以确保所有文件都已正确下载。

• 保持本地仓库更新。为确保您拥有远程仓库的最新更改，请定期使用命令获取更改git fetch origin。此命令会从远程仓库检索最新更新，而不会修改您的本地工作副本。要将获取的更改合并到当前本地分支，请使用命令git pull origin <branch-name>将获取的更改合并到当前本地分支。

• 使用 SSH 进行安全克隆。SSH提供本地计算机和 GitHub 之间的加密通信。设置完成后，GitHub 将使用您的 SSH 密钥进行身份验证，而不是密码。这样，您无需在本地存储任何凭据，从而降低了未经授权访问代码库的风险。

克隆存储库时常见问题的故障排除

克隆代码仓库通常是一个简单的过程，但您也可能遇到一些问题。以下是一些常见问题及其解决方法：

• HTTPS 克隆错误：当通过 HTTPS 克隆仓库时，如果身份验证或访问权限出现问题，就会出现这些错误。它们通常表示 Git 版本过旧或您没有仓库访问权限。要解决这些问题，请更新到最新版本的 Git，验证仓库是否存在于 GitHub.com 上，并仔细检查您对仓库的访问权限。

• “找不到仓库”错误：此错误表示仓库 URL 不正确、仓库已被删除或您没有必要的权限。要解决此问题，请仔细检查仓库 URL 是否有拼写错误，验证仓库在 GitHub.com 上是否存在，并确保您拥有相应的访问权限。如果问题仍然存在，请尝试使用其他协议（例如 SSH 而不是 HTTPS）克隆仓库，或联系 GitHub 支持团队以获取更多帮助。

结论：开始克隆和贡献

正如你所了解的，克隆仓库是所有使用 Git 并参与 GitHub 项目协作的人的必备技能。本文已经指导你完成了整个过程，无论你使用的是 Git 命令行还是 GitHub Desktop。现在是时候将这些知识付诸实践了。开始在 GitHub 上探索你感兴趣的项目，并将它们克隆到你的电脑上。尝试修改、学习，当你准备好之后，可以考虑提交 pull request 来帮助改进代码。

延伸阅读

想要更深入地了解 Git 和 GitHub，请浏览以下其他资源：

1. Git fork 与 clone：有什么区别？ | TheServerSide ：本文详细比较了 fork 和 clone 仓库之间的区别。

2. Git - 基本分支和合并：本官方 Git 文档涵盖了 Git 中分支和合并的基础知识。