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 - 保持分支维护经济,时间大的分支尽早合并/删除