ARTICLE DETAIL

资讯详情

深耕网站建设、视觉设计与SEO优化的一线实战洞察。

first-contributions 项目实战:使用 GitHub Desktop 完成你的第一次开源贡献(Fork → Clone → Edit → PR 完整指南)

first-contributions 项目实战:使用 GitHub Desktop 完成你的第一次开源贡献(Fork → Clone → Edit → 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-tutorial.th.md为主体骨架面向从未参与过开源协作的新手讲解如何借助 GitHub Desktop 图形界面走完一条零命令行、零风险、零出错的fork → clone → edit → PR标准贡献链路。读完本文你将学会把上游仓库 Fork 到自己的账户、用 GitHub Desktop 克隆到本地、新建功能分支、修改并提交 Contributors.md、推送到远端并提交 Pull Request最终把自己的名字永久写入开源项目的贡献者名单——这也是所有开源贡献者反复遇到的基础工作流。为什么选择动手做来学习开源贡献万事开头难尤其是在与他人协作时犯错总让人不安。但开源的本质就是协作与共同工作。阅读文章、观看视频教程能带来帮助却比不上亲手做一遍且不搞砸任何东西。first-contributions 项目的目标正是为开源新手提供清晰的引导简化第一次贡献的流程。本项目仓库本身就是由全球开发者通过这种方式共同维护的——根目录下的 Contributors.md 已积累了数千条贡献者记录格式统一为- Name这正是你将要添加的内容。记住一个原则你越放松学得越好。接下来只需按照步骤执行整个过程会相当有趣。准备安装 GitHub Desktop 与版本确认如果你还没有安装 GitHub Desktop请先到官方网站下载安装。版本前提本教程面向 GitHub Desktop1.0 及以上版本的界面。如果你使用的是 1.0 之前的旧版本界面布局与按钮位置不同请改读旧版本专用教程。第一步Fork分叉本项目打开 first-contributions 项目主页点击页面右上角的Fork按钮。这一操作会在你自己的 GitHub 账户下创建当前仓库的一份完整副本。关键认知Fork 产生的副本属于你的账户后续所有修改都在这个副本上进行不会影响上游原仓库。第二步Clone克隆到本地机器接下来把项目复制到你自己的电脑上。⚠️ 重要警告千万不要克隆原仓库first-contributions 主仓库必须先进入你在上一步 Fork 出来的、位于你自己账户下的副本再克隆它。具体操作当前版本 GitHub Desktop 流程在你的 Fork 副本页面点击Code或旧版界面的 Clone or Download按钮在下拉菜单中选择Open in GitHub Desktop浏览器会唤起本机已安装的 GitHub Desktop弹出系统提示时点击Open GitHubDesktop.exe确认打开GitHub Desktop 会弹出Clone a repository对话框确认路径后点击Clone随后会出现How are you planning to use this fork?你打算如何使用这个 Fork对话框选择To contribute to the parent project用于向父项目贡献点击Continue。完成上述步骤后first-contributions 的完整内容就被下载到了你的电脑上你拥有了一个可编辑的本地副本。第三步创建分支Branch在 GitHub Desktop 中点击窗口顶部的Current branch当前分支下拉菜单选择New branch新建分支为分支命名格式为add-你的名字例如add-james-smith点击Create branch确认创建。为什么必须新建分支在独立分支上进行修改可以把你的实验性改动与主干隔离方便后续通过 Pull Request 干净地合入上游这是协作开发的基本卫生习惯。第四步修改文件并提交Commit切换到History历史记录标签页右键点击仓库中的Contributors.md文件选择Open in text editor用文本编辑器打开滚动到文件底部按既有格式追加一行你的名字例如你的名字是 James Smith应添加[James Smith](https://github.com/jamessmith)即Markdown 链接格式显示名保存文件回到 GitHub Desktop可以看到Contributors.md的改动已被自动检测并列入变更列表在左下角的Summary摘要输入框中填写提交信息Add 你的名字 to Contributors list并将你的名字替换为你的真实姓名点击Commit to add-your-name提交到你的分支按钮提交完成后窗口底部会显示这条 commit 已成功创建。这一格式正是仓库中数百名贡献者留下的真实记录样式你可以在 Contributors.md 中查看大量先例作为参考。第五步Push推送到 GitHub提交只在本地生效还需要推送到你在 GitHub 上的 Fork 副本点击File → Options文件 → 选项登录 GitHub.com输入你的 GitHub 用户名和密码建议使用官方推荐的登录方式完成授权点击右上角的Publish发布按钮将本地分支及其中的提交推送到远端。Push 完成后你 Fork 的远程仓库中就出现了带有你修改的分支。第六步提交 Pull Request 等待合并在浏览器中打开你自己的 Fork 仓库页面会看到黄色的Compare pull request按钮点击它确认比较范围正确你的add-你的名字分支 → 上游 main 分支后点击Create pull request提交 Pull Request提交成功后项目维护者会尽快把你的改动合并进上游项目的main分支合并完成后你会收到一封邮件通知届时你的名字就正式出现在贡献者名单里了。原理视角GUI 按钮背后的 Git 工作流上面的每一步 GUI 操作在底层都对应标准的 Git 命令理解映射关系有助于你日后过渡到命令行GitHub Desktop 操作对应的 Git 概念/命令作用Fork 按钮远程仓库复制在账户下创建上游仓库副本Open in GitHub Desktop Clonegit clone把远端仓库完整下载到本地New branchgit checkout -b branch创建并切换到新分支Commit to add-your-namegit commit -m Add ...把暂存区的改动固化为一次提交Publishgit push把本地提交推送到远端分支Compare pull request合并请求PR请求上游维护者审核并合入你的改动从源码结构看本仓库的 docs/gui-tool-tutorials/ 目录正是为不同工具GitHub Desktop、命令行、Sourcetree、VS Code、IntelliJ 等分别编写的教程而 README.md 负责汇总入口docs/translations/Translations.md 则收录了数十种语言的版本——整个仓库本身就是用贡献教学贡献的产物你提交的 PR 将成为这条学习链路的一环。之后还能做什么进阶材料与更多工具恭喜你已经完整走完了作为贡献者会反复遇到的fork → clone → edit → PR标准工作流。接下来可以庆祝并分享你的第一次开源贡献遇到疑问或需要帮助时可以加入社区 Slack 团队寻求支持深入学习更多 Git 进阶技巧见 附加材料索引涵盖修改最近一次提交Amending a commit、配置 GitConfiguring git、保持 Fork 与上游同步Keeping your fork synced、解决合并冲突Resolving Merge Conflicts、压缩提交Squashing Commits、回退提交Reverting/Undoing a commit、创建 .gitignore 文件、存储凭据等实用主题如果想用其他工具完成同样的流程可返回 README.md 首页在 Tutorials Using Other Tools 部分选择命令行CLI、Sourcetree、VS Code、IntelliJ 等对应教程。总结一次成功的开源贡献本质上是四步循环Fork 得到你的专属副本 → Clone 拉取到本地 → 在独立分支上修改并 Commit → Push 后发起 Pull Request 等待合并。GitHub Desktop 把这条链路上的每个环节都变成了图形化点击操作极大降低了新手的入门门槛。本文以 first-contributions 项目的泰语版 GitHub Desktop 教程为骨架结合仓库内真实文件Contributors.md与多语言教程体系Translations.md进行了展开。现在打开 GitHub Desktop把你的名字写进贡献者名单吧。赞分享文档教程开源治理【免费下载链接】first-contributions✨ Help beginners to contribute to open source projects项目地址https://gitcode.com/gh_mirrors/fi/first-contributions点击查看免费下载相关推荐使用 GitKraken 完成第一次开源贡献first-contributions 项目的 fork → clone → edit → PR 实战指南使用 GitKraken 完成第一次开源贡献first contributions 项目的 fork → clone → edit → PR 实战指南 本篇指文档教程开源治理first-contributions 实战指南用 fork → clone → edit → PR 流程完成你的第一次开源贡献first contributions 实战指南用 fork → clone → edit → PR 流程完成你的第一次开源贡献 first contribu文档教程开源治理First Contributions 开源首次贡献实战指南使用 GitHub Desktop 完成 fork → clone → edit → PR 全流程First Contributions 开源首次贡献实战指南使用 GitHub Desktop 完成 fork → clone → edit → PR 全流程文档教程开源治理创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表