woshale.com
← 返回博客

第一次给开源项目提 PR

用的开源工具里一直有个小刺:命令行输出的中文翻译缺了一角,界面语言切过来后有两个按钮还是英文。忍了半年,某天终于点进仓库的 issue 区,发现居然还没有人报——于是有了我的第一个 pull request。

比写代码更难的,是找到"该改哪"

真正的第一课发生在动手之前:我花了两个小时才读懂这个项目的目录结构,最后发现翻译文件藏在 locales/zh-CN.json,而缺的那两个键叫 btn.importbtn.export开源贡献的门槛从来不在代码量,在代码导航能力——这件事学校不教,教程里也总是一笔带过。

被返工三次的教训

第四次终于合并。从提交到 merged 一共四天,维护者的全程回复不超过十条,但每一条都精确指在痛点上。

开源世界的礼仪不是繁文缛节,是把维护者的注意力当成最稀缺的资源去尊重。

值回票价的三样收获

第一,恐惧消失了:原来知名的仓库背后也是普通人在 review。第二,学会了读别人的 CI 配置——返工三次逼出来的技能,后来在自己项目里天天用。第三,也是最意外的:合并那天起,那个工具的每个新版本里都有我的一行字。每次更新看到它,都像在别人的房子里拥有了一块砖。

← 更多文章 聊聊这篇 →