GitHub Desktop 使用教程

GitHub Desktop 是由官方推出的桌面客户端，它将 Git 和 GitHub 的核心功能图形化，让你无需在命令行中输入复杂的命令，就能轻松地进行版本控制。

为什么选择 GitHub Desktop？

• 图形化界面：直观的界面让你能清晰地看到项目历史、文件变更和分支状态。
• 简化操作：将 add, commit, push, pull, merge 等常用命令简化为几个点击。
• 集成度高：与 GitHub 账户无缝集成，管理仓库、创建 Pull Request 等都非常方便。
• 学习友好：对于 Git 是理解版本控制概念和流程的绝佳工具。

准备工作

在开始之前,请确保你已经完成了以下步骤：

1. 安装 Git：
   • GitHub Desktop 在安装时会自动为你安装 Git，如果没有，你也可以从 Git 官网 下载安装。
2. 拥有 GitHub 账户：
   • 如果还没有,请访问 GitHub 官网 注册一个免费账户。
3. 下载并安装 GitHub Desktop：
   • 访问 GitHub Desktop 官网，根据你的操作系统下载并安装。

初始设置与登录

1. 启动 GitHub Desktop：安装完成后，打开 GitHub Desktop 应用。
2. 登录 GitHub：
   • 在欢迎界面,点击 "Sign in to GitHub"。
   • 你可以选择通过浏览器登录,或者输入你的 GitHub 用户名和密码登录。推荐使用浏览器登录，更安全便捷。
3. 配置身份信息：
   • 登录成功后,GitHub Desktop 会提示你配置你的名称和邮箱，这非常重要，因为每次提交代码时都会记录这些信息。
   • 确保这些信息与你 GitHub 账户上的信息一致，然后点击 "Continue"。

核心工作流程

这是使用 GitHub Desktop 最常见的场景：克隆一个已有的项目，进行修改，然后提交到 GitHub。

克隆别人的仓库（获取代码）

"克隆" 就是从 GitHub 服务器上完整地下载一个项目的所有文件和历史记录到你的电脑上。

1. 在 GitHub Desktop 中克隆：

   
   （图片来源网络，侵删）
   • 点击 GitHub Desktop 左上角的 "File" -> "Clone Repository"。
   • 在弹出的窗口中,选择 "GitHub" 标签页，你会看到你所有拥有权限的仓库列表。
   • 找到你想要克隆的仓库,点击它旁边的 "Clone" 按钮。
   • 选择一个本地路径来存放这个项目,然后点击 "Clone"。

2. 在 GitHub 网站上克隆：

   • 打开 GitHub 仓库页面，点击绿色的 "Code" 按钮。
   • 在弹出的菜单中,复制 "HTTPS" 或 "SSH" 的 URL。
   • 回到 GitHub Desktop，点击 "File" -> "Clone Repository"，选择 "URL" 标签页。
   • 粘贴你复制的 URL，选择本地路径，然后点击 "Clone"。

克隆完成后,你可以在左侧的 "Current Repository" 下拉菜单中看到这个项目，它就是你的“工作区”。

创建和提交你的更改（保存代码）

这是最核心的步骤：修改文件并保存你的工作。

1. 修改文件：

   
   （图片来源网络，侵删）

   在你的文件管理器中,找到你刚才克隆的项目文件夹，用任意代码编辑器（如 VS Code, Sublime Text）打开并修改一个或多个文件。

2. 回到 GitHub Desktop 查看更改：

   • 切换回 GitHub Desktop 窗口，你会看到 "Changes"（更改）标签页。
   • 左侧列出了你修改过的文件,右侧显示了每个文件的具体修改内容（绿色是新增，红色是删除，蓝色是移动）。

3. 暂存更改：

   • 在你想要提交的文件名前面打勾，这表示你告诉 Git：“这些修改是我这次想要保存的”。
   • 你也可以点击 "Stage all changes" 来暂存所有更改。

4. 编写提交信息：

   • 在下方的文本框中,清晰地描述你这次做了什么，这是良好的习惯，方便你和他人理解历史记录。
     • 格式建议：第一行写一个简短的标题，然后空一行，再写详细的描述。
   • 点击 "Commit to main" 按钮（如果你的主分支叫 main）。
     • "Commit" 的意思是“提交”，它会将你的更改保存到本地的 Git 仓库中，但还没有上传到 GitHub。

推送更改到 GitHub（同步代码）

提交只是保存在你的电脑上,为了与他人共享，或者防止电脑丢失，你需要将代码“推送”到 GitHub 服务器。

1. 推送代码：
   • 在 GitHub Desktop 窗口底部，你会看到一个 "Push origin" 按钮。
   • 点击它,GitHub Desktop 会将你刚才提交的更改上传到 GitHub 仓库。
   • 推送成功后,按钮会变为绿色，并显示 "Pushed to origin/main"。

你可以去 GitHub 网站上查看你的仓库，会发现代码已经是最新的了！

分支管理

分支是 Git 的强大功能，它允许你在不影响主项目的情况下，独立开发新功能或修复 Bug。

创建一个新分支来开发功能

假设你要开发一个新功能,但又不想直接修改主分支。

1. 创建分支：

   • 在 GitHub Desktop 左下角，点击当前分支名（main）旁边的下拉箭头。
   • 点击 "New branch"。
   • 输入新分支的名称（feature/new-login-page），然后点击 "Create branch"。
   • 你就在这个新分支上了,之后所有的提交都会发生在这个分支上，而 main 分支保持不变。

2. 在新分支上工作：

   • 像往常一样修改文件、暂存更改、提交，这些提交都会记录到 feature/new-login-page 分支上。

3. 推送新分支：

   • 像之前一样,点击底部的 "Push origin" 按钮，GitHub Desktop 会自动创建这个远程分支并推送你的代码。

合并分支（完成功能）

当你在新分支上的功能开发完成并测试无误后,需要将它合并回主分支。

1. 切换回主分支：

   • 点击左下角的分支下拉菜单,选择你的主分支（main）。
   • GitHub Desktop 会弹出一个提示，告诉你 main 分支落后于 feature/new-login-page 分支，点击 "Fetch origin" 来获取最新的远程信息，这相当于 git pull，会把 GitHub 上的 main 分支的更新拉取到你的本地。

2. 合并分支：

   • 确保你当前在 main 分支上。
   • 再次点击分支下拉菜单,你会看到你的 feature/new-login-page 分支，鼠标悬停在上面，旁边会出现一个 "Merge into main" 的按钮。
   • 点击它。
   • GitHub Desktop 会打开一个合并确认窗口，你可以再次编写一个合并提交信息，然后点击 "Create a merge commit"。

3. 推送合并结果：

   • main 分支已经包含了新分支的所有代码。
   • 点击底部的 "Push origin" 按钮，将合并后的结果推送到 GitHub。

合并完成后,你就可以删除这个已经合并的分支了（在分支下拉菜单里右键点击分支选择 "Delete branch"）。

从 GitHub 拉取更新

如果你的项目是团队协作的,其他人可能已经推送了新的代码，你需要先把他们的代码拉取到你的本地。

1. 获取最新信息：

   • 在 GitHub Desktop 左下角，点击当前分支名旁边的下拉箭头，选择 "View all branches"。
   • 在分支列表的右上角,点击 "Fetch origin"，这个操作会检查 GitHub 上的更新，但不会修改你的本地文件，非常安全。

2. 拉取并合并：

   • Fetch 后发现你的分支落后了，回到 "Changes" 标签页，你会看到一个 "Pull origin" 按钮。
   • 点击它,GitHub Desktop 会自动将远程的更改下载并合并到你的当前分支，这相当于 git pull。

处理合并冲突

当两个人修改了同一个文件的同一行时,Git 就无法自动决定如何合并，这时就会发生“冲突”。

1. 如何识别冲突：

   • 当你尝试合并或拉取代码时,如果发生冲突，GitHub Desktop 会提示你。
   • 在 "Changes" 标签页，冲突的文件会显示一个特殊的图标，点击它，你会看到文件内容被标记出来。

2. 如何解决冲突：

   • 手动编辑文件：打开冲突的文件，你会看到类似这样的标记：

     <<<<<<< HEAD
     // 这是你的本地代码
     你的代码内容
     =======
     // 这是远程的代码
     远程的代码内容
     >>>>>>> feature/other-branch

   • 你需要做的是：决定保留哪一部分，或者将两部分代码合并成一个新版本，删除 <<<<<<<, , >>>>>>> 这些标记行，只保留你想要的最终代码。
   • 暂存并提交：解决完所有冲突后，回到 GitHub Desktop，在 "Changes" 列表中点击文件名旁边的复选框来暂存这个已解决的文件。
   • 完成合并：所有冲突文件都被暂存后，底部的 "Commit to..." 按钮会重新出现，点击它，完成合并提交。

创建 Pull Request (PR)

在团队协作中,Pull Request 是向主项目贡献代码的标准方式，它允许你请求别人审查你的代码。

1. 推送你的功能分支：

   • 确保你的新功能分支（如 feature/my-awesome-feature）已经推送到 GitHub。

2. 创建 PR：

   • 在 GitHub Desktop 左下角，点击你的功能分支。
   • 在弹出的窗口中,点击 "Create Pull Request"。
   • 这会自动在你的浏览器中打开 GitHub 的页面，并为你预填好 PR 的信息。
   • 你可以在这里详细描述你的修改、为什么需要这个修改，并指定要合并到哪个目标分支（如 main）。
   • 填写完毕后,点击 "Create pull request"。

你的团队成员就可以在你的 PR 页面进行代码审查、讨论和测试了。

高级技巧与故障排除

• 查看历史记录：点击 "History"（历史）标签页，你可以看到项目的每一次提交，点击任意一次提交，都能查看当时的文件状态和具体改动。
• 同步分支：当你切换分支时，如果该分支有远程更新，GitHub Desktop 会提示你，让你选择是否同步（Fetch）。
• 撤销本地提交：如果你刚刚提交，但还没推送，可以在 "History" 标签页中右键点击那次提交，选择 "Revert this commit"，这会创建一个新的提交来撤销之前的更改。
• 问题排查：如果遇到问题，可以点击底部的 "View Output" 或 "Open in Terminal"，查看底层的 Git 命令输出，这有助于定位问题。

GitHub Desktop 将复杂的 Git 操作变得简单直观，非常适合日常开发，掌握以下核心流程，你就能高效地使用它：

1. 克隆 -> 获取项目代码。
2. 修改 & 提交 -> 保存你的工作。
3. 推送 -> 上传代码到 GitHub。
4. 分支 -> 独立开发新功能。
5. 合并 -> 将功能集成到主项目。
6. 拉取 -> 获取他人的更新。
7. PR -> 团队协作与代码审查。

希望这份教程对你有帮助！祝你使用愉快！