Git 高级技巧与最佳实践完全指南：从日常操作到进阶技巧 | 2026开发者必备

1
# 交互式暂存，逐块确认
2
git add -p
3

4
# Git 会逐块展示修改，让你选择：
5
# y - 暂存此块
6
# n - 不暂存此块
7
# q - 退出
8
# a - 暂存此块及后续所有块
9
# d - 不暂存此块及后续所有块
10
# e - 手动编辑此块
11
# s - 分割成更小的块

1
$ git add -p src/app.py
2
(1/3) def new_feature():
3
      +    # 新功能代码
4
      +    pass
5
Stage this hunk [y,n,q,a,d,e,s]? n  # 不暂存新功能
6

7
(2/3) def bug_fix():
8
      -    # 旧代码
9
      +    # 修复后的代码
10
Stage this hunk [y,n,q,a,d,e,s]? y  # 暂存 Bug 修复
11

12
(3/3) # 其他修改
13
Stage this hunk [y,n,q,a,d,e,s]? n

1
git add -i
2

3
# 显示菜单：
4
#           staged     unstaged path
5
#   1:       +0/-0        +5/-3 src/app.py
6
#   2:       +0/-0        +2/-1 src/utils.py
7
#
8
# Commands
9
#   1: status   2: update   3: revert   4: add untracked
10
#   5: patch    6: diff     7: quit
11

12
# 选择 5 进入 patch 模式，逐文件逐块选择

1
# 查看暂存区与 HEAD 的差异（即将提交的内容）
2
git diff --cached
3
git diff --staged  # 同上
4

5
# 查看工作区与暂存区的差异（未暂存的内容）
6
git diff
7

8
# 查看工作区与 HEAD 的差异（所有修改）
9
git diff HEAD

1
# 撤销单个文件的修改
2
git restore src/app.py
3

4
# 撤销所有未暂存的修改
5
git restore .
6

7
# 旧语法（Git 2.23 之前）
8
git checkout -- src/app.py

1
# 取消暂存，保留工作区修改
2
git restore --staged src/app.py
3

4
# 旧语法
5
git reset HEAD src/app.py

1
# 修改提交信息
2
git commit --amend -m "新的提交信息"
3

4
# 添加遗漏的文件到最近提交
5
git add forgotten_file.py
6
git commit --amend --no-edit  # 保持原提交信息
7

8
# 注意：只修改未推送的提交！

1
# 回退最近 1 次提交，保留修改在工作区
2
git reset HEAD~1
3

4
# 回退最近 1 次提交，保留修改在暂存区
5
git reset --soft HEAD~1
6

7
# 回退最近 3 次提交
8
git reset --soft HEAD~3

1
# 回退并丢弃所有修改（危险操作）
2
git reset --hard HEAD~1
3

4
# 回退到指定提交
5
git reset --hard abc123

1
# 创建一个撤销提交，不影响历史
2
git revert abc123
3

4
# 撤销多个提交
5
git revert abc123 def456
6

7
# 撤销但不自动提交（可修改后再提交）
8
git revert -n abc123

1
# 从其他分支挑选单个提交
2
git cherry-pick abc123
3

4
# 挑选多个提交
5
git cherry-pick abc123 def456
6

7
# 挑选提交范围
8
git cherry-pick abc123..def456
9

10
# 只应用修改，不自动提交
11
git cherry-pick -n abc123

1
# 场景 1: 紧急修复需要从 feature 分支提前发布
2
git checkout main
3
git cherry-pick fix-urgent-bug-commit
4

5
# 场景 2: 从已关闭的分支挽救有用提交
6
git cherry-pick useful-commit-from-deleted-branch
7

8
# 场景 3: 选择性合并部分功能
9
git cherry-pick feature-a-commit feature-b-commit

1
# cherry-pick 遇到冲突时
2
git cherry-pick abc123
3
# CONFLICT (content): Merge conflict in src/app.py
4

5
# 解决冲突后继续
6
git add src/app.py
7
git cherry-pick --continue
8

9
# 或放弃 cherry-pick
10
git cherry-pick --abort

1
# 将 feature 分支变基到 main 最新
2
git checkout feature
3
git rebase main
4

5
# 过程：
6
# 1. 找到 feature 和 main 的共同祖先
7
# 2. 将 feature 的提交临时保存
8
# 3. 将 feature 更新到 main 最新
9
# 4. 逐个应用 feature 的提交

1
# 整理最近 5 次提交
2
git rebase -i HEAD~5
3

4
# 打开编辑器显示：
5
# pick abc123 第一次提交
6
# pick def456 第二次提交
7
# pick ghi789 第三次提交
8
# pick jkl012 第四次提交
9
# pick mno345 第五次提交
10
#
11
# Commands:
12
# p, pick = 保留提交
13
# r, reword = 保留提交，修改提交信息
14
# e, edit = 保留提交，暂停以修改内容
15
# s, squash = 合并到前一个提交，保留信息
16
# f, fixup = 合并到前一个提交，丢弃信息
17
# d, drop = 删除提交

1
# 合并多个小提交为一个
2
pick abc123 实现基础功能
3
squash def456 修复小问题
4
squash ghi789 添加测试
5

6
# 修改提交信息
7
reword abc123 更清晰的提交描述
8

9
# 删除无用提交
10
drop jkl012 临时调试代码

1
git rebase main
2
# CONFLICT (content): Merge conflict in src/app.py
3

4
# 解决冲突
5
git add src/app.py
6
git rebase --continue
7

8
# 或跳过此提交
9
git rebase --skip
10

11
# 或放弃 rebase
12
git rebase --abort

1
# 暂存当前工作区修改
2
git stash
3

4
# 暂存并添加描述
5
git stash push -m "WIP: 新功能开发中"
6

7
# 暂存包括未跟踪的新文件
8
git stash -u
9

10
# 暂存包括被忽略的文件
11
git stash -a

1
# 查看 stash 列表
2
git stash list
3
# stash@{0}: WIP on feature: abc123 新功能开发中
4
# stash@{1}: WIP on main: def456 Bug修复
5

6
# 查看 stash 内容
7
git stash show stash@{0}
8
git stash show -p stash@{0}  # 详细差异
9

10
# 恢复最近的 stash
11
git stash pop
12

13
# 恢复指定 stash（保留 stash 记录）
14
git stash apply stash@{1}
15

16
# 删除 stash
17
git stash drop stash@{0}
18

19
# 清空所有 stash
20
git stash clear

1
# 场景 1: 紧急切换任务
2
# 正在开发新功能，突然需要修复紧急 Bug
3
git stash push -m "新功能开发中"
4
git checkout main
5
git checkout -b hotfix
6
# 修复 Bug...
7
git checkout feature
8
git stash pop
9

10
# 场景 2: 从 stash 创建分支
11
git stash branch new-feature stash@{0}
12

13
# 场景 3: 选择性恢复
14
git stash show -p stash@{0} | git apply --reject

1
# 查看 reflog
2
git reflog
3
# abc123 (HEAD -> main) HEAD@{0}: commit: 添加新功能
4
# def456 HEAD@{1}: commit: 修复 Bug
5
# ghi789 HEAD@{2}: reset: moving to HEAD~1
6
# jkl012 HEAD@{3}: commit: 被删除的提交
7
# mno345 HEAD@{4}: checkout: moving from feature to main
8

9
# 查看指定分支的 reflog
10
git reflog show feature

1
# 场景：误执行了 git reset --hard HEAD~2
2

3
# 1. 查看 reflog 找到丢失的提交
4
git reflog
5
# ghi789 HEAD@{2}: reset: moving to HEAD~2  <-- 操作前
6
# jkl012 HEAD@{3}: commit: 被删除的提交     <-- 要恢复的提交
7

8
# 2. 恢复到该提交
9
git reset --hard jkl012
10

11
# 或创建新分支保留
12
git branch recovery-branch jkl012

1
# 场景：误删了 feature 分支
2
git branch -D feature
3

4
# 恢复步骤
5
git reflog
6
# abc123 HEAD@{5}: checkout: moving from feature to main
7
# ghi789 HEAD@{6}: commit: feature 分支的最新提交
8

9
# 创建新分支指向该提交
10
git branch feature ghi789

1
# 开始二分查找
2
git bisect start
3

4
# 标记当前版本有 Bug
5
git bisect bad
6

7
# 标记已知无 Bug 的版本
8
git bisect good v1.0.0
9

10
# Git 自动跳转到中间提交
11
# Bisecting: 50 revisions left to test after this
12

13
# 测试该版本，标记结果
14
git bisect bad   # 此版本有 Bug
15
git bisect good  # 此版本无 Bug
16

17
# Git 继续缩小范围，直到找到首次引入 Bug 的提交
18
# abc123 is the first bad commit

1
# 使用脚本自动测试
2
git bisect start
3
git bisect bad HEAD
4
git bisect good v1.0.0
5
git bisect run ./test_script.sh
6

7
# test_script.sh 返回：
8
# 0 - 测试通过（good）
9
# 1-127 - 测试失败（bad）
10
# 125 - 无法测试（跳过）

1
# 找到 Bug 后结束
2
git bisect reset
3

4
# 查看二分过程日志
5
git bisect log

1
# 开始新功能
2
git checkout develop
3
git checkout -b feature/new-feature
4

5
# 功能开发完成
6
git checkout develop
7
git merge --no-ff feature/new-feature
8

9
# 开始发布
10
git checkout -b release/v1.0 develop
11
# 发布准备（版本号、文档等）
12

13
# 发布完成
14
git checkout master
15
git merge --no-ff release/v1.0
16
git tag -a v1.0
17
git checkout develop
18
git merge --no-ff release/v1.0
19

20
# 紧急修复
21
git checkout -b hotfix/v1.0.1 master
22
# 修复 Bug
23
git checkout master
24
git merge --no-ff hotfix/v1.0.1
25
git tag -a v1.0.1
26
git checkout develop
27
git merge --no-ff hotfix/v1.0.1

1
# 1. 从 master 创建分支
2
git checkout -b feature/new-feature
3

4
# 2. 开发并提交
5
git add .
6
git commit -m "实现新功能"
7

8
# 3. 推送并创建 Pull Request
9
git push -u origin feature/new-feature
10

11
# 4. PR 审核通过后合并到 master
12

13
# 5. 合并后立即部署

1
# 提交格式
2
<type>(<scope>): <subject>
3

4
<body>
5

6
<footer>

1
git commit -m "feat(api): 添加用户认证接口
2

3
- 实现 JWT 令牌生成
4
- 添加登录/注销 API
5
- 支持刷新令牌
6

7
Closes #123"

1
# ✅ 好的提交信息
2
git commit -m "fix(parser): 处理空输入导致的崩溃
3

4
当输入为空字符串时，parse() 函数会抛出 IndexError。
5
添加空值检查，返回默认配置。
6

7
Fixes #45"
8

9
# ❌ 差的提交信息
10
git commit -m "修复 bug"
11
git commit -m "update"
12
git commit -m "changes"

1
# 安装 Husky
2
npm install husky --save-dev
3
npx husky install
4

5
# 添加 pre-commit hook
6
npx husky add .husky/pre-commit "npm run lint"
7

8
# 添加 commit-msg hook
9
npx husky add .husky/commit-msg 'npx --no -- commitlint --edit "$1"'

1
# 从历史中彻底删除文件
2
git filter-branch --force --index-filter \
3
  "git rm --cached --ignore-unmatch config/secrets.yml" \
4
  --prune-empty --tag-name-filter cat -- --all
5

6
# 或使用 BFG Repo-Cleaner（更快）
7
bfg --delete-files secrets.yml
8
git reflog expire --expire=now --all
9
git gc --prune=now --aggressive
10

11
# 强制推送（会改变历史）
12
git push origin --force --all

1
# 查看冲突文件
2
git status
3

4
# 使用可视化工具
5
git mergetool
6

7
# 接受一方修改
8
git checkout --ours <file>    # 接受当前分支
9
git checkout --theirs <file>  # 接受合并分支
10

11
# 手动解决后标记
12
git add <file>
13
git commit

1
# 查看大文件
2
git rev-list --objects --all | \
3
  git cat-file --batch-check='%(objecttype) %(objectname) %(objectsize) %(rest)' | \
4
  sed -n 's/^blob //p' | \
5
  sort --numeric-sort --key=2 --reverse | \
6
  head -20
7

8
# 清理历史中的大文件
9
git filter-branch --force --index-filter \
10
  "git rm --cached --ignore-unmatch path/to/large/file" \
11
  --prune-empty --tag-name-filter cat -- --all
12

13
# 清理仓库
14
git reflog expire --expire=now --all
15
git gc --prune=now --aggressive

1
# 重命名本地分支
2
git branch -m old-name new-name
3

4
# 重命名远程分支
5
git push origin --delete old-name
6
git push origin -u new-name

1
# 找到 merge 提交
2
git log --oneline --graph
3

4
# revert merge 提交（需要指定主分支）
5
git revert -m 1 <merge-commit>
6

7
# -m 1 表示保留第一个父提交（被合并的分支）