使用 GitKraken 完成第一次开源贡献first-contributions 仓库图形化实战指南【免费下载链接】first-contributions✨ Help beginners to contribute to open source projects项目地址: https://gitcode.com/gh_mirrors/fi/first-contributions本篇指南以 first-contributions 开源练习仓库为实战对象完整演示如何仅凭 GitKraken 这一图形化客户端完成fork → clone → 建分支 → 修改 → 提交 → 推送 → Pull Request的全流程首次开源贡献。全程无需触碰命令行读者学完即可独立完成一次真实的开源 PR并为后续参与任意开源项目打下基础。为什么用图形化工具做第一次贡献第一次做某件事总是困难的——尤其是在协作场景中犯错会让人不安。而开源的本质恰恰是协作与共同工作原文ο ανοιχτός κώδικας αφορά τη συνεργασία。first-contributions 项目正是为了简化新手第一次贡献的学习路径而设计与其阅读大量文章和视频不如在一个安全的环境里真正动手做一次。本仓库README.md的主流程面向熟悉命令行的开发者提供了git clone、git switch -c、git add、git commit、git push等完整命令教程而本文对应的希腊语版 GitKraken 教程docs/gui-tool-tutorials/translations/Greek/gitkraken-tutorial.gr.md及英文原版docs/gui-tool-tutorials/gitkraken-tutorial.md则面向不熟悉命令行的读者用 GitKraken 的图形界面完成同样的操作。两者的底层 Git 语义完全一致本文会同时给出对应的命令行版本供对照。准备工作安装 GitKraken 并登录 GitHub从 GitKraken 官网下载 GitKraken安装后打开。首次启动会弹出Welcome to GitKraken欢迎使用 GitKraken模态对话框——选择Sign in with GitHub使用 GitHub 登录并授权 GitKraken 访问你的 GitHub 账号。这一步是图形化工具与命令行最大的区别GitKraken 通过 GitHub OAuth 完成身份认证后续的克隆、推送等远程操作都基于这次授权无需再单独配置 SSH 密钥或 Personal Access Token。可选进入File → Preferences文件 → 偏好设置将project directory项目目录设置为本地仓库的根目录。这样 GitKraken 会自动发现该目录下的所有仓库便于统一管理。第一步Fork复制上游仓库在 first-contributions 仓库页面顶部点击Fork按钮。这一步会在你自己的 GitHub 账号下创建该仓库的一份副本即你专属的 fork后续所有修改都发生在你自己的副本上不会影响上游仓库。命令行对照Fork 是 GitHub 网页端独有的操作没有对应 git 命令它相当于在服务器端克隆一份副本到你的账号。README 中也同样以点击 Fork 按钮开始README.md。第二步在 GitKraken 中克隆仓库在 GitKraken 中进入File → Clone Repo文件 → 克隆仓库。在右侧面板选择GitHub.com授权后面板会列出你的账号仓库找到first-contributions并点击选中。检查窗口底部显示的完整路径full path确认克隆到本地磁盘的目标位置无误。点击Clone the repo!克隆该仓库。命令行对照git clone 你的 fork 的 URL例如git clone gitgithub.com:this-is-you/first-contributions.git见 README.md。图形化版本省去了复制 URL 和手输命令的步骤。第三步创建功能分支点击工具栏上的branch分支按钮将新分支命名为add-你的名字格式例如原文示例add-william-sutton希腊语教程原文示例为προσθήκη-ονόματος-William-Sutton即add-william-sutton的希腊语翻译。分支命名的add-前缀直观表明该分支的目的——新增内容这是开源社区常见的分支命名习惯。独立分支让每次改动彼此隔离是协作中的关键工程实践可进一步阅读仓库内的 why-using-branches.md。命令行对照git switch -c add-william-sutton若 git 版本较旧不支持switch可用git checkout -b add-william-sutton见 README.md。第四步修改文件、暂存Stage并提交Commit4.1 编辑 Contributors.md用文本编辑器打开仓库根目录的 Contributors.md把自己的名字加进去然后保存。该文件是 contributors 名单列表目前已积累了数千条贡献者记录每条形如- 名字。README 还特别建议不要加在文件开头或结尾而是加在中间任意位置README.md。4.2 认识 WIP 标记并暂存更改保存文件后回到 GitKraken你会看到界面中出现// WIP标记的最新提交节点旁边会显示变更的文件数量和变更类型新增/修改/删除。点击该节点即可查看变更详情。**Staging暂存**是 Git 的核心概念它告诉 Git这一批文件变更属于即将创建的这次提交。你可以点击Stage all changes暂存所有更改一次性暂存所有修改点击Stage File暂存文件逐个暂存单个文件。命令行对照git add Contributors.md暂存指定文件或git add .暂存全部见 README.md。GitKraken 把git add的语义封装成了可视化按钮。4.3 填写提交信息并提交输入一个清晰、描述性的提交信息例如Add 你的名字 to Contributors list把你的名字替换为你的真实姓名。然后点击Commit提交按钮。4.4 反悔怎么办取消暂存与丢弃如果改变主意你可以Unstage取消暂存把已暂存的更改移回工作区保留文件修改Discard丢弃彻底放弃这些更改。⚠️警告原文明确强调如 discard丢弃 一词所示这是一个破坏性操作。除非你确定不需要当前仓库中的任何更改否则不要执行。提交完成后你已经把全部更改提交到本地 fork 的本地分支副本上——注意此刻更改只存在于本地尚未到达 GitHub。命令行对照git commit -m Add your-name to Contributors list见 README.md。提交信息是提交的名片清晰的信息便于维护者快速理解你的改动。第五步推送更改到 GitHub点击工具栏上的Push推送按钮。在弹出的对话框中选择推送到origin 分支如果希望更改直接反映在 main 分支上否则选择你要推送的目标分支。提交commit是本地操作而推送push才把本地提交同步到 GitHub 上的远程仓库这是初学者最容易混淆的一点。命令行对照git push -u origin your-branch-name-u将本地分支与远程分支建立关联见 README.md。若命令行推送遇到认证失败README 提供了改用 SSH 地址的解决方案git remote set-url origin gitgithub.com:your-username/your_repo.gitREADME.md而 GitKraken 用户在登录授权后一般不会遇到该问题。第六步提交 Pull Request 等待合并推送完成后回到 GitHub 上你自己的 fork 仓库页面会看到Compare pull request比较并创建拉取请求按钮点击它。确认比较的两端无误你的分支 → 上游仓库的 main 分支后点击Create pull request创建拉取请求提交 PR。维护者会将你的更改合并进项目的 main 分支合并完成后你会收到一封邮件通知标志着你的第一次贡献正式被接纳。总结你已掌握的标准贡献流程恭喜你刚刚完成了作为贡献者会反复遇到的标准化工作流fork → clone → edit → PR。这一流程不局限于本仓库它适用于 GitHub 上几乎所有的协作型开源项目。完成第一次贡献后可以进一步探索同步 fork当上游仓库有更新时让本地 fork 保持最新见 keeping-your-fork-synced-with-this-repository.md解决合并冲突PR 与上游改动冲突时如何处理见 resolving-merge-conflicts.md修改与撤销提交修正最近的提交信息或遗漏的文件amending-a-commit.md、撤销本地提交undoing-a-commit.md、合并多个提交squashing-commits.md清理分支PR 合并后删除本地与远程分支见 removing-branch-from-your-repository.md以上进阶主题的完整索引见 additional-material.md。此外本仓库为希腊语读者提供了完整的希腊语入门教程docs/translations/README.gr.md内容与本文基于的希腊语 GitKraken 教程docs/gui-tool-tutorials/translations/Greek/gitkraken-tutorial.gr.md互为补充前者侧重命令行、后者专注图形界面可结合学习。【免费下载链接】first-contributions✨ Help beginners to contribute to open source projects项目地址: https://gitcode.com/gh_mirrors/fi/first-contributions创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 使用 GitKraken 完成第一次开源贡献：first-contributions 仓库图形化实战指南
使用 GitKraken 完成第一次开源贡献first-contributions 仓库图形化实战指南【免费下载链接】first-contributions✨ Help beginners to contribute to open source projects项目地址: https://gitcode.com/gh_mirrors/fi/first-contributions本篇指南以 first-contributions 开源练习仓库为实战对象完整演示如何仅凭 GitKraken 这一图形化客户端完成fork → clone → 建分支 → 修改 → 提交 → 推送 → Pull Request的全流程首次开源贡献。全程无需触碰命令行读者学完即可独立完成一次真实的开源 PR并为后续参与任意开源项目打下基础。为什么用图形化工具做第一次贡献第一次做某件事总是困难的——尤其是在协作场景中犯错会让人不安。而开源的本质恰恰是协作与共同工作原文ο ανοιχτός κώδικας αφορά τη συνεργασία。first-contributions 项目正是为了简化新手第一次贡献的学习路径而设计与其阅读大量文章和视频不如在一个安全的环境里真正动手做一次。本仓库README.md的主流程面向熟悉命令行的开发者提供了git clone、git switch -c、git add、git commit、git push等完整命令教程而本文对应的希腊语版 GitKraken 教程docs/gui-tool-tutorials/translations/Greek/gitkraken-tutorial.gr.md及英文原版docs/gui-tool-tutorials/gitkraken-tutorial.md则面向不熟悉命令行的读者用 GitKraken 的图形界面完成同样的操作。两者的底层 Git 语义完全一致本文会同时给出对应的命令行版本供对照。准备工作安装 GitKraken 并登录 GitHub从 GitKraken 官网下载 GitKraken安装后打开。首次启动会弹出Welcome to GitKraken欢迎使用 GitKraken模态对话框——选择Sign in with GitHub使用 GitHub 登录并授权 GitKraken 访问你的 GitHub 账号。这一步是图形化工具与命令行最大的区别GitKraken 通过 GitHub OAuth 完成身份认证后续的克隆、推送等远程操作都基于这次授权无需再单独配置 SSH 密钥或 Personal Access Token。可选进入File → Preferences文件 → 偏好设置将project directory项目目录设置为本地仓库的根目录。这样 GitKraken 会自动发现该目录下的所有仓库便于统一管理。第一步Fork复制上游仓库在 first-contributions 仓库页面顶部点击Fork按钮。这一步会在你自己的 GitHub 账号下创建该仓库的一份副本即你专属的 fork后续所有修改都发生在你自己的副本上不会影响上游仓库。命令行对照Fork 是 GitHub 网页端独有的操作没有对应 git 命令它相当于在服务器端克隆一份副本到你的账号。README 中也同样以点击 Fork 按钮开始README.md。第二步在 GitKraken 中克隆仓库在 GitKraken 中进入File → Clone Repo文件 → 克隆仓库。在右侧面板选择GitHub.com授权后面板会列出你的账号仓库找到first-contributions并点击选中。检查窗口底部显示的完整路径full path确认克隆到本地磁盘的目标位置无误。点击Clone the repo!克隆该仓库。命令行对照git clone 你的 fork 的 URL例如git clone gitgithub.com:this-is-you/first-contributions.git见 README.md。图形化版本省去了复制 URL 和手输命令的步骤。第三步创建功能分支点击工具栏上的branch分支按钮将新分支命名为add-你的名字格式例如原文示例add-william-sutton希腊语教程原文示例为προσθήκη-ονόματος-William-Sutton即add-william-sutton的希腊语翻译。分支命名的add-前缀直观表明该分支的目的——新增内容这是开源社区常见的分支命名习惯。独立分支让每次改动彼此隔离是协作中的关键工程实践可进一步阅读仓库内的 why-using-branches.md。命令行对照git switch -c add-william-sutton若 git 版本较旧不支持switch可用git checkout -b add-william-sutton见 README.md。第四步修改文件、暂存Stage并提交Commit4.1 编辑 Contributors.md用文本编辑器打开仓库根目录的 Contributors.md把自己的名字加进去然后保存。该文件是 contributors 名单列表目前已积累了数千条贡献者记录每条形如- 名字。README 还特别建议不要加在文件开头或结尾而是加在中间任意位置README.md。4.2 认识 WIP 标记并暂存更改保存文件后回到 GitKraken你会看到界面中出现// WIP标记的最新提交节点旁边会显示变更的文件数量和变更类型新增/修改/删除。点击该节点即可查看变更详情。**Staging暂存**是 Git 的核心概念它告诉 Git这一批文件变更属于即将创建的这次提交。你可以点击Stage all changes暂存所有更改一次性暂存所有修改点击Stage File暂存文件逐个暂存单个文件。命令行对照git add Contributors.md暂存指定文件或git add .暂存全部见 README.md。GitKraken 把git add的语义封装成了可视化按钮。4.3 填写提交信息并提交输入一个清晰、描述性的提交信息例如Add 你的名字 to Contributors list把你的名字替换为你的真实姓名。然后点击Commit提交按钮。4.4 反悔怎么办取消暂存与丢弃如果改变主意你可以Unstage取消暂存把已暂存的更改移回工作区保留文件修改Discard丢弃彻底放弃这些更改。⚠️警告原文明确强调如 discard丢弃 一词所示这是一个破坏性操作。除非你确定不需要当前仓库中的任何更改否则不要执行。提交完成后你已经把全部更改提交到本地 fork 的本地分支副本上——注意此刻更改只存在于本地尚未到达 GitHub。命令行对照git commit -m Add your-name to Contributors list见 README.md。提交信息是提交的名片清晰的信息便于维护者快速理解你的改动。第五步推送更改到 GitHub点击工具栏上的Push推送按钮。在弹出的对话框中选择推送到origin 分支如果希望更改直接反映在 main 分支上否则选择你要推送的目标分支。提交commit是本地操作而推送push才把本地提交同步到 GitHub 上的远程仓库这是初学者最容易混淆的一点。命令行对照git push -u origin your-branch-name-u将本地分支与远程分支建立关联见 README.md。若命令行推送遇到认证失败README 提供了改用 SSH 地址的解决方案git remote set-url origin gitgithub.com:your-username/your_repo.gitREADME.md而 GitKraken 用户在登录授权后一般不会遇到该问题。第六步提交 Pull Request 等待合并推送完成后回到 GitHub 上你自己的 fork 仓库页面会看到Compare pull request比较并创建拉取请求按钮点击它。确认比较的两端无误你的分支 → 上游仓库的 main 分支后点击Create pull request创建拉取请求提交 PR。维护者会将你的更改合并进项目的 main 分支合并完成后你会收到一封邮件通知标志着你的第一次贡献正式被接纳。总结你已掌握的标准贡献流程恭喜你刚刚完成了作为贡献者会反复遇到的标准化工作流fork → clone → edit → PR。这一流程不局限于本仓库它适用于 GitHub 上几乎所有的协作型开源项目。完成第一次贡献后可以进一步探索同步 fork当上游仓库有更新时让本地 fork 保持最新见 keeping-your-fork-synced-with-this-repository.md解决合并冲突PR 与上游改动冲突时如何处理见 resolving-merge-conflicts.md修改与撤销提交修正最近的提交信息或遗漏的文件amending-a-commit.md、撤销本地提交undoing-a-commit.md、合并多个提交squashing-commits.md清理分支PR 合并后删除本地与远程分支见 removing-branch-from-your-repository.md以上进阶主题的完整索引见 additional-material.md。此外本仓库为希腊语读者提供了完整的希腊语入门教程docs/translations/README.gr.md内容与本文基于的希腊语 GitKraken 教程docs/gui-tool-tutorials/translations/Greek/gitkraken-tutorial.gr.md互为补充前者侧重命令行、后者专注图形界面可结合学习。【免费下载链接】first-contributions✨ Help beginners to contribute to open source projects项目地址: https://gitcode.com/gh_mirrors/fi/first-contributions创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考