使用 GitHub Desktop 完成 first-contributions 的第一次开源贡献fork → clone → edit → PR 全流程图形化指南【免费下载链接】first-contributions✨ Help beginners to contribute to open source projects项目地址: https://gitcode.com/gh_mirrors/fi/first-contributions初次参与开源贡献时最大的障碍往往不是技术本身而是“不知道从哪里开始、害怕出错”。first-contributions 项目正是为解决这一痛点而存在——它以 README.md 为主线在 docs/gui-tool-tutorials 目录下为不同工具提供了分步教程本文讲解的便是其中面向不熟悉命令行读者的GitHub Desktop 图形化版本对应文档 github-desktop-tutorial.sw.md。读完本文你将完全掌握贡献者最常遇到的fork - clone - edit - commit - push - pull request标准工作流并能在不接触命令行的情况下完成你的第一次真实 Pull Request。为什么选择 GitHub Desktop 完成首次贡献对于刚接触 Git 与 GitHub 的新手命令行存在一定的学习门槛。GitHub Desktop 将 Git 的核心操作封装为图形界面让“分支切换”“提交”“推送”等概念变得可视化、可点击。这种“边做边学”的方式恰好契合 first-contributions 项目的理念与其只阅读文章和观看教程不如在不会搞砸任何东西的前提下真正动手完成一次贡献。项目的辅助说明文档也印证了这一点——README.md 明确写道如果对命令行不熟悉可以转向 GUI 工具教程。在本教程中你将以 GitHub Desktop 为操作载体完成对 first-contributions 仓库的一次真实贡献把自己的名字添加到 Contributors.md 文件中该文件目前已有数千条贡献者记录这正是这套工作流被大量新手成功实践过的证据并通过 Pull Request 提交给项目维护者合并。前提如果尚未安装 GitHub Desktop请先前往 desktop.github.com 下载安装若你正在使用 1.0 之前的旧版本界面布局与本教程存在差异应参考旧版教程 github-desktop-old-version-tutorial.md。第一步Fork复刻仓库打开 first-contributions 仓库页面点击页面右上角的Fork按钮。这一步会在你自己的 GitHub 账号下生成该仓库的一份完整副本后续所有修改都在这个副本上进行不会影响原仓库。Fork 的意义在于开源协作中普通贡献者没有直接向他人仓库写代码的权限而通过 Fork 得到的“个人副本”则完全归你所有你可以任意修改、推送最后再通过 Pull Request 请求原仓库采纳你的改动。这也是整个工作流的第一步。第二步Clone克隆仓库到本地现在需要把 GitHub 上的 fork 副本下载到你的电脑上。关键提醒不要克隆原仓库务必进入你自己账号下的 fork 仓库再执行克隆。在 fork 仓库页面点击Code按钮选择Open in GitHub Desktop。系统会弹出确认窗口点击Open GitHubDesktop.exe以唤起本机已安装的 GitHub Desktop 程序。随后 GitHub Desktop 会弹出Clone a repository对话框确认仓库信息无误后点击Clone等待仓库内容下载到本地。克隆完成后程序还会弹出一个询问“你打算如何使用这个 fork”的对话框How are you planning to use this fork?此时应选择To contribute to the parent project向父项目贡献并点击Continue。这一步非常关键它告诉 GitHub Desktop 你的目标是向原项目提交贡献程序会自动为你维护与上游的关联关系。至此first-contributions 仓库的内容已经完整复制到了你的电脑上。对照 CLI 教程 README.md 中的git clone命令可以更好地理解这一步的底层本质克隆就是把远程仓库的完整历史与文件复制到本地工作区。第三步创建功能分支永远不要在默认分支main/master上直接修改并提交——这是 Git 协作的基本素养。正确的做法是为每次改动创建一个独立的分支。在 GitHub Desktop 顶部点击Current branch图标选择New branch将分支命名为add-your-name格式例如add-james-smith把你的名字代入其中便于维护者一眼看出这个分支的用途然后点击Create branch确认创建。创建分支后GitHub Desktop 会立即切换到新分支上之后的所有修改都会落在该分支内与主分支完全隔离。这与 CLI 教程中git switch -c your-new-branch-nameREADME.md的作用完全一致只是变成了可视化操作。第四步修改文件并提交Commit进入 GitHub Desktop 的History历史标签页找到仓库根目录下的 Contributors.md 文件右键选择在文本编辑器中打开。滚动到文件末尾按照既有条目的格式追加你的名字然后保存文件。格式如下以 James Smith 为例[James Smith](https://github.com/jamessmith)即使用 Markdown 链接语法你的名字。保存后回到 GitHub Desktop你会立即看到 Contributors.md 显示为已修改状态——这就是 Git 工作区状态的可视化呈现等价于 CLI 中git status的输出参见 README.md 对git add与git commit的说明。接下来提交这些改动在界面下方的Summary摘要字段中填写提交信息Add your-name to Contributors list并把your-name替换为你的真实名字。点击Commit to add-your-name按钮按钮文本会带上你的分支名。提交完成后界面底部会显示这条新提交的记录。提交Commit本质上是为当前改动拍一张“快照”并附上说明文字它只发生在本地尚未同步到 GitHub。第五步推送Push/Publish到 GitHub提交只存在于本地还需要推送到你 fork 的远程仓库。如果这是你首次使用 GitHub Desktop需要先登录点击File - Options在 Accounts 中登录 GitHub.com输入你的用户名和密码完成授权。登录完成后点击界面右上角的Publish按钮将本地分支及其提交推送到你的 fork 仓库。这一步等价于 CLI 中的git push -u origin your-branch-nameREADME.md-u参数会建立本地分支与远程分支的追踪关系而 GitHub Desktop 的 Publish 按钮做了同样的工作。提示如果后续分支需要同步上游更新GitHub Desktop 也提供 Fetch/Pull 按钮相关高级场景可参考 keeping-your-fork-synced-with-this-repository.zh-cn.md 等补充资料。第六步提交 Pull Request 供审查推送成功后回到你的 GitHub fork 仓库页面会看到一个醒目的Compare pull request按钮点击它进入 Pull Request 创建页。在这个页面GitHub 会展示你的分支与上游原仓库的差异对比确认改动无误后点击Submit pull request提交拉取请求即可。你的名字和修改就会被正式提交给 first-contributions 项目维护者审查。Pull Request 是开源协作的“交作业”环节你把 fork 仓库分支上的改动请求原仓库合并。一旦维护者审查通过并合并你会收到邮件通知你的名字就会出现在 Contributors.md 中成为该项目的正式贡献者。收尾你已掌握的贡献者工作流恭喜至此你完整走通了贡献者最常遇到的fork - clone - edit - commit - push - PR标准工作流。这套流程不仅在 first-contributions 项目中使用也是你今后参与任何 GitHub 开源项目的通用技能。如果想进一步加深理解可以对照命令行版本 README.md理解每个图形化操作背后的 Git 命令学习更多高级 Git 技巧如修改提交amending-a-commit.zh-cn.md、合并冲突解决resolving-merge-conflicts.zh-cn.md、保持 fork 与上游同步keeping-your-fork-synced-with-this-repository.zh-cn.md这些资料统一索引在 additional-material.md若想尝试其他图形化工具VS Code、GitKraken、SourceTree 等可参考 docs/gui-tool-tutorials 目录下的对应教程。【免费下载链接】first-contributions✨ Help beginners to contribute to open source projects项目地址: https://gitcode.com/gh_mirrors/fi/first-contributions创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 使用 GitHub Desktop 完成 first-contributions 的第一次开源贡献：fork → clone → edit → PR 全流程图形化指南
使用 GitHub Desktop 完成 first-contributions 的第一次开源贡献fork → clone → edit → PR 全流程图形化指南【免费下载链接】first-contributions✨ Help beginners to contribute to open source projects项目地址: https://gitcode.com/gh_mirrors/fi/first-contributions初次参与开源贡献时最大的障碍往往不是技术本身而是“不知道从哪里开始、害怕出错”。first-contributions 项目正是为解决这一痛点而存在——它以 README.md 为主线在 docs/gui-tool-tutorials 目录下为不同工具提供了分步教程本文讲解的便是其中面向不熟悉命令行读者的GitHub Desktop 图形化版本对应文档 github-desktop-tutorial.sw.md。读完本文你将完全掌握贡献者最常遇到的fork - clone - edit - commit - push - pull request标准工作流并能在不接触命令行的情况下完成你的第一次真实 Pull Request。为什么选择 GitHub Desktop 完成首次贡献对于刚接触 Git 与 GitHub 的新手命令行存在一定的学习门槛。GitHub Desktop 将 Git 的核心操作封装为图形界面让“分支切换”“提交”“推送”等概念变得可视化、可点击。这种“边做边学”的方式恰好契合 first-contributions 项目的理念与其只阅读文章和观看教程不如在不会搞砸任何东西的前提下真正动手完成一次贡献。项目的辅助说明文档也印证了这一点——README.md 明确写道如果对命令行不熟悉可以转向 GUI 工具教程。在本教程中你将以 GitHub Desktop 为操作载体完成对 first-contributions 仓库的一次真实贡献把自己的名字添加到 Contributors.md 文件中该文件目前已有数千条贡献者记录这正是这套工作流被大量新手成功实践过的证据并通过 Pull Request 提交给项目维护者合并。前提如果尚未安装 GitHub Desktop请先前往 desktop.github.com 下载安装若你正在使用 1.0 之前的旧版本界面布局与本教程存在差异应参考旧版教程 github-desktop-old-version-tutorial.md。第一步Fork复刻仓库打开 first-contributions 仓库页面点击页面右上角的Fork按钮。这一步会在你自己的 GitHub 账号下生成该仓库的一份完整副本后续所有修改都在这个副本上进行不会影响原仓库。Fork 的意义在于开源协作中普通贡献者没有直接向他人仓库写代码的权限而通过 Fork 得到的“个人副本”则完全归你所有你可以任意修改、推送最后再通过 Pull Request 请求原仓库采纳你的改动。这也是整个工作流的第一步。第二步Clone克隆仓库到本地现在需要把 GitHub 上的 fork 副本下载到你的电脑上。关键提醒不要克隆原仓库务必进入你自己账号下的 fork 仓库再执行克隆。在 fork 仓库页面点击Code按钮选择Open in GitHub Desktop。系统会弹出确认窗口点击Open GitHubDesktop.exe以唤起本机已安装的 GitHub Desktop 程序。随后 GitHub Desktop 会弹出Clone a repository对话框确认仓库信息无误后点击Clone等待仓库内容下载到本地。克隆完成后程序还会弹出一个询问“你打算如何使用这个 fork”的对话框How are you planning to use this fork?此时应选择To contribute to the parent project向父项目贡献并点击Continue。这一步非常关键它告诉 GitHub Desktop 你的目标是向原项目提交贡献程序会自动为你维护与上游的关联关系。至此first-contributions 仓库的内容已经完整复制到了你的电脑上。对照 CLI 教程 README.md 中的git clone命令可以更好地理解这一步的底层本质克隆就是把远程仓库的完整历史与文件复制到本地工作区。第三步创建功能分支永远不要在默认分支main/master上直接修改并提交——这是 Git 协作的基本素养。正确的做法是为每次改动创建一个独立的分支。在 GitHub Desktop 顶部点击Current branch图标选择New branch将分支命名为add-your-name格式例如add-james-smith把你的名字代入其中便于维护者一眼看出这个分支的用途然后点击Create branch确认创建。创建分支后GitHub Desktop 会立即切换到新分支上之后的所有修改都会落在该分支内与主分支完全隔离。这与 CLI 教程中git switch -c your-new-branch-nameREADME.md的作用完全一致只是变成了可视化操作。第四步修改文件并提交Commit进入 GitHub Desktop 的History历史标签页找到仓库根目录下的 Contributors.md 文件右键选择在文本编辑器中打开。滚动到文件末尾按照既有条目的格式追加你的名字然后保存文件。格式如下以 James Smith 为例[James Smith](https://github.com/jamessmith)即使用 Markdown 链接语法你的名字。保存后回到 GitHub Desktop你会立即看到 Contributors.md 显示为已修改状态——这就是 Git 工作区状态的可视化呈现等价于 CLI 中git status的输出参见 README.md 对git add与git commit的说明。接下来提交这些改动在界面下方的Summary摘要字段中填写提交信息Add your-name to Contributors list并把your-name替换为你的真实名字。点击Commit to add-your-name按钮按钮文本会带上你的分支名。提交完成后界面底部会显示这条新提交的记录。提交Commit本质上是为当前改动拍一张“快照”并附上说明文字它只发生在本地尚未同步到 GitHub。第五步推送Push/Publish到 GitHub提交只存在于本地还需要推送到你 fork 的远程仓库。如果这是你首次使用 GitHub Desktop需要先登录点击File - Options在 Accounts 中登录 GitHub.com输入你的用户名和密码完成授权。登录完成后点击界面右上角的Publish按钮将本地分支及其提交推送到你的 fork 仓库。这一步等价于 CLI 中的git push -u origin your-branch-nameREADME.md-u参数会建立本地分支与远程分支的追踪关系而 GitHub Desktop 的 Publish 按钮做了同样的工作。提示如果后续分支需要同步上游更新GitHub Desktop 也提供 Fetch/Pull 按钮相关高级场景可参考 keeping-your-fork-synced-with-this-repository.zh-cn.md 等补充资料。第六步提交 Pull Request 供审查推送成功后回到你的 GitHub fork 仓库页面会看到一个醒目的Compare pull request按钮点击它进入 Pull Request 创建页。在这个页面GitHub 会展示你的分支与上游原仓库的差异对比确认改动无误后点击Submit pull request提交拉取请求即可。你的名字和修改就会被正式提交给 first-contributions 项目维护者审查。Pull Request 是开源协作的“交作业”环节你把 fork 仓库分支上的改动请求原仓库合并。一旦维护者审查通过并合并你会收到邮件通知你的名字就会出现在 Contributors.md 中成为该项目的正式贡献者。收尾你已掌握的贡献者工作流恭喜至此你完整走通了贡献者最常遇到的fork - clone - edit - commit - push - PR标准工作流。这套流程不仅在 first-contributions 项目中使用也是你今后参与任何 GitHub 开源项目的通用技能。如果想进一步加深理解可以对照命令行版本 README.md理解每个图形化操作背后的 Git 命令学习更多高级 Git 技巧如修改提交amending-a-commit.zh-cn.md、合并冲突解决resolving-merge-conflicts.zh-cn.md、保持 fork 与上游同步keeping-your-fork-synced-with-this-repository.zh-cn.md这些资料统一索引在 additional-material.md若想尝试其他图形化工具VS Code、GitKraken、SourceTree 等可参考 docs/gui-tool-tutorials 目录下的对应教程。【免费下载链接】first-contributions✨ Help beginners to contribute to open source projects项目地址: https://gitcode.com/gh_mirrors/fi/first-contributions创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考