从 Fork 到第一个 PR：开源新手最完整的一次实战

从 Fork 到第一个 PR：开源新手最完整的一次实战

很多开源新手第一次真正想“做点贡献”，通常会卡在两个地方。

第一是不会找入口，不知道从哪里改起；第二是不会走流程，不知道 Fork、Branch、Commit、Push、PR 之间到底是什么关系。于是明明只是想修一个小问题，最后却连提交入口都找不到。

这篇文章不讲空话，直接把一次开源贡献拆成最容易理解的 6 个动作：Fork、Clone、Branch、Commit、Push、PR。你看完之后，至少能知道第一个 PR 应该怎么走。

一、为什么第一个 PR 最重要

第一个 PR 的意义，不在于你改了多少代码，而在于你真正完成了一次开源协作闭环。

只要你走通一次完整流程，后面再做第二次、第三次，心理门槛会下降很多。很多人不是不会写，而是从来没真正提交过一次。开源贡献的第一步，往往就是把“不敢动”变成“敢提交”。

二、先 Fork，再开始修改

1. Fork 的作用

Fork 是把别人的仓库复制到自己的 GitHub 账号下。这样你就有了一个可以自由修改的副本。

对于新手来说，Fork 的意义很大：你不用直接碰原仓库，也不会因为操作失误影响别人。

2. Clone 到本地

Fork 完之后，把仓库拉到本地：

gitclone git@github.com:你的账号/仓库名.gitcd仓库名

如果你前一篇已经把 SSH 配好了，这一步通常会很顺畅。

三、不要在 main 上直接改

新手很容易图省事，直接在main分支上修改。这样做不推荐。

正确方式是先新建一个分支，分支名尽量清晰：

gitcheckout-bfeat/fix-docs-typo

分支名里最好带上类型前缀，例如：

• feat/：新增功能；
• fix/：修复问题；
• docs/：文档修改；
• refactor/：重构；
• test/：测试相关。

这种写法不仅方便自己，也方便后续维护者快速理解你的改动目的。

四、从小改动开始，成功率更高

第一次提 PR，不建议上来就改复杂逻辑。最适合新手的切入口其实很简单：

• 修一个 README 错别字；
• 补一个命令说明；
• 改一处文档不清楚的地方；
• 修一张截图；
• 优化一个示例代码。

这些改动看起来小，但非常适合作为第一次提交，因为它们更容易被接受，也更容易验证。

很多老手也是从这些小修改开始熟悉一个项目的。

五、提交前先检查三件事

在commit之前，建议你先做三个检查。

1. 看当前状态

gitstatus

2. 看具体改动

gitdiff

3. 确认哪些文件要提交

gitadd.gitstatus

如果你连自己改了什么都说不清楚，PR 描述大概率也写不好。先看懂自己的改动，再提交，通常更稳。

六、一个合适的提交信息很加分

提交信息最好简洁清楚，例如：

gitcommit-m"docs: fix typo in readme"

这种格式的好处是，一眼就能知道改动类型。对于开源项目来说，可读的提交信息非常重要，因为它会进入历史记录，也方便后续检索。

七、Push 到远程分支

gitpush origin feat/fix-docs-typo

如果远程仓库里还没有这个分支，Git 通常会提示你创建上游关联。第一次看到提示不要慌，这只是正常流程的一部分。

八、Pull Request 不是“交作业”，而是“说明你的改动”

PR 页面最重要的不是“我改了”，而是“我为什么改、改了什么、怎么验证”。

建议你在 PR 描述里至少写清楚下面 4 点：

• 改了什么；
• 为什么改；
• 怎么验证；
• 有没有副作用。

如果你是新手，描述尽量写得朴素一些，不要追求很花哨。只要把事实说明白，维护者通常就能快速判断。

九、PR 被问到问题怎么办

如果维护者在评论区问你问题，不要紧张。常见情况其实只有几种：

• 让你补截图；
• 让你说明验证方式；
• 让你把 PR 拆小一点；
• 让你改一下命名；
• 让你补充测试说明。

这些都很正常。开源协作本来就是一个沟通过程，不是一次性上交结果。

十、为什么这个流程适合新手写文章

因为它非常完整，也非常具体。读者能在文章里同时学到：

• 开源协作怎么走；
• Git 基础命令怎么用；
• PR 的核心目的是什么；
• 为什么小改动更容易通过；
• 新手应该怎么开始。

而且这类内容非常适合配图：你可以在文章里插入 Fork 页面、分支图、PR 页面截图、命令行输出。图文并茂之后，文章会更像真正的教程，而不是简单总结。

十一、给新手的第一个 PR 建议

如果你是第一次提 PR，我最建议你遵循一个原则：改得小一点，说明清楚一点，验证完整一点。

不要一开始就挑战大而复杂的模块。你只要先走完一轮完整流程，就已经完成了开源入门最关键的一步。

十二、总结

从 Fork 到第一个 PR，看似只是一次简单提交，实际上是你第一次真正进入开源协作世界。

它会帮你理解仓库结构、分支管理、提交历史、评审沟通和协作边界。只要你走通一次，后面很多看起来陌生的操作，都会变得自然很多。

如果前一篇是“环境配置”，这一篇就是“正式上手”。下一篇最适合写的内容，是“如何找到第一个 good first issue”，因为当你会提 PR 之后，就该学会去找适合自己的任务了。

参考链接

• Git 官方书籍：https://git-scm.com/book/en/v2
• GitHub Pull Requests：https://docs.github.com/pull-requests
• GitHub Fork 指南：https://docs.github.com/