使用 Sublime Merge 完成首次开源贡献first-contributions 图形化实战指南【免费下载链接】first-contributions✨ Help beginners to contribute to open source projects项目地址: https://gitcode.com/gh_mirrors/fi/first-contributions导读本文基于 first-contributions 开源仓库的官方教程原文路径以及其 希腊语翻译版面向不熟悉命令行、希望用图形化界面体验 Git 完整流程的初学者讲解如何使用Sublime Merge这一 Git 客户端完成一次真实的开源贡献。读者将完整掌握fork → clone → 新建分支 → 修改文件 → stage 与 commit → push → 提交 Pull Request这条标准贡献链路并了解如何在 Sublime Merge 中处理提交登录、分支推送等细节为后续参与任何开源项目打下基础。前置认知为什么用图形化 Git 客户端首次参与开源最难的不是代码本身而是对fork / clone / branch / commit / push / pull request这一整套协作动作感到陌生。first-contributions 项目存在的意义就是通过一个不会“搞坏任何东西”的练习仓库让新手在真实环境中走完一遍标准工作流见 README.md 对项目目标的说明。Sublime Merge 将上述 Git 操作封装为菜单与按钮把命令行的抽象概念暂存区、分支、远程可视化适合作为 Git 的图形化入门工具。本项目在 docs/gui-tool-tutorials/ 下提供了 GitHub Desktop、VS Code、GitKraken、Sourcetree、IntelliJ IDEA 等多种图形化工具的等效教程本文聚焦 Sublime Merge。第一步安装并打开 Sublime Merge从 Sublime Merge 官方网站下载对应操作系统的安装包安装完成后启动程序。本教程的后续所有操作克隆、建分支、提交、推送都在这款客户端内完成无需打开命令行终端。第二步Fork 本仓库创建个人副本在 first-contributions 仓库页面顶部点击Fork分叉按钮。该操作会在你的 GitHub 账号下创建一份该仓库的完整副本即你专属的first-contributions仓库。要点Fork 产生的副本归属于你的账号后续所有提交与推送都发生在你的副本上原始仓库不受影响。这正是开源协作“先复制、再修改、后请求合并”的基本前提。第三步用 Sublime Merge 克隆仓库Fork 完成后需要把你在 GitHub 上的副本下载到本地电脑。回到你在 GitHub 上的 fork 副本页面点击Code按钮再点击复制 URL 到剪贴板图标获得仓库地址。在 Sublime Merge 中通过菜单File文件→ Clone Repository克隆仓库打开克隆对话框。将复制到的仓库 URL 粘贴进输入框可自定义仓库名称也可留空使用默认名并选择仓库在本地磁盘上的保存目录。确认路径无误后点击Clone克隆按钮仓库即被完整下载到本地。新手高频错误警告很多初学者复制的是别人原始仓库的 URL而不是自己 fork 副本的 URL。克隆前请务必检查浏览器地址栏确认 URL 指向的是你自己的你的用户名/first-contributions仓库而不是原始仓库。克隆错了仓库后续所有提交都无法推送到你的副本。第四步创建功能分支Branch开源协作的惯例是永远不要在 main 主分支上直接修改而是为每次改动创建一个独立分支。在 Sublime Merge 中有两种方式创建分支在左侧边栏的Branches分支区域点击右键选择Create Branch创建分支或通过菜单Repository仓库→ Create Branch创建分支。分支命名建议使用add-你的名字的格式例如add-william-sutton本仓库教程的示例名希腊语版本示例为add-anna-sophia。这种命名让维护者一眼看出该分支的用途是“向贡献者列表添加某位贡献者”。原理佐证在 README.md 的命令行版本中对应的分支创建命令是git switch -c your-new-branch-nameSublime Merge 的“创建分支”菜单底层执行的正是同一条 Git 操作只是以图形界面呈现。第五步修改文件并提交Stage 与 Commit这是整个工作流的核心步骤涉及 Git 中最重要的“暂存区”概念。用任意文本编辑器打开仓库根目录下的Contributors.md文件该文件是贡献者名单当前已收录数千位贡献者见 Contributors.md。在文件中间位置追加一行你的名字格式参照既有条目- [你的名字](https://github.com/你的用户名)保存文件。切回 Sublime Merge界面会立刻提示检测到未暂存的改动顶部会显示类似x unstaged files的最新条目。点击该条目审查变更内容决定哪些文件需要纳入本次提交。暂存Stage逐个勾选文件或点击stage all一次性暂存全部改动。暂存的意义在于精确告诉 Git“本次提交到底关联哪些文件的改动”这是 Git 提交模型的核心机制。填写提交信息Commit Message建议使用描述性文案例如Add 你的名字 to Contributors list。点击Commit提交按钮完成本地提交。若客户端要求填写用户名与邮箱请按提示输入并更新之后再点击一次 Commit 确认。两个实用操作如果改了主意可以把已暂存的文件取消暂存unstage如果完全不想要某些改动了可以执行Discard丢弃。警告丢弃是破坏性操作会直接删除工作区中的改动且不可恢复仅在确定不要这些改动时才使用。本地提交的意义commit只会把改动固化在你本地的分支上此时远端仓库还看不到任何变化——这是初学者最容易困惑的点也是下一步需要push的原因。第六步将改动推送到 GitHubPush本地提交完成后需要把改动推送到你在 GitHub 上的 fork 副本。Sublime Merge 提供两种方式菜单Repository仓库→ Push推送点击窗口右上角向上的小箭头按钮。首次推送时会要求登录 GitHub 账号输入用户名与密码或使用授权登录。推送目标选择origin远程的当前分支即add-你的名字分支。如果你的目标是让改动直接反映在 main 分支上也可以选择推送到对应分支但按照第四步的惯例应当推送独立功能分支再通过 Pull Request 合并。操作背后的意义本仓库 README.md 的命令行等价操作为git push -u origin your-branch-name。-u的作用是建立本地分支与远程分支的跟踪关系Sublime Merge 的推送对话框在首次推送时自动完成了这一设置。第七步提交 Pull Request 请求合并推送成功后回到你在 GitHub 上的 fork 副本页面GitHub 会自动检测到刚推送的新分支并显示Compare pull request比较并创建拉取请求按钮点击该按钮进入 PR 创建页面确认比较方向base目标仓库的 main 分支←compare你 fork 中的新分支填写 PR 标题与说明可沿用提交信息如Add 你的名字 to Contributors list点击Create pull request / Submit pull request提交请求。提交成功后仓库维护者会收到 PR 通知审阅通过后会将你的改动合并进主分支 main。合并完成后你的邮箱会收到通知邮件。至此一次完整的开源贡献流程闭环完成。第八步贡献完成后的进阶指引你已经掌握的技能恭喜你刚刚完整走完了开源协作中最常见、最高频的标准工作流fork → clone → edit → pull request。这套流程不仅适用于本练习仓库也是你在任何开源项目上提交代码的统一范式。保持 fork 与上游同步完成首次贡献后随着时间推移你的 fork 副本会落后于原始仓库的新提交。此时需要学习“三角工作流”原始公共仓库upstream→ 本地仓库 → 你的 GitHub forkorigin。完整操作添加 upstream 远程、git fetch upstream、git rebase upstream/main、git push origin main见 保持 fork 与上游同步其中明确指出只有当你的 GitHub 仓库提示落后若干提交时才需要执行同步。更多进阶 Git 场景附加材料索引 汇总了你在实际贡献中可能遇到的各类进阶场景包括修改最近一次提交amend当你发现提交信息有拼写错误或漏改了文件时使用可在 push 前随时修正解决合并冲突当你的分支与 main 产生冲突时的处理办法回退提交revert撤销已经推送到远端的提交压缩提交squash当审阅者要求把多个提交合并为一个时使用。查看其他工具的等效教程如果你之后想体验其他图形化 Git 客户端本仓库在 docs/gui-tool-tutorials/ 提供了 GitHub Desktop、Visual Studio Code、GitKraken、Sourcetree、IntelliJ IDEA 等工具的对应教程操作流程与本教程完全同构——区别仅在于点击的位置不同底层执行的 Git 命令一致。总结通过 Sublime Merge 这款图形化客户端你以零命令行的方式完成了 fork、clone、分支创建、暂存提交、推送与 Pull Request 提交的完整链路。本文对应的 英文原版教程 与 希腊语翻译版 可继续作为操作参考每当你在 GitHub 上看到 “a few commits behind” 的提示就回到“保持 fork 同步”一节让你的副本始终与上游保持一致。现在带着这套工作流去为真正感兴趣的开源项目提交你的下一条 Pull Request 吧。【免费下载链接】first-contributions✨ Help beginners to contribute to open source projects项目地址: https://gitcode.com/gh_mirrors/fi/first-contributions创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考