GitHub PR 被拒怎么办：从本地复现到通过 Review 的开源贡献排雷手册
先别慌：PR 被关不等于你“菜” ⭐
“哥，我第一次给 GitHub 开源项目提 PR，结果 CI 红了、Maintainer 没回、还被要求 rebase，是不是寄了？”——不，真没寄。老网民见过太多新人一上来就改 20 个文件，commit 写“update”，然后光速社死。咱们按流程来，GitHub PR流程教程的核心就一句：小改动、能复现、说人话。
Q：贡献前先看什么？看这 4 个文件：README、CONTRIBUTING、LICENSE、CODE_OF_CONDUCT。没有 CONTRIBUTING 时，看最近 5 个已合并 PR，模仿它的分支名、提交粒度、测试命令。
新手坑预警：别直接在 main/master 上改。你以后想同步上游会痛得像 56k 拨号断线。
- Fork 项目到自己账号。
- 克隆到本地：
git clone [email protected]:你的用户名/项目名.git - 添加上游仓库：
git remote add upstream [email protected]:原作者/项目名.git - 新建分支：
git checkout -b fix-doc-typo-issue-23 - 改动后查看范围：
git diff
老鸟提示：GitHub开源项目怎么贡献？优先从文档、测试、Issue 复现开始。我的经验是，文档类 PR 从提交到合并常见 1—3 天；核心代码 PR 如果没测试，等一周没人理也正常，别急着“顶顶”。
从提交到 PR：让 Reviewer 少骂两句 ⭐⭐
Q：commit 怎么写？别写“fix bug”。建议格式：docs: clarify installation on Windows、test: add regression case for parser。一次 PR 只解决一个问题，别把格式化、重构、功能混在一起。
标准流程如下，这就是 GitHub fork分支怎么用的最小闭环：
- 同步上游：
git fetch upstream - 基于最新版开发：
git checkout main && git merge upstream/main - 运行测试，例如 Python 项目：
python -m pytest -q - 提交：
git add . && git commit -m "fix: handle empty title in exporter" - 推送：
git push origin fix-empty-title - 在 GitHub 页面创建 Pull Request，描述里写：问题、改法、测试结果。
PR 描述模板可以直接抄：
Fixes #23。问题：空标题导出时报错。改动：增加空值判断。测试：本地运行 python -m pytest -q，128 passed in 14.2s。
实测参考：我用一个 1.8MB 的 Python 小项目测试，完整跑完 128 个单元测试约 14 秒；如果你本地跑 2 分钟还没结果，先查依赖版本，不要硬等到天荒地老。
CI 红了、被要求 rebase、没人理：故障树 ⭐⭐⭐
Q：CI 红了怎么办？先点进失败日志，找第一个红色错误，不要从最后一行开始瞎猜。常见原因：格式化失败、依赖版本不一致、测试只在 Linux 挂。本地复现命令优先看项目里的 Makefile、package.json、pyproject.toml。
- 格式化失败：运行
pre-commit run --all-files或项目指定 formatter。 - 分支落后：执行
git fetch upstream，再git rebase upstream/main。 - 冲突：打开冲突文件，保留正确代码后
git add 文件名，再git rebase --continue。 - Reviewer 要修改：不要新开 PR，直接在原分支继续 commit 并 push。
- 超过 7 天没人回：礼貌留言一次，附上测试结果和可复现步骤。
故障树：PR 不能合并 → 先看 CI 是否绿；不绿 → 本地跑同一命令；本地也失败 → 修代码/依赖；本地通过但 CI 失败 → 查系统差异；CI 绿但无人 Review → 补充描述并礼貌提醒；要求 rebase → 同步 upstream；出现冲突 → 手动解决后继续 rebase。
如何验证它真的好了：PR 页面所有 checks 变绿；Files changed 只包含必要文件；本地执行测试命令通过；PR 描述写清“我怎么测的”。能做到这四点，基本就从“小白乱冲”升级到“靠谱贡献者”了。
如果你所在网络访问 GitHub 偶尔抽风，优先试官方网络、学校/单位代理、镜像缓存等免费方案；确实需要移动端辅助时，Roxi 也是一个可选工具，可在 https://wizzegroup.com 了解，但别把网络问题当成代码问题。还有哪里卡住，直接留言问，老哥慢慢带你排。