什么是PR
PR是Pull Request的缩写,翻译过来就是“拉取请求”。当你想为一个开源项目贡献代码时,比如修复了一个bug或者新增了一个小功能,就需要通过提交PR来告诉项目维护者:“我改了点东西,你看要不要合并进去”。
准备工作:注册账号和安装工具
参与开源最基本的前提是你得有GitHub账号。没有的话去官网注册一个就行,就跟注册邮箱差不多简单。接下来在电脑上安装Git,这是用来管理代码版本的工具。Windows用户可以下载Git for Windows,macOS可以用Homebrew安装,命令是:
brew install git
第一步:Fork项目到自己的仓库
打开你想参与的开源项目页面,比如一个叫todo-cli的命令行待办工具。右上角有个“Fork”按钮,点一下,几秒钟后这个项目就会复制一份到你的名下。这相当于你有了一个属于自己的副本,随便改都不会影响原项目。
第二步:把代码下载到本地
在你Fork后的仓库页面,点击“Code”按钮,复制仓库的HTTPS地址。然后打开终端或命令行,执行:
git clone https://github.com/你的用户名/todo-cli.git
这样代码就下载到你电脑了,进入项目文件夹开始干活。
第三步:创建新分支
别直接在主分支上改,这是大忌。比如你要修一个按钮点击无效的问题,可以建个名叫fix-button-click的分支:
git checkout -b fix-button-click
这个分支名字要能说明你干了啥,方便别人一眼看懂。
第四步:修改代码并提交
用你喜欢的编辑器打开文件,改完保存。比如你发现index.js里少了个事件监听,补上之后回到终端,先看看改了哪些文件:
git status
然后把改动加入提交列表:
git add index.js
接着写提交信息:
git commit -m "修复按钮点击无响应问题"
提交信息尽量说清楚做了什么,别写“改了点东西”这种模糊内容。
第五步:推送到GitHub
本地改完得同步到你Fork的远程仓库:
git push origin fix-button-click
等上传完成,打开你的GitHub仓库页面,会发现多了一个提示:“Your recently pushed branches: fix-button-click”,旁边就有个绿色按钮“Compare & pull request”。
第六步:发起Pull Request
点那个绿色按钮,页面会自动跳转到PR创建界面。系统已经帮你选好了目标:把你分支的代码合并进原项目的main分支。填好标题和描述,比如:
- 标题:修复主界面按钮点击无效
- 描述:添加了缺失的click事件绑定,测试后功能正常
确认无误后点“Create pull request”。这时候你就正式提交了PR,剩下的就是等项目维护者 review(审查)了。
可能遇到的情况
有时候维护者会留言让你调整代码,比如格式不对或者漏了测试用例。别慌,你本地继续改,再commit一次然后push,PR会自动更新内容。整个过程就像同事之间来回修改文档,很常见。
一点经验分享
刚开始可以找标有“good first issue”的任务练手,这类问题通常不复杂,社区也更愿意帮助新人。记得别一上来就想重构整个项目,小步快跑更容易被接受。我第一次提交PR花了整整三天,光配环境就折腾了一天半,现在回头看其实也就那么回事。动手才是最难的那一步。