Git 合并清理工作流

将当前分支合并到主分支，推送，然后删除当前分支。

步骤

0. 处理脏工作区（先分类，再动手）

git status --short

工作区有变更时，按类别处理，禁止直接跳过：

| 类别 | 识别 | 处理 | |---|---|---| | 运行产物 | Logs/、*.log、Saved/、临时输出 | 加入 .gitignore，不提交；已被 git 跟踪的用 git rm -r --cached 解除跟踪 | | 项目工作 | 文档、配置、源码（用户未提交的工作） | git add 对应文件并提交，信息与分支语义一致（如 docs: ...、chore(config): ...） | | 陌生文件 | 无法判断是否该入库（如根目录突然出现 package.json） | 列出并问用户，不擅自提交或忽略 |

处理完必须 git status --short 确认干净（或仅剩用户明确搁置的项），再继续。

分支归属判断：若当前分支已是主分支（master/main），则目标是另一个待清理分支（如仅剩的 feature 分支）——跳过"切回主分支"，直接对其执行第 3 步起的流程。

1. 检查状态

git branch --show-current    # 确认当前分支名
git status --short           # 确认工作区干净

工作区必须干净（无输出），否则回到第 0 步。

2. 确定主分支

git branch -a

主分支通常是 master 或 main，取存在的那个。

3. 检查是否已合并

git merge-base --is-ancestor <分支> <主分支> && echo MERGED

已合并（MERGED）→ 跳过合并，直接到第 5 步删分支。 未合并 → git checkout <主分支> && git merge <分支>。

4. 推送

git remote -v
git rev-list --count origin/<主分支>..<主分支>   # 0 = 已同步，跳过推送

有远端且有未推送提交 → git push origin <主分支>；无远端或已同步 → 跳过。

5. 删除分支

git branch -d <分支>
git push origin --delete <分支>   # 远端存在同名分支时

注意事项

• 合并前不执行 rebase，保持提交历史原样
• Fast-forward 或 merge commit 都可能出现，以 git 实际行为为准
• 纯本地仓库跳过推送步骤
• 若仓库只有主分支、无其他分支可清理：如实报告"无事可做"，但仍执行第 0 步处理脏工作区