
害怕命令行用GitHub Desktop完成第一次开源贡献——First Contributions完整图形界面教程【免费下载链接】first-contributions✨ Help beginners to contribute to open source projects项目地址: https://gitcode.com/gh_mirrors/fi/first-contributionsFirst Contributions是一个专为新手打造的开源练手场你只需在名单文件里加上自己的名字就能完整走一遍 fork → 克隆 → 修改 → 提交 → 合并请求的标准贡献流程。本文将演示如何用GitHub Desktop 图形界面一步步完成你的第一次开源贡献全程无需输入任何命令行指令10 分钟即可上手。开始前你需要准备什么 开始第一次开源贡献前请确认已完成以下两件事准备工作说明GitHub Desktop一款免费的 Git 图形化客户端把克隆、分支、提交、推送全部变成按钮一个 GitHub 账号用于 fork 仓库、登录 GitHub Desktop 和创建 Pull Request任意文本编辑器用于修改Contributors.md文件即可 如果你以后想学命令行操作可以参考仓库内的 git-cli-tutorial.md 和 github-cli-tutorial.md 两篇 CLI 教程。第 1 步Fork 你的 First Contributions 仓库打开 First Contributions 项目页面点击右上角的Fork按钮相当于把这个仓库完整复制到你自己的账号下。⚠️ 新手最常见的错误是直接克隆了原版仓库。请记住一定要克隆你自己的 fork否则你没有推送权限。第 2 步一键克隆仓库到本地进入你的 fork 页面点击Code按钮点击Open in GitHub Desktop在弹窗中确认打开 GitHub Desktop在弹出的Clone a repository对话框中点击Clone在How are you planning to use this fork?页面选择To contribute to the parent project为了向父项目贡献代码点击Continue。如果你是在 GitHub Desktop 中手动克隆本地路径填写你 fork 后的仓库地址格式如https://gitcode.com/gh_mirrors/fi/first-contributions的你的 fork 版本。完成后仓库内容就出现在你的电脑上了。第 3 步创建分支——你的专属安全沙盒 点击窗口顶部的Current branch当前分支下拉框选择New branch…分支名建议用add-你的名字格式例如add-james-smith点击Create branch确认创建。在独立分支上修改文件即使改错了也不会影响主分支这是最安全的新手保护机制。第 4 步修改 Contributors.md 并提交这一步是整个第一次开源贡献的核心——把名字写进贡献者名单切换到History历史标签页找到并右键Contributors.md选择用文本编辑器打开把名字写在文件中间任意位置不要放在开头或结尾格式参考文件内已有条目保存文件回到 GitHub Desktop你会看到文件出现在变更列表中。接着填写提交信息并提交Summary输入框填写Add your-name to Contributors list将your-name换成你的名字点击Commit to your-branch按钮。窗口底部会显示一条新的提交记录代表本次修改已成功记录在案。第 5 步登录并推送Push你的更改首次推送前需要先让 GitHub Desktop 认识你的账号打开File → Options偏好设置→ Account输入并登录你的 GitHub 账号回到主窗口点击右上角的Publish branch发布分支按钮你的新分支和提交记录就会同步到你的 fork 远程仓库。第 6 步提交 Pull Request完成贡献推送成功后打开你的 fork 仓库页面你会看到醒目的Compare pull request按钮点击它确认对比内容无误应该只有Contributors.md的一处改动点击Create pull request填写标题和描述后提交 Pull Request。之后项目维护者会审核并合并你的更改你会收到一封合并通知邮件——至此你的第一次开源贡献正式完成下一步去哪里继续练手你刚刚走完了开源社区最经典的fork → clone → edit → PR完整工作流。接下来可以阅读仓库的 README.md 了解项目全部流程对照官方图文教程 docs/gui-tool-tutorials/github-desktop-tutorial.md 逐步复盘本文操作尝试其他图形工具如 GitKraken 教程、VS Code 教程查阅 docs/additional-material/git_workflow_scenarios/additional-material.md学习撤销提交、解决合并冲突等进阶场景。第一次总是最难的但完成一次真实的开源贡献后你会发现命令行并不是门槛——图形界面 正确的工作流才是新手最好的起点。【免费下载链接】first-contributions✨ Help beginners to contribute to open source projects项目地址: https://gitcode.com/gh_mirrors/fi/first-contributions创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考