my-git

Fork and Pull Request Workflow

Fork + PR 适合开源项目和外部贡献者场景。

它的核心是:贡献者在自己的 fork 中开发,再通过 PR 请求维护者合入,不需要直接拥有主仓库写权限。

流程

fork upstream -> create branch -> commit -> open PR -> maintainer review -> merge

适合场景

贡献者流程

git clone git@github.com:your-name/project.git
cd project
git remote add upstream git@github.com:owner/project.git
git switch -c docs/update-guide

同步上游:

git fetch upstream
git rebase upstream/main

推送到自己的 fork:

git push -u origin docs/update-guide

然后从 GitHub 页面发起 PR。

维护者清单

常见问题

1. fork 落后上游太多

贡献者要定期同步 upstream/main

2. PR 范围太大

维护者可以要求贡献者拆分 PR。

3. CI 权限和 secret 风险

来自 fork 的 PR 需要注意 CI 权限和 secret 暴露风险,尤其是自动化脚本会执行外部贡献者代码时。

企业内部怎么用

企业内部如果所有成员都在同一个组织里,通常不必默认使用 Forking Workflow。

但在这些场景里,fork 仍然有价值:

对纯内部业务服务,feature branch + protected main 往往更简单。

延伸阅读