文档教程开源治理【免费下载链接】first-contributions✨ Help beginners to contribute to open source projects项目地址https://gitcode.com/gh_mirrors/fi/first-contributions点击查看免费下载本篇指南以 first-contributions 开源仓库帮助初学者迈出开源第一步的入门项目中的 GitKraken 教程西班牙语版 为主体面向不习惯命令行、希望使用图形化 Git 客户端参与开源的新手系统讲解如何借助 GitKraken 完成从 Fork 仓库、克隆到本地、创建分支、修改Contributors.md、暂存与提交、推送到 GitHub再到提交 Pull Request 的完整流程。读完本文你将掌握开源贡献中最经典的fork → clone → edit → PR工作流并理解每一步在 Git 底层对应的实际含义之后可以无障碍地迁移到任何其他开源项目。为什么用 GitKraken 做第一次贡献对任何人来说第一次做一件事总是困难的协作时犯错更令人不适。但开源的本质正是协作与共同工作。first-contributions 项目的目标就是简化新手第一次贡献的学习路径——在本仓库中你可以在一个真实存在的开源项目上完整体验贡献流程而不会真正弄坏任何东西。阅读文章、观看教程都很有帮助但没有什么比在不破坏任何东西的前提下亲手操作一遍更有效。对于不熟悉命令行的用户本仓库在 README.md 的 CLI 教程之外还提供了多套 GUI 工具的图文教程其中 gitkraken-tutorial.md 及其多语言翻译如本文依据的西班牙语版专门讲解 GitKraken 的使用方式。GitKraken 作为一款图形化 Git 客户端将分支、暂存、提交、推送等操作可视化极大降低了初学者的认知负担。整个流程非常短你只需要依次完成Fork 仓库 → 克隆到本地 → 创建分支 → 修改文件 → 暂存并提交 → 推送到 GitHub → 提交 Pull Request。第一步安装 GitKraken 并完成 GitHub 授权在开始操作前需要先下载并安装 GitKraken然后打开它。首次启动时你会看到 Welcome to GitKraken欢迎使用 GitKraken模态对话框。此时请选择使用 GitHub 账号登录并允许 GitKraken 访问你的 GitHub 账户。这一步授权是后续直接浏览并克隆自己名下仓库的前提——GitKraken 通过 OAuth 认证后才能在你的 GitHub 账户中读取仓库列表。可选配置进入File - Preferences文件 → 偏好设置将项目目录project directory设置为本地仓库的根目录。这样做之后克隆出来的仓库都会集中存放在统一位置方便后续管理。第二步Fork复刻本仓库在 GitHub 上打开 first-contributions 仓库页面点击页面右上角的Fork按钮。Fork 操作会在你自己的 GitHub 账户下创建一份本仓库的副本。这一步的意义在于你无法直接向别人的仓库推送代码但可以自由地在自己的副本上修改之后通过 Pull Request 请求把修改合并回原仓库。CLI 对照Fork 本身是 GitHub 平台层面的操作没有对应的本地 git 命令但它为后续的git clone提供了属于自己的仓库地址。第三步在 GitKraken 中克隆仓库在 GitKraken 中执行File - Clone Repo文件 → 克隆仓库打开克隆对话框在右侧面板中选择GitHub.comGitKraken 会通过第一步的授权拉取你的仓库列表在你的用户名username下方找到first-contributions即你 Fork 出来的那份副本点击该仓库并核对面板底部显示的完整本地路径确认仓库将被克隆到你期望的目录确认路径无误后点击Clone the repo!按钮完成克隆。克隆完成后仓库的完整内容包括README.md、Contributors.md以及 docs 目录下的全部教程都会出现在本地同时 GitKraken 会自动识别出origin你的 Fork 副本与upstream原仓库等远程配置关系。CLI 对照这一步在命令行中对应git clone。README 中的 CLI 教程给出了等价命令例如git clone gitgithub.com:this-is-you/first-contributions.git其中this-is-you是你的 GitHub 用户名。第四步创建你的专属分支点击 GitKraken 工具栏上的Branch分支按钮为本次贡献创建一个新分支。分支名称请使用add-your-name这样的约定格式例如add-william-sutton将名字替换为你自己的名字。在开源协作中为每个功能或贡献创建独立分支是通行做法它让你的修改与主分支main隔离便于独立开发和审查。CLI 对照在命令行中创建并切换到新分支使用git switch -c your-new-branch-name例如git switch -c add-alonzo-church若使用较旧版本的 Git可改用git checkout -b your-new-branch-name。第五步修改 Contributors.md 并提交Commit5.1 编辑文件用任意文本编辑器打开仓库根目录下的 Contributors.md在其中添加你的名字然后保存文件。该文件是一个由历届贡献者姓名多带有个人 GitHub 主页链接组成的 Markdown 列表已有数千行记录因此建议把名字加在文件中间任意位置而不是开头或结尾以减少与其他人同时编辑时产生合并冲突的概率。5.2 在 GitKraken 中查看变更由于仓库已在 GitKraken 中打开你会立即看到工作区出现变更最新提交commit会带有一个// WIPWork In Progress进行中标记并显示变更的文件数量与变更类型新增/修改/删除。这正是 Git 对工作区状态的可视化呈现。CLI 对照命令行中对应执行git status同样会列出已修改但尚未暂存的文件。5.3 暂存Stage变更审阅变更后决定要将哪些文件纳入本次提交。暂存stage非常关键——它告诉 Git 精确地哪些文件变更要与本次提交关联从而保证提交内容干净、聚焦、可追溯。GitKraken 提供两个入口Stage all changes暂存所有已修改的文件Stage File只暂存某一个单独文件。对于本次练习只需暂存修改过的Contributors.md即可。如果改变主意也可以执行unstage取消暂存让文件回到未暂存状态。注意GitKraken 还提供Discard丢弃操作。正如其名这是一个破坏性操作——它会直接丢弃工作区中未提交的所有改动且无法恢复。只有在确定不想要当前任何改动时才应使用。CLI 对照暂存对应git add Contributors.md丢弃对应git checkout -- file或git restore file。5.4 编写提交信息并提交编写一条清晰、描述性的提交信息例如Add your-name to Contributors list将your-name替换为你的名字。这样一条信息既能准确说明改动内容也符合开源社区对提交信息简洁、描述性的普遍期望。填写完成后点击Commit提交按钮。至此你的改动已作为一次提交写入本地分支即你 Fork 副本的本地副本中但尚未同步到 GitHub。CLI 对照命令行中对应git commit -m Add your-name to Contributors list。第六步推送Push到 GitHub点击工具栏上的Push推送按钮将本地分支推送到远程仓库。推送时 GitKraken 会让你选择目标分支选择origin 分支如果你希望变更直接反映到主分支main可以直接推送到 origin选择其他合适的分支更推荐的做法是将新分支推送到 origin 上对应的同名分支即你第四步创建的那个分支以便后续针对该分支发起 Pull Request。完成推送后你的改动就出现在 GitHub 上你自己的 Fork 仓库中了。CLI 对照命令行中对应git push -u origin your-branch-name-u用于建立本地分支与远程分支的跟踪关系。若推送时遇到认证错误例如 2021 年 8 月起 GitHub 移除了密码认证需要改用 SSH 密钥或个人访问令牌并可用git remote -v检查远程地址、用git remote set-url修正远程配置。第七步提交 Pull Request 等待合并推送成功后打开 GitHub 上你自己的 first-contributions Fork 仓库页面你会看到一个Compare pull request按钮点击它。此时 GitHub 会进入 Pull Request 创建页面对比你的分支与原仓库主分支之间的差异即你新增的贡献者记录。确认无误后点击提交按钮正式创建 Pull Request。之后仓库维护者会将你的改动合并进项目的main分支合并完成后你会收到一封通知邮件。CLI 对照Pull Request 是 GitHub 平台层面的协作机制没有本地 git 命令对应它正是fork模型下请求把副本中的修改合入原仓库的标准方式。后续进阶让这条工作流成为你的肌肉记忆恭喜你刚刚完成了作为贡献者会频繁遇到的经典fork → clone → edit → PR工作流。庆祝之余你还可以继续深入了解 Git 的高级用法——本仓库在 additional-material.md 中系统整理了后续学习材料包括修改提交Amending a commit修改最近一次提交的信息或补充遗漏的变更配置 GitConfiguring git管理用户名、邮箱等个人配置保持 Fork 与上游同步让你的 Fork 跟上原仓库的更新解决合并冲突Resolving merge conflicts处理多分支修改同一文件时产生的冲突压缩提交Squashing commits通过交互式 rebase 将多个提交合并为一个撤销与回退Reverting / Undoing a commit撤销已推送或本地的提交删除分支、移动提交、stash 暂存、.gitignore、凭据存储等常用操作。这些场景全部围绕 Git 日常协作展开与本文的 GUI 工作流一脉相承可以作为下一步的学习方向。此外仓库还提供了 GitHub Desktop、Visual Studio Code、IntelliJ IDEA、Sourcetree、Visual Studio 2017 等其他 GUI 工具的同主题教程入口见 README.md 的 Tutorials Using Other Tools 部分以及对应的 CLI 命令行教程你可以按自己的习惯选择工具反复练习同一套工作流直到它成为肌肉记忆。小结本文以 first-contributions 仓库的 GitKraken 西班牙语教程 为骨架完整梳理了使用 GitKraken 完成首次开源贡献的七个步骤安装与授权 → Fork → Clone → 创建分支 → 修改并提交 → Push → Pull Request。每一步都给出了 GUI 操作细节并对照 README.md 中的 CLI 教程补充了等价命令帮助你同时建立图形界面操作与 Git 底层概念的对应关系。只要把这条流程走通一遍你就已经具备了参与任意开源项目的最核心协作能力。赞分享文档教程开源治理【免费下载链接】first-contributions✨ Help beginners to contribute to open source projects项目地址https://gitcode.com/gh_mirrors/fi/first-contributions点击查看免费下载相关推荐first-contributions 首次开源贡献实战指南Fork、Clone、Branch、Commit、Push 与 Pull Request 全流程first contributions 首次开源贡献实战指南Fork、Clone、Branch、Commit、Push 与 Pull Request 全流程文档教程开源治理first-contributions 开源贡献实战使用 GitHub Desktop 完成从 Fork 到 Pull Request 的首次贡献全流程first contributions 开源贡献实战使用 GitHub Desktop 完成从 Fork 到 Pull Request 的首次贡献全流程 本篇文档教程开源治理GitKraken 开源贡献入门实战基于 first-contributions 完成 Fork 到 Pull Request 全流程GitKraken 开源贡献入门实战基于 first contributions 完成 Fork 到 Pull Request 全流程 本篇技术指南以 fir文档教程开源治理创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考