企业官网建设流程全解析

first-contributions 仓库指南：以 fork → clone → edit → pull request 完成你的第一次开源贡献

【免费下载链接】first-contributions🚀✨ Help beginners to contribute to open source projects项目地址: https://gitcode.com/gh_mirrors/fi/first-contributions

本文基于 first-contributions 仓库的克什米尔语版入门文档（docs/translations/README.ks.md）撰写，完整呈现该项目面向初学者设计的标准贡献流程。读完本文，你将掌握从 Fork 仓库、Clone 到本地、创建分支、修改 Contributors.md 并提交、Push 到远端、最终提交 Pull Request 的完整实操能力，同时了解 Git 常见报错（如旧版本switch命令不可用、push 认证失败）的排查与解决方式，为后续参与任意开源项目打下基础。

项目背景：为初学者降低第一次贡献的门槛

first-contributions 的核心目标，用文档原话说是「帮助初学者并指导他们，使其能够轻松完成第一次开源贡献」。它把真实开源协作中最典型的一条路径拆解成可逐步照做的步骤，让学习者通过真实提交而非观看教程来获得经验。文档强调：过程越轻松，学习效益越高。

该仓库本身就是一个练习场——真正的修改目标只有一个：把贡献者的名字加入根目录的 Contributors.md 名单。这个文件目前已积累数千行贡献者记录，本身就是该项目「人人皆可贡献」理念的活证据。仓库采用 MIT 协议，全部指导内容以文档形式组织在 docs 目录下，并提供了数十种语言的翻译版本（索引见 docs/translations/Translations.md），README.ks.md 正是其中面向克什米尔语使用者的完整译本。

在开始之前，请先确认本机已安装 Git。若尚未安装，可参考 Git 官方提供的快速安装指引（安装完成后可用git --version验证）。

步骤一：Fork 本仓库

在仓库页面右上角点击Fork按钮。该操作会在你自己的 GitHub 账号下生成一份本仓库的完整副本，此后你对该副本拥有一切修改权限，而不会影响原仓库。Fork 出来的副本就是你后续工作的基地。

步骤二：Clone 仓库到本地

进入你账号下刚刚 Fork 出来的仓库页面：

1. 点击绿色的Code按钮；
2. 切换到SSH标签页；
3. 点击复制按钮，将仓库 URL 复制到剪贴板。

随后打开终端，执行克隆命令（将占位符替换为刚复制的 URL）：

git clone "url you just copied"

实际示例（this-is-you替换为你的 GitHub 用户名）：

git clone git@github.com:this-is-you/first-contributions.git

执行后，仓库内容会被完整下载到本地当前目录下。

步骤三：创建新的工作分支

首先进入克隆下来的仓库目录：

cd first-contributions

然后使用git switch命令创建并切换到一个新分支：

git switch -c your-new-branch-name

示例（分支名习惯以add-开头，表示「添加某位贡献者」）：

git switch -c add-alonzo-church

旧版 Git 兼容提示：如果执行git switch时出现错误信息Git: 'switch' is not a git command. See 'git --help'，说明你使用的 Git 版本较旧，此时请改用等价的git checkout命令：

git checkout -b your-new-branch-name

为什么要单独建分支？这是 Git 协作的标准做法：在独立分支上开发，可以避免直接污染main主分支，也让后续的 Pull Request 对比更加清晰。

步骤四：修改文件并提交（Commit）

1. 用任意文本编辑器打开根目录的 Contributors.md；
2. 将你的名字添加到文件中——文档特别建议不要加在文件开头或结尾，而是加在中间任意位置（这是为了引导初学者练习「编辑已有文件并处理潜在合并冲突」的能力）；
3. 保存文件。

回到终端，用git status查看工作区状态，你会看到Contributors.md已被标记为修改：

git status

将修改加入暂存区（Staging Area）：

git add Contributors.md

提交修改，your-name替换为你的名字：

git commit -m "Add your-name to Contributors list"

这里可以顺带说明 Git 三区模型在本次流程中的体现：git status对应工作区与暂存区的差异检查，git add将文件从工作区移入暂存区，git commit则将暂存区内容固化为一次本地提交记录。

步骤五：将改动 Push 到 GitHub

本地提交完成后，需要把分支推送到你的 GitHub 远端仓库：

git push -u origin your-branch-name

其中your-branch-name替换为第三步创建的分支名。-u（即--set-upstream）的作用是把本地分支与远端分支建立跟踪关系，这样以后在该分支上只需执行git push即可。

常见报错：Authentication Error（认证失败）

如果 push 时报如下错误：

remote: Support for password authentication was removed on August 13, 2021. Please use a personal access token instead. fatal: Authentication failed for 'https://github.com/<your-username>/first-contributions.git/'

说明你正在使用 HTTPS 地址配合账号密码认证，而 GitHub 已不再支持密码方式。文档给出的排查与修复路径如下：

1. 改用 SSH 认证：按照 GitHub 官方教程生成 SSH 密钥并配置到账号；

2. 检查当前远端地址：

   git remote -v

   若输出形如https://github.com/your-username/your_repo.git（HTTPS 协议），则将其改为 SSH 格式：

   git remote set-url origin git@github.com:your-username/your_repo.git

   否则系统仍会提示输入用户名和密码，并最终再次报认证错误。

这一故障处理思路在仓库文档体系中得到了延续——关于凭据管理的进一步细节，可参考 docs/additional-material/git_workflow_scenarios/storing-credentials.md（该文档同时提示凭据存储涉及安全问题，需遵循所在单位的安全规范）。

步骤六：提交 Pull Request 供他人审阅

Push 成功后，回到你的 GitHub 仓库页面，会出现一个醒目的Compare & pull request按钮：

1. 点击该按钮；
2. 确认对比的基准分支（base）是原仓库的main，目标分支（compare）是你刚才推送的分支；
3. 填写说明后提交 Pull Request。

提交后，维护者会将你的改动合并进main分支；合并完成时，你会收到一封邮件通知。至此，一次完整的贡献闭环就完成了。

里程碑：你已走通的标准贡献工作流

祝贺！正如文档所说，你刚刚完整执行了开源贡献者最常遇到的标准工作流：

fork → clone → edit → pull request

这是一条在任何开源项目中都通用的路径，与具体项目无关，因此具有极强的可迁移性。

继续进阶：仓库内的深入资源

完成首次贡献后，仓库还准备了循序渐进的进阶资料（入口见 docs/additional-material/git_workflow_scenarios/additional-material.md），覆盖真实协作中几乎一定会遇到的高频场景：

其中「保持 Fork 与上游同步」特别值得细读：它讲解了开源协作中典型的三角工作流（上游公共仓库 → 你的 GitHub Fork → 本地仓库），核心命令为添加upstream远端、git fetch upstream后用git rebase upstream/main合并，最后git push origin main同步到自己的 Fork；也可用git pull upstream main一步完成「拉取并合并」。建议每次看到 GitHub 提示「落后若干提交」时执行一次该流程。

此外，docs/cli-tool-tutorials 与 docs/gui-tool-tutorials 目录下还提供了命令行扩展教程以及多款 GUI 工具的图文教程（如 GitHub Desktop、Visual Studio Code、GitKraken、IntelliJ IDEA、Sourcetree 等），不习惯命令行的初学者可以按需选用。若想继续练习，仓库的翻译索引 docs/translations/Translations.md 也展示了该项目开放的协作姿态——翻译工作本身同样是一种低门槛的开源贡献方式。

最后记住这句话：第一次贡献的难度，主要来自「不熟悉」而不是「不会」。按本文流程完整走一遍，你收获的不只是一次合并通知，而是对 Git 分支模型、远端协作与 PR 评审机制的亲身体验。

【免费下载链接】first-contributions🚀✨ Help beginners to contribute to open source projects项目地址: https://gitcode.com/gh_mirrors/fi/first-contributions