手把手带你走完一次开源项目贡献流程

小张上周在 GitHub 上看到一个自己常用来剪辑视频的开源工具，发现有个按钮点击后没反应。他试着改了两行代码，本地测试通过，就点开 PR（Pull Request）按钮提交了——结果被维护者礼貌地拒了，理由是：没跑测试、没写说明、分支名乱七八糟。

别急，这不是你代码不行，是流程没走对

开源项目不是‘改完就提’，它像进一家老店修电脑：得先打招呼、看规则、领工具、再动手。下面用最实在的操作步骤说清楚整个流程，不绕弯子。

1. 先 fork，别直接 clone 原仓库

打开项目主页（比如 OBS Studio），右上角点 Fork。这会在你账号下生成一份完全独立的副本，所有改动都在这儿做，不影响原项目。

2. 本地环境配齐再开工

把你的 fork 克隆下来：

git clone https://github.com/你的用户名/obs-studio.git
cd obs-studio
git remote add upstream https://github.com/obsproject/obs-studio.git

后面这行很重要，它帮你以后轻松同步上游更新。

3. 别在 main 分支上改代码

新建一个有描述性的分支，比如修复按钮问题就叫 fix-export-button-crash：

git checkout -b fix-export-button-crash

改完代码、加测试、跑一遍本地构建（很多项目 README 里写着 npm run build 或 make）。

4. 提交时写清楚“干了啥”

别只写 git commit -m "fix bug"。试试这样：

git commit -m "fix: prevent crash when clicking export button in timeline view\n\n- Check null pointer before calling getExportPath()\n- Add unit test for empty path scenario"

第一行是类型+简述（fix/enhance/docs），空一行后写具体改动，让别人一眼看懂逻辑和覆盖场景。

5. 推到你的远程分支，再点绿色按钮

git push origin fix-export-button-crash

回到你 fork 的 GitHub 页面，会自动弹出 Compare & pull request 按钮。点进去后，标题写清楚问题+影响范围，正文贴上复现步骤、截图或录屏链接（比如 Loom 链接），再 @ 一下相关模块的维护者（看项目 CONTRIBUTING.md 里的 maintainer 列表）。

常见卡点，提前避开

• 被要求签署 CLA？别跳过。很多大项目（如 Apache、CNCF）要你勾选「我同意贡献协议」，点一下就行；
• CI 测试挂了？先在本地 npm test 或 tox -e py39 跑一遍，别等 CI 报错才查；
• 维护者没回复？等 3～5 个工作日再礼貌追问一句，附上 PR 链接，别发“Hi？”。

真正的开源贡献，不是比谁改得多，而是比谁更尊重协作节奏。你提的每一份 PR，都可能成为别人第一次提交的参考模板。