GitHub开源贡献：从小白到PR达人，你的第一份代码“投名状”怎么写？

sisucd.com · 开源社区 · 2026

又有人问我这个问题了，行，今天一次说清楚！

想给GitHub上的开源项目贡献代码？好样的！这说明你已经不满足于“白嫖”了，开始有“主人翁意识”了。但你肯定要问：我一个萌新，代码还没写溜，怎么去给大佬的项目提PR（Pull Request）？别急，这事儿真没你想的那么玄乎。今天，老司机就带你一步步攻克这个“新手村”任务，让你也能在开源社区留下你的“足迹”。

一、准备工作：磨刀不误砍柴工 (难度: ⭐⭐)

在动手之前，有些基础功课是必须做的。你肯定要问：“我需要下载GitHub桌面版吗？”不一定，命令行才是王道，但桌面版可以帮你理解流程。当然，如果你之前用过 clash安卓或 UU加速器访问GitHub，那网络问题应该不是你的痛点。

注册GitHub账号： 这个不用我多说了吧？没有账号寸步难行。
了解项目： 找到你感兴趣的开源项目，仔细阅读它的README.md文件。里面通常会包含项目的介绍、如何运行、以及最重要的——CONTRIBUTING.md（贡献指南）！这个文件是你的“武功秘籍”，一定要看！
Fork项目： 在项目页面右上角找到“Fork”按钮，点击它。这相当于在你的GitHub账号下复制了一份项目的副本。你所有的修改都将在这个副本上进行，不会影响原项目。
克隆到本地： 将你Fork出来的项目克隆（clone）到你的本地电脑上。打开终端（Terminal）或命令行工具，输入：
```
git clone [你的Fork项目URL]
```

新手常见坑：直接在原项目上修改！

千万别这么干！你没有权限直接修改别人的项目。Fork再克隆到本地是标准流程，不然你连提交代码的入口都找不到。

二、动手修改：你的第一份代码“投名状” (难度: ⭐⭐⭐)

现在，轮到你大显身手了。无论是修复一个bug，还是新增一个功能，亦或是改进文档（文档贡献也是贡献！），都可以从这里开始。

创建分支： 在你本地的项目目录下，用git checkout -b [你的分支名]命令创建一个新的分支。比如：git checkout -b feature/add-new-button。这样做的好处是，你的修改不会污染主分支（通常是main或master）。
进行修改： 在你创建的分支上，用你熟悉的IDE（比如VS Code）进行代码修改或文档撰写。
提交修改： 修改完成后，使用Git命令提交你的改动：
```
git add .
git commit -m "feat: add new button to XXX"
```
注意，提交信息（commit message）要清晰明了，遵循项目的规范。
推送到远程： 将你的本地分支推送到你GitHub上的Fork仓库：
```
git push origin [你的分支名]
```

老司机Tips：养成良好提交习惯

每次只做一件事，提交信息写清楚。这样即使你的PR被拒了，也能快速定位问题。如果你想了解更多，可以搜索“Git commit 规范”或者“Git 提交信息教程”。

三、发起Pull Request：召唤大佬来Review (难度: ⭐⭐⭐)

代码已经推送到你的Fork仓库了，现在是时候通知原项目维护者了。

访问你的Fork仓库： 在GitHub上打开你Fork的那个项目页面，你会看到一个提示，告诉你有一个新的分支可以发起Pull Request。点击“Compare & pull request”按钮。
填写PR信息： 仔细填写PR的标题和描述。标题要简明扼要，描述要详细说明你做了什么，为什么做，以及可能的影响。如果你的修改修复了一个已有的Issue，记得在描述中用Fixes #XXX或Closes #XXX来关联。
提交PR： 确认无误后，点击“Create pull request”。恭喜你，你的PR已经发出去了！

新手常见坑：PR描述敷衍了事！

一个好的PR描述能大大提高你的PR被接受的几率。别指望维护者能从你的代码里猜出你的意图。清晰的沟通远比炫技的代码更重要。你肯定要问，PR流程怎么用文档？多看几个优秀项目的PR就明白了！

接下来就是等待维护者Review（审查）你的代码了。他们可能会提出修改意见（Comments），这时你需要根据意见进行修改，然后再次提交（push）到你原来的分支，PR会自动更新。这个过程可能需要反复几次，耐心是关键！

有问题评论区见，别光看不练啊！