总体流程鸟瞰h2

标准开源贡献流程：

1
Fork 原项目
2
 ↓
3
Clone 自己的 fork
4
 ↓
5
添加 upstream（原项目）
6
 ↓
7
从 upstream/main 创建 feature 分支
8
 ↓
9
在 feature 分支上开发
10
 ↓
11
同步 upstream/main（rebase 或 merge）
12
 ↓
13
Push 到自己的 fork
14
 ↓
15
向原项目发 Pull Request

Fork 原项目h2

1. 打开目标开源项目（比如 owner/repo）

2. 点击右上角 Fork

3. 得到你的仓库：

   1
   yourname/repo

重要：
你 没有 原项目的写权限，只能：

• push 到 自己的 fork

• 向原项目发 PR

Clone 你的 forkh2

1
git clone https://github.com/yourname/repo.git
2
cd repo

此时：

• origin → 你的 fork

• 还不知道原项目在哪

添加 upstreamh2

1
git remote add upstream https://github.com/owner/repo.git

检查：

1
git remote -v

应该看到：

1
origin    https://github.com/yourname/repo.git (fetch)
2
origin    https://github.com/yourname/repo.git (push)
3
upstream  https://github.com/owner/repo.git (fetch)
4
upstream  https://github.com/owner/repo.git (push)

📌 约定俗成

• origin：你自己的仓库

• upstream：原项目（所有人共同维护）

永远不要在 main 上直接开发h2

确保本地 main 是“干净的”h3

1
git checkout main
2
git fetch upstream
3
git reset --hard upstream/main

含义：

• 本地 main 永远和原项目 main 一致

• 本地 main 只是“基线”，不用来写代码

从最新 main 创建 feature 分支h3

1
git checkout -b feature/my-awesome-feature

分支命名建议：

• feature/xxx

• fix/xxx

• docs/xxx

在 feature 分支上开发h2

1
# 修改代码
2
git status
3
git add .
4
git commit -m "feat: add xxx support"

你可以多次 commit，没问题。

跟进 upstream/main 的最新改动h2

在你开发期间，别人可能已经往 main 合并了新代码，你必须同步。

拉取 upstream 最新代码h3

1
git fetch upstream

推荐方式：rebase（开源项目首选）h3

1
git rebase upstream/main

效果是：

1
upstream/main ── A ── B ── C
2
                      \
3
feature ─────────────── D ── E

➡️ 你的提交「接在最新 main 后面」，历史干净

如果出现冲突：h4

1
# 手动解决冲突
2
git add <冲突文件>
3
git rebase --continue

⚠️ 为什么不用 merge？h3

1
git merge upstream/main

会产生：

1
Merge branch 'main'

很多开源项目 明确要求不要 merge main，而是 rebase。

👉 看项目的 CONTRIBUTING.md
没写的话：默认 rebase

推送 feature 分支到你的 forkh2

1
git push origin feature/my-awesome-feature

⚠️ 如果你 rebase 过并且之前 push 过：

1
git push --force-with-lease origin feature/my-awesome-feature

--force-with-lease 比 --force 安全
不会误覆盖别人提交

在 GitHub 上创建 Pull Requesth2

1. 打开你的 fork 页面

2. GitHub 会提示：

   1
   Compare & Pull Request

3. 确认：

   1
   base: owner/repo  ← main
   2
   head: yourname/repo ← feature/my-awesome-feature

PR 描述建议写清楚：h3

1
### What
2
- 实现了 XXX 功能
3

4
### Why
5
- 解决了 XXX 问题
6

7
### How
8
- 使用了 XXX 方法
9

10
### Test
11
- [ ] 本地测试
12
- [ ] 单元测试

PR 审核期间你还可以继续改h2

审稿人可能会说：

Please fix xxx

你只需要：

1
# 仍然在 feature 分支
2
修改代码
3
git add .
4
git commit -m "fix: address review comments"
5
git push origin feature/my-awesome-feature

PR 会 自动更新

PR 合并后你本地该怎么做h2

1
git checkout main
2
git fetch upstream
3
git reset --hard upstream/main
4
git branch -d feature/my-awesome-feature