开源这事,我前前后后折腾了三四年,从一个连PR是什么都搞不清楚的小白,到后来给自己常用的几个项目提了几十个PR、被维护者直接邀请成为collaborator,中间踩过的坑和悟出来的道理,远比在GitHub上点那颗Star要多得多。如果你也正站在“想参与开源但不知道从哪儿下手”的门口,这篇东西希望能让你少走一点弯路。我会把整个过程拆成几个阶段来讲:怎么看懂一个项目、怎么提交第一个能合进去的PR、怎么从一次性贡献变成长期贡献,以及真要走到核心贡献者这一步,还需要在代码之外做哪些事情。
1. 参与开源之前,先想明白这三件事
1.1 为什么要贡献开源:目的决定路径
很多人一上来就问“怎么给开源项目提PR”,但我觉得更应该先问“我为什么要贡献开源”。目的不同,路径完全不同。
如果是为了学习,那就挑一个你天天在用的库,读它的源码比看什么教程都管用。比如你天天用某个HTTP库、某个ORM框架,这些项目的源码就是最好的教科书。如果是为了解决自己开发中遇到的真实问题,那就带着问题去提issue、提PR,这种贡献天然就是有价值的。如果是为了建立个人品牌、为简历加分,那你需要的是高质量、连续性的贡献记录,而不是偶尔一个PR。
想清楚目的之后,还有一个很现实的问题需要面对:时间从哪来。开源贡献不是一个周末就能完成的事情,它是持续性的投入。我见过很多人一开始热情高涨,第一个PR合进去之后觉得“我行了”,结果第二个PR踢到铁板被反复要求修改,然后就消失了。这种“一次性贡献者”其实很普遍,但如果你想走得更远,就要做好打持久战的准备。
1.2 破解一个根深蒂固的误解:贡献不等于写代码
还有一个很多人都有的误解——觉得参与开源就必须写代码,要写代码就必须是那种能上头条的大功能。真不是这样。
我见过一个项目的文档里有一个很小的拼写错误,一个新手花了五分钟改掉提了个PR,维护者很快就合了,还在这个PR下面感谢了他。还有一个项目缺一个单元测试的边界用例,也是被一个从没参与过开源的人补上的。这些贡献在技术上都不难,但维护者非常欢迎,因为文档维护和测试覆盖本来就是开发中“人人都需要但又没人愿意做”的脏活累活。
更不用说还有翻译文档、整理issue、写使用教程、回答新手问题这些非代码贡献。很多项目的核心圈子,反而是从这些“杂活”干起才开始被注意到的。所以如果你还在担心自己水平不够、不敢动代码,先去看文档、翻译、测试,这些路一样能通向核心圈子。
1.3 开源协作的基本节奏:一次PR的完整生命周期
在动手之前,我建议你先完整地理解一次PR从提出到合入要经历什么。简单说,就是这样一个流程:发现问题或需求 → 去项目里搜有没有人提过 → 如果没有就开一个issue描述清楚 → 在issue里跟维护者讨论方案 → 确认后再fork仓库、写代码 → 提交PR → 维护者或社区成员review → 按照反馈修改 → 通过CI检查 → 被合并。
这个流程里的每一步都有讲究。比如“先讨论再写代码”,很多新手忽略这一步,直接吭哧吭哧写了三天代码,提交上去发现自己做的事情跟项目方向不符,直接被关闭。再比如“CI检查”,如果你本地没跑测试就提交PR,很可能在CI阶段就被拦截下来,这会给维护者留下“这个人技术不错但不太细心”的印象。
