企业官网建设流程全解析

• 文档
• 教程
• 开源治理

本篇指南以 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（文件 → 克隆仓库），打开克隆对话框：

1. 在右侧面板中选择GitHub.com，GitKraken 会通过第一步的授权拉取你的仓库列表；
2. 在你的用户名（username）下方找到first-contributions（即你 Fork 出来的那份副本）；
3. 点击该仓库，并核对面板底部显示的完整本地路径，确认仓库将被克隆到你期望的目录；
4. 确认路径无误后，点击"Clone the repo!"按钮完成克隆。

克隆完成后，仓库的完整内容（包括README.md、Contributors.md以及 docs 目录下的全部教程）都会出现在本地，同时 GitKraken 会自动识别出origin（你的 Fork 副本）与upstream（原仓库）等远程配置关系。

CLI 对照：这一步在命令行中对应git clone。README 中的 CLI 教程给出了等价命令，例如：

git clone git@github.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 并提交（Commit）

5.1 编辑文件

用任意文本编辑器打开仓库根目录下的 Contributors.md，在其中添加你的名字，然后保存文件。该文件是一个由历届贡献者姓名（多带有个人 GitHub 主页链接）组成的 Markdown 列表，已有数千行记录，因此建议把名字加在文件中间任意位置，而不是开头或结尾，以减少与其他人同时编辑时产生合并冲突的概率。

5.2 在 GitKraken 中查看变更

由于仓库已在 GitKraken 中打开，你会立即看到工作区出现变更：最新提交（commit）会带有一个// WIP（Work 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）：修改最近一次提交的信息或补充遗漏的变更；
• 配置 Git（Configuring 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 底层概念的对应关系。只要把这条流程走通一遍，你就已经具备了参与任意开源项目的最核心协作能力。

• 文档
• 教程
• 开源治理