使用 GitHub Desktop 旧版本完成首次开源贡献基于 first-contributions 仓库的 fork → clone → 分支 → 提交 → PR 全流程实战【免费下载链接】first-contributions✨ Help beginners to contribute to open source projects项目地址: https://gitcode.com/gh_mirrors/fi/first-contributions本指南以 first-contributions 仓库的希腊语版 GitHub Desktop 教程github-desktop-old-version-tutorial.gr.md为骨架讲解如何用 GitHub Desktop1.0 之前的旧版本走完fork → clone → 分支 → 修改 → 提交 → 推送 → Pull Request的完整贡献流程。读完本文你将不依赖命令行纯靠图形界面完成第一次真实的开源贡献并理解这套流程背后的 Git 原理与仓库中的配套资源。一、教程背景为什么需要一个 GUI 版的首次贡献指南first-contributions 项目在 README.md 中这样定位自己This project aims to simplify and guide the way beginners make their first contribution——它存在的意义就是让初学者以最低的试错成本完成第一次开源贡献。仓库里围绕这一目标沉淀了三大类教程CLI 命令行教程如 github-cli-tutorial.md面向熟悉终端的用户GUI 图形界面教程覆盖 GitHub Desktop、Visual Studio Code、GitKraken、Sourcetree、IntelliJ IDEA 等工具多语言翻译README 提供了数十种语言的翻译入口本教程对应的希腊语版本即位于docs/gui-tool-tutorials/translations/Greek/目录下。本次讲解的这份希腊语教程是GitHub Desktop 旧版本专用版。当前版本教程 github-desktop-tutorial.md 开头明确说明如果你使用的是 1.0 之前的 GitHub Desktop 版本请参考旧版本教程——这正是本文所依托文档的适用场景。两种版本的操作入口略有差异例如旧版本通过左上角进入克隆流程新版本通过 Open in GitHub Desktop 一键导入但底层 Git 工作流完全一致。提示本文对应文档为希腊语翻译版。经对照英文原版教程 github-desktop-old-version-tutorial.md 与希腊语版步骤一一对应仅在推送Push一节存在差异——希腊语版正文未单列该步骤而英文原版包含。为保证工作流完整可运行不推送就无法发起 PR本文按英文原版补全该步骤并作说明。二、前置准备安装并登录 GitHub Desktop教程正文的第一步就是准备工具如果你还没有在自己的机器上安装 GitHub Desktop请先安装它对应希腊语原文Εάν δεν έχετε το GitHub Desktop στη μηχανή σας, εγκαταστήστε το。实操要点前往 GitHub Desktop 官方网站下载与你的操作系统匹配的安装包支持 Windows 与 macOS安装完成后首次启动需要登录 GitHub 账号并完成授权——GitHub Desktop 会以你的身份执行克隆、推送等操作因此这一步是后续所有操作的凭证基础安装完成后可以通过仓库页面上的 Open with GitHub Desktop 按钮或客户端内的 URL 协议唤起但本教程旧版本流程走的是客户端内部的菜单入口。三、第 1 步Fork 本仓库在网页端完成Fork 是整套流程的起点。教程原文希腊语写道通过点击本页顶部的 fork 按钮来 fork 这个仓库这会在你的账号下创建该仓库的一个副本。关键理解Fork ≠ CloneFork 是在 GitHub 服务端把你的账号下生成一份独立的仓库副本它完全归你所有你可以随意修改而不影响原仓库Fork 的对象是原仓库即 first-contributions 上游仓库而不是任何人的 forkFork 完成后你账号下会出现一个你的用户名/first-contributions仓库后续的 Clone 和 Push 都围绕它进行。这一步全程在浏览器里完成没有任何命令行操作。四、第 2 步用 GitHub Desktop 克隆仓库到本地Fork 只是在服务器端产生了副本本地还需要一份工作区。教程给出完整的图形界面操作路径打开 GitHub Desktop 应用点击窗口左上角的按钮如果弹出菜单中尚未选中Clone克隆选项卡先点击选中它在仓库列表中选择first-contributions然后点击Clone first-contributions按钮在弹出的目录选择器中选择你希望将仓库存放到的本地目录等待克隆完成后first-contributions 仓库的内容就完整复制到了你的电脑上。这里有一个需要强调的细节新版本教程 github-desktop-tutorial.md 中特别用大写标注不要克隆原仓库请克隆你自己的 fork。因为只有对 fork 仓库才拥有写权限后续才能把改动推送上去。五、第 3 步创建分支在修改任何内容之前先在本地创建一个独立分支。教程原文希腊语操作如下点击左上角的分支图标来创建一个分支将分支命名为 add-your-name例如 add-crawleya然后点击Δημιουργία νέου κλαδιού创建新分支。实操要点点击 GitHub Desktop 窗口左上角的分支图标一个类似分叉的形状在名称输入框中填写分支名命名格式为add-你的名字教程给出的示例是add-crawleya即添加 crawleya 到名单的语义点击Create new branch创建新分支按钮确认。分支命名的语义值得留意add-xxx前缀直观地表达出本次改动是往名单里加一个人这一目的。在实际开源项目中分支名通常采用类型/描述的约定如fix/typo、feature/xxx方便维护者从分支名快速判断改动意图。创建分支后GitHub Desktop 会自动切换到该分支后续所有改动都只会落在这个分支上与main主分支完全隔离。六、第 4 步修改 Contributors.md 并提交Commit这是整个流程中唯一一次实质性的文件修改。教程原文希腊语步骤为用文本编辑器打开仓库根目录下的Contributors.md文件将自己的名字添加到文件中然后保存回到 GitHub Desktop可以看到Contributors.md的变更已被识别并暂存在底部提交区域的summary摘要字段填写提交信息Add your-name to Contributors list将your-name替换成你的真实名字点击按钮Commit to add-your-name提交到 add-your-name 分支完成提交在窗口底部可以看到刚刚创建的提交记录。这里结合仓库源码补充几点Contributors.md 是仓库中真实存在的文件当前已积累数千行贡献者记录读取可见已超过 5900 行格式为- 名字的 Markdown 无序列表部分条目还附带一句个人留言。你的名字加入后将与这些历史贡献者并列README.md 对修改位置给出了明确建议不要把名字加在文件开头或结尾放在中间任意位置——这样可以最大限度降低多人并发编辑同一文件时产生合并冲突的概率是多人协作场景下的实用技巧Add your-name to Contributors list 是一条信息密度很高的提交信息它既说明了改动对象Contributors 名单又说明了改动动作添加。良好的提交信息应当遵循类似动词 对象 原因的句式方便维护者快速审查。在 Git 层面这一步实际发生了git add Contributors.md与git commit -m Add your-name to Contributors list两个操作对应 README.md 命令行教程中的原生命令GitHub Desktop 把它们封装成了图形界面的两次点击。七、第 5 步推送Push到 GitHub这一步是希腊语教程正文缺失、但工作流中不可省略的关键环节。英文原版教程 github-desktop-old-version-tutorial.md 明确写道点击窗口右上角的Publish发布按钮。要点说明提交Commit只是把改动记录在了本地仓库服务器上的 fork 还不知道这些改动点击Publish后本地分支及其提交会被推送到你在 GitHub 上的 fork 仓库之后网页端才能看到这些改动并发起 PR在底层这一步等价于命令行教程README.md中的git push -u origin add-your-name其中-u会把本地分支与远端分支建立跟踪关系之后的推送只需git push推送完成后你账号下的 fork 仓库会多出一个add-your-name分支。如果你在推送时遇到认证失败可以参照 README.md 中的排错章节检查git remote -v确认远端地址指向自己的 fork而不是上游原仓库。八、第 6 步提交 Pull Request 供维护者审核改动推送到远端后就可以向原仓库发起合并请求。教程原文希腊语步骤为打开你的 fork 仓库页面GitHub 网页端页面顶部会出现一个Compare pull request比较并创建拉取请求按钮点击它在打开的 PR 创建页面中确认比较方向base 仓库为原仓库的 main 分支compare 分支为你刚推送的 add-your-name 分支填写 PR 标题与描述后提交请求维护者收到请求后会将你的改动合并进主分支合并完成后你会收到一封通知邮件。要点说明PR 的本质是一份请把我分支上的改动合并进主分支的正式申请它同时提供了 diff 对比、评论讨论和自动检查的载体是开源协作中最重要的审查机制教程特别提到我很快就会把你的改动合并到这个项目的主分支合并完成后你会收到邮件通知——这对应仓库维护者的真实工作流也解释了为什么 PR 提交后无需其他操作等待即可如果你的 PR 因与主分支最新代码冲突而无法合并可参考仓库的附加材料 resolving-merge-conflicts.md 处理冲突。九、工作流全景从图形界面到 Git 原理至此你已经完整走过了开源贡献的标准流程。教程原文希腊语这样总结恭喜你刚刚完成了作为贡献者经常遇到的典型fork → clone → edit → PR流程。把这套流程与 Git 底层命令一一对照可以更清楚地看到每一步的实质图形界面操作本教程对应 Git 命令作用对象效果网页端 Fork 按钮服务端操作原仓库在账号下生成仓库副本GitHub Desktop→ Clonegit clone fork-地址远端 → 本地把 fork 复制到本地分支图标 → Create new branchgit switch -c add-your-name本地创建并切换到新分支编辑 Contributors.mdgit add/ 编辑器保存工作区 → 暂存区记录文件改动summary Commit 按钮git commit -m Add ...暂存区 → 本地仓库生成提交快照Publish 按钮git push -u origin add-your-name本地 → 远端 fork把提交推送到服务器Compare pull request服务端操作fork → 原仓库申请合并改动从这张表可以看出几个关键原理Commit 是本地动作Push 才是网络动作Git 的分布式设计允许你在本地反复提交而不受网络影响直到满意后再一次性推送分支隔离降低风险在add-your-name分支上做的任何改动都不会影响main即使改坏了也可以丢弃分支重来参见附加材料 removing-branch-from-your-repository.mdPR 是协作的入口合并与否由维护者决定这保证了任何人都可以提交代码但最终质量由仓库所有者把关——这正是开源众人协作 有人负责的典型形态。十、后续进阶从第一次贡献到持续贡献完成首次贡献后仓库为你的继续成长准备好了成体系的进阶资源深入 Git 技巧仓库的 附加材料索引 汇总了十多个高频场景的专项文档包括修改提交信息amending-a-commit.md、保持 fork 与原仓库同步keeping-your-fork-synced-with-this-repository.md、压缩提交squashing-commits.md、撤销提交undoing-a-commit.md等这些正是你日后参与真实项目时最常用到的能力该索引也有对应的希腊语版本切换工具链如果你用的是 1.0 及以上的新版 GitHub Desktop可参考 github-desktop-tutorial.md或希腊语新版教程如果熟悉命令行可走 github-cli-tutorial.md 路线仓库还提供了 VS Code、GitKraken、Sourcetree 等更多图形工具教程选最顺手的一款即可分享你的贡献教程结尾建议把你的首次贡献成果分享给朋友和关注者同时可以关注 README.md 中提到的项目列表——上面整理了大量带有入门级 issue 的真实开源项目可以作为你迈向更广泛贡献的下一站。无论使用哪种工具fork → clone → edit → push → PR这套工作流都不会变。本教程的意义在于用 GitHub Desktop 的图形界面把每一步 Git 操作变得直观可见让你在零命令行压力下完成第一次真实贡献从而建立起对开源协作全流程的信心。【免费下载链接】first-contributions✨ Help beginners to contribute to open source projects项目地址: https://gitcode.com/gh_mirrors/fi/first-contributions创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考