Git 深度解析：架构、工作流与最佳实践

1
2
3
4
5
6
7
8

# 查看对象类型
git cat-file -t 3b18e512

# 查看对象内容
git cat-file -p 3b18e512

# 查看当前 HEAD 的 commit tree
git ls-tree HEAD

1
2
3
4
5
6
7

# 验证分支的本质
cat .git/refs/heads/main
# 输出: a1b2c3d4e5f6...（一个 commit hash）

# HEAD 是指向当前分支的指针（或直接指向 commit，即 detached HEAD）
cat .git/HEAD
# 输出: ref: refs/heads/main

1
2
3
4
5
6

# Git Flow 典型操作
git checkout -b feature/user-auth develop
# ... 开发 ...
git checkout develop
git merge --no-ff feature/user-auth
git branch -d feature/user-auth

1
2
3

git checkout -b feat/add-oauth-login
git push -u origin feat/add-oauth-login
# 开发完成后在 GitHub/GitLab 上创建 PR

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

# 全局配置（写入 ~/.gitconfig）
git config --global user.name "Your Name"
git config --global user.email "you@example.com"
git config --global core.editor "vim"
git config --global init.defaultBranch main
git config --global pull.rebase true          # 推荐：pull 时使用 rebase

# 查看所有配置
git config --list --show-origin

# 初始化 / 克隆
git init
git clone git@github.com:user/repo.git
git clone --depth=1 git@github.com:user/repo.git  # 浅克隆，仅最新快照

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18

# 1. 查看状态
git status
git status -s                    # 简洁模式

# 2. 暂存变更
git add <file>                   # 暂存指定文件
git add .                        # 暂存所有变更
git add -p                       # 交互式暂存（按 hunk 选择）⭐ 强烈推荐

# 3. 提交
git commit -m "feat: add user authentication"
git commit --amend               # 修改最近一次提交（未 push 时）
git commit --amend --no-edit     # 仅修改内容，保留 commit message

# 4. 推送
git push
git push -u origin feature/xxx   # 首次推送并建立追踪关系
git push --force-with-lease      # 安全的强推（替代 --force）⭐

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20

# 查看分支
git branch                       # 本地分支
git branch -r                    # 远程分支
git branch -a                    # 所有分支
git branch -v                    # 显示最新 commit

# 创建 & 切换
git checkout -b feature/xxx      # 创建并切换（经典）
git switch -c feature/xxx        # 创建并切换（现代语法）⭐
git switch main                  # 切换到已有分支

# 合并
git merge feature/xxx            # 合并（默认 fast-forward）
git merge --no-ff feature/xxx    # 强制创建 merge commit（保留分支历史）
git merge --squash feature/xxx   # 压缩为单个 commit 再合并

# 删除
git branch -d feature/xxx        # 已合并的分支
git branch -D feature/xxx        # 强制删除（未合并）
git push origin --delete feature/xxx  # 删除远程分支

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19

# 基本 rebase（将当前分支变基到 main）
git rebase main

# 交互式 rebase（整理最近 N 个 commit）⭐ 提交前必做
git rebase -i HEAD~3
# 常用操作:
# pick   = 保留
# reword = 修改 commit message
# edit   = 暂停以修改内容
# squash = 合并到上一个 commit
# drop   = 删除

# rebase 冲突处理流程
git rebase main
# 解决冲突...
git add <conflicted-files>
git rebase --continue
# 或放弃
git rebase --abort

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16

# 撤销工作区修改（危险：丢失未暂存的修改）
git restore <file>               # 现代语法
git checkout -- <file>           # 经典语法

# 撤销暂存区（unstage）
git restore --staged <file>
git reset HEAD <file>

# 撤销提交（三种模式）
git reset --soft HEAD~1          # 撤销 commit，保留暂存区 ← 最安全
git reset --mixed HEAD~1         # 撤销 commit + 暂存区，保留工作区（默认）
git reset --hard HEAD~1          # 全部撤销，工作区也回滚 ← 谨慎！

# 反向提交（已 push 后的安全撤销）
git revert HEAD                  # 创建一个"反操作"commit
git revert <commit-hash>

1
2
3
4
5
6
7
8
9

git stash                        # 储藏当前工作区
git stash push -m "WIP: oauth"  # 带描述的储藏
git stash -u                     # 同时储藏未追踪文件

git stash list                   # 查看所有储藏
git stash pop                    # 应用最新储藏并删除
git stash apply stash@{2}        # 应用指定储藏（保留）
git stash drop stash@{0}         # 删除指定储藏
git stash clear                  # 清空所有储藏

1
2
3
4
5
6
7
8

# 将指定 commit 应用到当前分支
git cherry-pick <commit-hash>

# 摘取一段连续 commit（左开右闭）
git cherry-pick A..B

# 摘取但不自动提交（先检查再提交）
git cherry-pick -n <commit-hash>

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22

# 漂亮的 log
git log --oneline --graph --decorate --all     # 图形化历史
git log --oneline -20                          # 最近 20 条
git log --author="yourname" --since="2 weeks ago"
git log -p <file>                              # 某文件的完整变更历史

# 搜索
git log -S "functionName"                      # 查找引入/删除某字符串的 commit
git log -G "regex"                             # 正则搜索
git log --grep="fix:"                          # 按 commit message 搜索

# Blame（追责）
git blame <file>
git blame -L 10,20 <file>                      # 仅看指定行范围

# 二分查找 bug（神器）⭐
git bisect start
git bisect bad                                 # 当前版本有 bug
git bisect good v1.2.0                         # 该版本是好的
# Git 自动 checkout 中间版本，你测试后标记 good/bad
# 直到精确定位到引入 bug 的 commit
git bisect reset                               # 结束 bisect

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

# 管理远程
git remote -v
git remote add upstream git@github.com:original/repo.git
git remote set-url origin git@github.com:you/repo.git

# 同步
git fetch origin                 # 拉取远程变更（不合并）
git fetch --all --prune          # 拉取所有远程，清理已删除的远程分支 ⭐
git pull --rebase                # 拉取 + rebase（推荐替代默认 merge）

# Fork 工作流同步上游
git fetch upstream
git rebase upstream/main

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

# 创建标签
git tag v1.0.0                           # 轻量标签
git tag -a v1.0.0 -m "Release 1.0.0"    # 附注标签（推荐）⭐

# 推送标签
git push origin v1.0.0
git push origin --tags                   # 推送所有标签

# 删除
git tag -d v1.0.0
git push origin --delete v1.0.0

1
2
3
4

# 好的 commit message 示例
feat(auth): add JWT refresh token rotation
fix(api): handle nil pointer in user lookup
refactor(db): extract connection pool config

1
2
3
4
5
6
7
8
9

# 常用 Hook 位置（.git/hooks/ 或使用 husky）
pre-commit     # 提交前：运行 lint、format、单测
commit-msg     # 验证 commit message 格式
pre-push       # push 前：运行完整测试套件
post-merge     # merge 后：自动 npm install 等

# 使用 husky（Node 项目）
npx husky init
echo "go test ./..." > .husky/pre-push

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

[alias]
    # 常用简写
    st = status -s
    co = checkout
    sw = switch
    br = branch
    ci = commit
    cp = cherry-pick

    # 漂亮的 log
    lg = log --oneline --graph --decorate --all
    ll = log --oneline -20

    # 安全操作
    pushf = push --force-with-lease

    # 撤销暂存
    unstage = restore --staged

    # 显示最后一次提交
    last = log -1 HEAD --stat

    # 清理已合并的本地分支
    cleanup = "!git branch --merged main | grep -v main | xargs git branch -d"

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

# 查看本地所有操作历史（包括 reset、rebase 等）
git reflog

# 误 reset --hard 后恢复
git reflog
git reset --hard HEAD@{3}      # 回到误操作前的状态

# 误删分支恢复
git reflog | grep "branch-name"
git checkout -b recovered-branch <commit-hash>

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

# 冲突标记含义
<<<<<<< HEAD         ← 当前分支的内容
your changes
=======
incoming changes
>>>>>>> feature/xxx  ← 被合并分支的内容

# 推荐工具
git mergetool        # 调用外部 diff 工具
# 或配置 VS Code / IntelliJ 作为 merge tool
git config --global merge.tool vscode