Git 高级技巧与救援指南

Git 是现代软件开发的基石。但即使是经验丰富的开发者，也会陷入各种 Git 困境：误删分支、提交错了代码、合并冲突等。这篇文章教你如何优雅地使用 Git，以及在危急时刻如何逢凶化吉。

1. 分支管理最佳实践

Git Flow 工作流

master（主分支）
  ↑ (release 后合并)
  |
release/* (发布分支)
  ↑ (修复完成后合并)
  |
develop（开发分支）
  ↑ (功能完成后合并)
  |
feature/* (功能分支)
  |
hotfix/* (紧急修复)

创建和管理功能分支

# 从 develop 创建功能分支
git checkout develop
git pull origin develop
git checkout -b feature/user-authentication

# 完成功能后，推送到远程
git push origin feature/user-authentication

# 在 GitHub/GitLab 上创建 Pull Request
# 等待审核后合并到 develop

# 删除本地分支
git branch -d feature/user-authentication

# 删除远程分支
git push origin --delete feature/user-authentication

2. 提交历史管理

交互式 Rebase（改写历史）

提交了错误的提交？想要合并多个提交？交互式 rebase 来帮你。

# 查看最后 5 个提交
git log --oneline -5

# 进入交互式 rebase 编辑最后 5 个提交
git rebase -i HEAD~5

会打开编辑器，显示：

pick abc1234 Add user model
pick def5678 Add user validation
pick ghi9012 Fix validation bug
pick jkl3456 Update tests
pick mno7890 Oops, forgot database migration

常用命令：

pick - 使用这个提交
reword - 修改提交信息
squash 或 s - 合并到前一个提交
fixup 或 f - 合并且丢弃提交信息
drop - 删除这个提交

例如，如果 mno7890 是遗漏的，可以改为：

pick abc1234 Add user model
squash def5678 Add user validation  # 合并验证代码
pick ghi9012 Fix validation bug
squash jkl3456 Update tests         # 合并测试
drop mno7890 Oops, forgot database migration

保存后，Git 会重放这些提交。

修改最后一个提交

# 修改最后一个提交的信息
git commit --amend -m "New commit message"

# 修改最后一个提交的代码
git add <files>
git commit --amend --no-edit

注意：只在本地使用！已推送到远程的提交不要修改（会导致队友困扰）。

3. Git 救援指南

场景 1：误删本地分支

# 查看最近删除的分支
git reflog

# 输出示例
abc1234 HEAD@{0}: checkout: moving from feature/old-feature to develop
def5678 HEAD@{1}: commit: Complete feature implementation
...

# 恢复误删分支
git checkout -b feature/old-feature abc1234

场景 2：提交错误的代码到 master

# 方案 1：回滚最后一个提交（推荐）
git revert HEAD

# 这会创建一个新提交，反向改变之前的提交
# 优点：不改变历史，其他人可以直接 pull

# 方案 2：强制重置（仅在未推送时使用）
git reset --hard HEAD~1

场景 3：修改错误的提交内容

# 问题：提交了 console.log() 代码到 production 分支
git log --oneline -5

# 输出：
# abc1234 Remove debug logs
# def5678 Add payment feature <-- 这个提交有 console.log()
# ghi9012 Fix validation
# ...

# 方案：使用 rebase 来修改那个提交
git rebase -i ghi9012~1  # 从该提交之前开始

# 在编辑器中，改为：
# reword def5678 Add payment feature

# 修改后：
# edit def5678 Add payment feature  （改为 edit）

# 删除 console.log() 代码
git add payment.js
git commit --amend --no-edit
git rebase --continue

场景 4：合并冲突

当两个分支修改了同一行代码时：

git merge feature/another-feature

# 冲突输出：
# Auto-merging app.js
# CONFLICT (content): Merge conflict in app.js
# Automatic merge failed; fix conflicts and then commit the result.

# 查看冲突
git diff

# app.js 中会显示：
# <<<<<<< HEAD
# console.log('Version A');
# =======
# console.log('Version B');
# >>>>>>> feature/another-feature

解决冲突，然后：

git add app.js
git commit -m "Resolve merge conflict"
git push origin master

场景 5：恢复已删除的文件

# 查看该文件的删除记录
git log --full-history -- path/to/file.js

# 找到删除前的提交 hash，如 abc1234
git checkout abc1234^ -- path/to/file.js

# 文件恢复到工作目录，需要重新提交
git add path/to/file.js
git commit -m "Restore deleted file"

场景 6：查找引入 Bug 的提交

使用 git bisect 进行二分搜索：

# 标记已知坏的提交和好的提交
git bisect start
git bisect bad HEAD        # 当前提交有 bug
git bisect good v1.0       # v1.0 没有 bug

# Git 会自动 checkout 到中间的提交
# 测试这个版本是否有 bug
npm test

# 如果有 bug
git bisect bad

# 如果没有 bug
git bisect good

# 重复直到找到第一个坏提交
# 最后
git bisect reset

4. 高效工作流命令

Stash：临时保存工作

# 当前在修改 feature 分支，突然需要改 bug
# 保存当前修改到 stash
git stash

# 切换到 master 修复 bug
git checkout master
git checkout -b hotfix/critical-bug
# ... 修复并提交

# 回到 feature 分支
git checkout feature/
git stash pop  # 恢复之前保存的修改

Cherry Pick：选择性合并提交

# 需要将 master 上的某个提交应用到当前分支
git cherry-pick abc1234

# 应用多个连续提交
git cherry-pick abc1234..def5678

# 如有冲突，解决后继续
git cherry-pick --continue

重新整理提交

# 查看各分支的最后一个提交
git log --graph --oneline --all

# 基于 develop 重新整理当前分支
git rebase develop

# 强制推送（仅在个人分支上）
git push origin feature/name --force-with-lease

5. Git Hook 与自动化

Pre-commit Hook（提交前检查）

在 .git/hooks/pre-commit 中：

#!/bin/bash

# 检查是否有 console.log
if git diff --cached | grep -E "console\.(log|error|warn)"; then
  echo "❌ 禁止提交：检测到 console 日志"
  exit 1
fi

# 运行 linter
npm run lint
if [ $? -ne 0 ]; then
  echo "❌ Lint 检查失败"
  exit 1
fi

echo "✓ 检查通过"
exit 0

Commit Message 规范

采用 Conventional Commits 标准：

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

<body>

<footer>

示例：

feat(auth): implement JWT authentication

- Add token generation in login endpoint
- Add token validation middleware
- Add refresh token mechanism

Closes #123

类型：

feat - 新功能
fix - 问题修复
docs - 文档
style - 代码风格（不改变功能）
refactor - 重构
test - 测试
chore - 构建工具更新

6. GitHub / GitLab 协作技巧

Pull Request（PR）最佳实践

# 1. 创建功能分支
git checkout -b feature/add-payment-gateway

# 2. 定期拉取主分支的更新
git fetch origin develop
git rebase origin/develop

# 3. 推送到远程
git push origin feature/add-payment-gateway

# 4. 在 GitHub 创建 PR（Pull Request）
# - 填写清晰的描述
# - 关联相关 issue
# - 请求合适的审核者

# 5. 地址审核意见
git add <modified files>
git commit -m "Address review comments"
git push origin feature/add-payment-gateway

# 6. 合并后删除分支
git checkout develop
git pull origin develop
git branch -d feature/add-payment-gateway
git push origin --delete feature/add-payment-gateway

常用命令速记

# 查看未提交的变化
git status
git diff

# 暂存恢复
git add .
git reset <file>

# 提交和推送
git commit -m "message"
git push origin branch-name
git pull origin branch-name

# 分支操作
git branch -a                    # 列出所有分支
git checkout -b new-branch       # 创建并切换分支
git merge branch-name            # 合并分支

# 查看历史
git log --graph --oneline --all  # 可视化历史
git reflog                        # 查看所有操作记录

# 寻找问题
git blame file.js                # 查看每行代码的作者
git log -p file.js               # 查看文件的修改历史

我们的 Git 救援工具

如果您陷入复杂的 Git 困境，我们的 Git 救援工具提供常见问题的快速解决方案。

相关工具推荐：