Git 多分支开发同步流程文档
✅ 1. 分支规范(推荐)
| 分支类型 | 命名规则 | 用途说明 |
|----------|----------|----------|
| 主分支 | master
/ main
| 可部署的稳定版本 |
| 开发分支 | dev
/ 8001_dev
/ feature_xxx
| 每个功能或模块单独分支开发 |
| 修复分支 | hotfix_xxx
| 临时紧急修复,通常从 master
开出 |
✅ 2. 开发分支创建流程
git checkout master
git pull origin master # 确保主干是最新的
git checkout -b 8001_dev # 创建开发分支
git push -u origin 8001_dev # 推送远程并建立跟踪
🔄 3. 日常开发:提交 & 推送
# 编写代码后:
git add .
git commit -m "feat: 完善用户登录逻辑"
git push origin 8001_dev
🔁 4. 同步主分支更新(推荐定期进行)
# 方式一:合并方式
# 有 merge commit,适合多人合并
git checkout 8001_dev
git pull origin master
# 方式二:变基方式
# 历史更细准,适合个人分支
git checkout 8001_dev
git pull --rebase origin master
✅ 建议使用
--rebase
保持提交历史线性,特别是功能开发阶段
🚀 5. 开发完成后合并到主干
git checkout master
git pull origin master # 保证是最新
git merge 8001_dev
git push origin master
🧼 6. 合并后清理(可选)
git branch -d 8001_dev # 删除本地分支
git push origin --delete 8001_dev # 删除远程分支(如已完成)
📈 7. 实际例子(分支命名示例)
| 功能 | 分支名示例 |
|--------|----------------|
| 用户登录 | feature/login
|
| 账号管理 | feature/account
|
| 临时修复 | hotfix/login-crash
|
| 经理查看页 | feature/manager-ui
|
📚 8. 实用命令速查
| 命令 | 说明 |
|------|------|
| git branch
| 查看本地分支 |
| git branch -r
| 查看远程分支 |
| git checkout -b xxx origin/xxx
| 从远程新建本地分支 |
| git pull origin master
| 合并远程 master
到当前分支 |
| git pull --rebase origin master
| 变基到 master
最新状态 |
| git log --oneline --graph --all
| 直观查看分支历史 |
| git status
| 查看当前状态 |
🛡️ 9. Tips & 风险防控
- 【必须】始终 先
pull
,再push
- 多人协作时尽量避免直接重型
rebase
(变基) - 使用
stash
临时保存本地修改:git stash git pull --rebase origin master git stash pop
- 保持分支维护经济,时间大的分支尽早合并/删除