Git 查看状态和历史

Git 查看状态和历史

1. Git 状态查看：掌握你的代码仓库实时动态

Git 作为现代软件开发的核心版本控制工具，提供了强大的状态检查功能，帮助开发者随时了解代码仓库的当前状态。掌握这些命令对于高效协作和代码管理至关重要。

1.1 git status - 最基础的状态检查命令

git status 是 Git 中最常用的命令之一，它提供了关于工作目录、暂存区和本地仓库的简要信息。

$ git status
On branch main
Changes to be committed:
  (use "git restore --staged <file>..." to unstage)
        modified:   src/utils.js

Changes not staged for commit:
  (use "git add <file>..." to update what will be committed)
  (use "git restore <file>..." to discard changes in working directory)
        modified:   README.md
        modified:   package.json

no changes added to commit (use "git add" and/or "git commit -a")

输出解析：

• Changes to be committed：已暂存但未提交的更改
• Changes not staged for commit：已修改但未暂存的文件
• no changes added to commit：没有新增的更改

1.2 git status 的进阶选项

git status 命令支持多种选项，可以提供更详细或更简洁的信息：

# 以简短格式显示状态
$ git status --short
 M src/utils.js
?? new-feature.js

# 显示分支跟踪信息
$ git status --branch
On branch main
Your branch is up to date with 'origin/main'.
...

1.3 文件状态码详解

在 git status --short 输出中，每个文件前面都有一个两字符的状态码：

 M = modified
 A = added
 D = deleted
 R = renamed
 C = copied
 ?? = untracked
!! = ignored

例如：

• M README.md：文件已修改但未暂存
• M src/utils.js：文件已修改且已暂存
• ?? new-feature.js：未跟踪的新文件

1.4 实用技巧：自定义 git status

你可以通过配置 .gitconfig 来自定义 git status 的输出格式：

[status]
    branch = true
    showuntrackedfiles = all
[alias]
    st = status --short --branch

这样你就可以使用 git st 来获得简洁的分支状态信息。

2. Git 历史查看：深入探索代码演进历程

Git 的历史记录功能是其最强大的特性之一，它允许开发者追踪每一次代码变更，理解项目演进过程，并在需要时回溯到特定状态。

2.1 git log - 查看提交历史

git log 是查看提交历史的基本命令，提供了丰富的选项来定制输出格式。

# 基本用法
$ git log
commit a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9t0u1v2w3x4y5z6
Author: John Doe <john@example.com>
Date:   Mon Oct 10 14:30:15 2023 +0800

    Add user authentication feature

commit b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9t0u1v2w3x4y5z6a7
Author: Jane Smith <jane@example.com>
Date:   Mon Oct 10 10:15:22 2023 +0800

    Fix login page bug

commit c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9t0u1v2w3x4y5z6a7b8
Author: John Doe <john@example.com>
Date:   Sun Oct 9 18:45:36 2023 +0800

    Implement responsive design

2.2 git log 的常用选项

git log 提供了大量选项来定制输出：

# 显示简化的提交历史
$ git log --oneline
a1b2c3d (HEAD -> main) Add user authentication feature
b2c3d4e Fix login page bug
c3d4e5f Implement responsive design

# 限制显示的提交数量
$ git log -5
$ git log --n=5

# 显示文件变更
$ git log --follow src/components/Login.js

2.3 可视化历史记录

Git 提供了几种可视化工具来更直观地查看历史：

# 以图形化方式显示分支和合并历史
$ git log --graph --oneline --decorate --all

# 使用 gitk 可视化工具
$ gitk

# 使用 git GUI 工具
$ git gui

2.4 高级历史查询

Git 支持强大的历史查询功能，可以根据作者、时间范围、内容等进行筛选：

# 查看特定作者的提交
$ git log --author="John Doe"

# 查看过去一周的提交
$ git log --since="1 week ago"

# 查看包含特定关键词的提交
$ git log --grep="bug fix"

# 查看涉及特定文件的提交
$ git log -- src/utils.js

# 显示统计信息
$ git log --stat

2.5 提交哈希和引用理解

每个提交都有一个唯一的哈希值，这是 Git 引用特定提交的方式：

# 使用完整哈希引用提交
$ git show a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9t0u1v2w3x4y5z6

# 使用短哈希（通常前7位足够）
$ git show a1b2c3d

# 使用分支名或标签引用
$ git show main
$ git show v1.0.0

3. 高级状态与历史分析：深入挖掘 Git 信息

对于大型项目和复杂协作场景，掌握 Git 的高级状态和历史分析技巧可以显著提高开发效率和问题排查能力。

3.1 git diff - 比较文件差异

git diff 是查看文件差异的核心工具，可以在工作目录、暂存区和历史版本之间进行比较：

# 比较工作目录和暂存区
$ git diff

# 比较暂存区和最新提交
$ git diff --staged

# 比较两个提交之间的差异
$ git diff main~1 main

# 比较两个分支的差异
$ git diff feature/main main

# 显示统计信息
$ git diff --stat

3.2 git blame - 追踪代码行变更历史

git blame（或 git annotate）可以显示每一行代码的最后修改者、提交哈希和修改时间：

# 查看文件的行级变更历史
$ git blame src/utils.js

# 查看特定函数的变更历史
$ git blame -L 20,30 src/utils.js

# 忽略合并提交
$ git blame --ignore-revs-file .git-blame-ignore-revs src/utils.js

3.3 git reflog - 查看引用日志

git reflog 记录了本地仓库的所有引用变更，是恢复丢失提交的强大工具：

# 查看引用日志
$ git reflog

# 恢复到特定引用日志条目
$ git reset HEAD@{2}

3.4 git bisect - 二分查找问题提交

当引入问题的提交未知时，git bisect 可以通过二分查找快速定位问题提交：

# 开始二分查找
$ git bisect start

# 标记当前提交为"bad"
$ git bisect bad

# 标记已知的好提交
$ git bisect good v1.2.0

# Git 会自动检查中间提交，根据结果标记为good或bad
$ git bisect good
$ git bisect bad

# 查找完成后退出
$ git bisect reset

3.5 Git 历史重写工具

在某些情况下，可能需要重写历史记录：

# 修改最后一次提交
$ git commit --amend

# 交互式 rebase 修改多个提交
$ git rebase -i HEAD~3

# 重写提交历史
$ git filter-branch --msg-filter '添加项目前缀: ' HEAD

3.6 实用案例分析：调试生产问题

假设生产环境出现了一个 bug，但不确定是哪个提交引入的：

# 1. 创建新分支用于调试
$ git checkout -b debug-branch main

# 2. 使用 bisect 开始查找
$ git bisect start
$ git bisect bad
$ git bisect good v2.3.0

# 3. 根据测试结果标记 good/bad
$ git bisect good  # 如果测试通过
$ git bisect bad   # 如果测试失败

# 4. 找到问题提交后查看详情
$ git show HEAD

# 5. 修复问题后合并回主分支
$ git checkout main
$ git merge debug-branch

通过这些高级技巧，开发者可以更有效地分析 Git 历史记录，快速定位问题，并维护一个干净、可追溯的代码历史。