一、Fork + Clone 项目#

首先在 GitHub 上 Fork 别人的项目 然后 git clone 到本地，并且 cd 进入到项目目录中

二、添加上游仓库#

1
git remote add upstream https://github.com/原作者/项目名.git

验证：

1
git remote -v

三、拉取 upstream 的 dev 分支#

⚠️ 关键点：你要基于 dev 分支开发，而不是 main

1
git fetch upstream
2
git checkout -b dev upstream/dev

👉 这一步的意思是： 从 upstream 拉取 dev 本地创建一个 dev 分支，并跟踪 upstream/dev

四、基于 dev 创建你的功能分支#

不要直接在 dev 上改！直接在 dev 上开发会导致：

• 分支污染
• PR 不清晰

请先建立新的分支：

1
git checkout -b feature/xxx

五、开发 + 提交代码#

1
git add .
2
git commit -m "feat: 新增了用户上线的功能"

六、推送到你的 Fork 仓库#

1
git push origin feature/xxx

七、发起 PR#

在 GitHub 上：

• base repository：原仓库
• base branch：dev ⚠️
• compare：你的 feature/xxx

👉 确保是： 原仓库: dev ← 你的仓库: feature/xxx 不要提到 main 分支

开发前建议：#

请先记得拉取 dev 分支的最新代码再进行开发

1
git checkout dev
2
git pull upstream dev
3
git checkout feature/xxx
4
git rebase dev  // 让提交历史变得“线性、干净”