Git 工作流

一套可复用的 Git 操作规范与常用命令，用于保证提交历史清晰、可追溯、可回滚。

何时使用

• 开始一个新功能 / 修复 / 重构任务时建立分支。
• 需要写规范、有条理的一连串提交。
• 提交历史凌乱需要整理（rebase -i / squash）。
• 需要将分支合并回主干，或回滚错误的提交。
• 处理 merge/rebase 冲突。

核心流程

1. 开始前：确认基线

git status                     # 确认工作区干净
git fetch origin --prune       # 同步远端并清理已删除分支的引用
git log --oneline -5           # 确认起点

2. 创建特性分支

# 分支命名：type/描述，例如 feat/, fix/, refactor/, docs/, chore/
git switch -c feat/login-page origin/main

3. 编写规范提交（Conventional Commits）

<type>(<scope>): <subject>

<body: 为什么做、怎么解决、影响范围>

<footer: 关闭的 issue、破坏性变更说明>

常用类型：feat fix refactor docs test chore perf style revert。

git add -A
git commit -m "feat(login): 支持手机号+验证码登录"

一条提交只做一件事：单一职责。避免把无关改动混进一个 commit。

4. 不要直接 rebase 已推送到远端的共享分支

只对尚未推送/只有你自己在用的本地提交做历史整理。

5. 提交历史整理（仅限本地/未推送提交）

# 交互式整理最近 3 条提交：s=合并、r=改写消息、e=编辑
git rebase -i HEAD~3

# 将最近 N 条且未推送的提交压成一条（示例 3 条）
git reset --soft HEAD~3
git commit -m "feat(x): 合并后的完整说明"

6. 合并回主干

git switch main && git pull --rebase origin main
git switch feat/login-page
# 优先用 rebase 使历史线性，再 fast-forward
git rebase main
git switch main
git merge --ff-only feat/login-page
git push

7. 冲突处理

不要 commit 手动冲突标记。逐个文件解决后：

git add <resolved-file>
git rebase --continue   # 或 git merge --continue
git rebase --abort      # 搞乱时安全退出

8. 回滚

# 撤销最近一次提交（保留工作区改动）
git reset --soft HEAD~1
# 撤销已推送的错误提交（产生一个新的“撤销”提交，安全用于共享分支）
git revert <commit>

质量检查清单

• 分支名清晰，且只做一件事。
• 提交信息遵循 Conventional Commits。
• 每个 commit 通过构建/测试。
• 未把无关改动混入同一 commit。
• 未改写已推送的共享历史。
• 合并采用 --ff-only 或显式说明为何需要 merge commit。