查看历史与差异

# 查看当前分支的完整提交历史
git log

# 限制显示条数
git log -5          # 最近 5 条
git log -1          # 最近 1 条（等同于 HEAD 所指提交）

git log --oneline
# e3a1b2f fix: 修复登录超时问题
# 7c9d4e1 feat: 添加 OAuth2 支持
# a1b2c3d chore: 升级依赖版本

git log --oneline --graph --all

* e3a1b2f (HEAD -> main) fix: 修复登录超时问题
* 7c9d4e1 feat: 添加 OAuth2 支持
|\
| * a1b2c3d (feature/oauth) chore: 升级依赖版本
| * f4e5d6c feat: OAuth2 初版
|/
* b7c8d9e init: 项目初始化

git log --format="%h - %an, %ar : %s"
# e3a1b2f - 张三, 2 hours ago : fix: 修复登录超时问题
# 7c9d4e1 - 李四, 3 days ago : feat: 添加 OAuth2 支持

# 自动显示分支名、标签名等引用
git log --decorate

# 禁用装饰（纯净输出）
git log --decorate=no

# 简短格式
git log --decorate=short   # 默认值，省略 refs/heads/ 等前缀

# 完整格式
git log --decorate=full    # 显示 refs/heads/main 等完整引用名

# 业界最常用的 log 命令组合
git log --oneline --graph --decorate --all

git config --global alias.lg "log --oneline --graph --decorate --all"
# 之后只需 git lg

# 指定日期之后
git log --since="2025-01-01"
git log --after="2 weeks ago"

# 指定日期之前
git log --until="2025-06-30"
git log --before="yesterday"

# 组合使用
git log --since="2025-01-01" --until="2025-06-30"

# 精确匹配
git log --author="张三"

# 正则匹配（匹配作者名或邮箱）
git log --author="@example\.com$"
git log --author="张\|李"

# 搜索消息中包含指定字符串的提交
git log --grep="修复"

# 取反：搜索不包含指定字符串的提交
git log --grep="修复" --invert-grep

# 正则匹配
git log --grep="feat\|fix"

# 只查看涉及特定文件的提交
git log -- src/auth/login.ts

# 查看涉及 src/auth 目录下所有文件的提交
git log -- src/auth/

# 组合：查看特定作者修改特定文件的提交
git log --author="张三" -- src/auth/

# -S：拾荒者搜索（pickaxe search）
# 查找"添加或删除了指定字符串"的提交
git log -S "OAuth2"

# -S 配合 --pickaxe-all 显示所有相关文件（默认只显示匹配文件）
git log -S "OAuth2" --pickaxe-all

# -G：正则搜索
# 查找"差异中匹配正则模式"的提交
git log -G "function\s+handle\w+"

# 示例：查找某个配置项何时被引入
git log -S "MAX_RETRIES" --oneline

# 示例：查找所有涉及 error handler 变更的提交
git log -G "catch\s*\(" --oneline

# 查看某个分支的提交
git log main

# 查看分支分叉点之后的提交（main 有而 feature 没有的）
git log main..feature

# 查看两个分支的对称差异
git log main...feature

# 只显示合并提交
git log --merges

# 排除合并提交
git log --no-merges

# 查看某个标签以来的提交
git log v1.0.0..

# 查看工作区中尚未暂存的变更
git diff

# 查看特定文件的未暂存变更
git diff -- src/auth/login.ts

# 查看统计信息而非完整 diff
git diff --stat

# 只显示变更的文件名
git diff --name-only

# 查看已暂存但尚未提交的变更
git diff --cached
# 或
git diff --staged

# 比较暂存区与特定提交
git diff --cached HEAD~1

# 查看特定文件的暂存变更
git diff --cached -- src/auth/login.ts

# 比较两个提交
git diff abc1234 def5678

# 比较两个分支
git diff main feature/oauth

# 比较分支分叉点
git diff main...feature/oauth   # feature 相对于分叉点的变更

# 比较某个提交与其父提交
git diff HEAD~1 HEAD            # 最近一次提交引入的变更

diff --git a/src/auth/login.ts b/src/auth/login.ts
index a1b2c3d..e4f5g6h 100644
--- a/src/auth/login.ts
+++ b/src/auth/login.ts
@@ -15,7 +15,8 @@ export class LoginService {
   private maxRetries = 3;
   private timeout = 5000;

-  async login(username: string, password: string) {
+  async login(username: string, password: string, options?: LoginOptions) {
+    const opts = { timeout: this.timeout, ...options };
     const token = await this.authenticate(username, password);
     return this.validateToken(token);
   }

# 忽略空白变更
git diff -w                # 忽略所有空白差异
git diff --ignore-blank-lines  # 忽略空行的增删

# 函数级别上下文
git diff -W                # 显示整个函数的上下文

# 统计摘要
git diff --stat            # 每个文件的增删行数统计
git diff --numstat         # 机器可读的增删行数
git diff --shortstat       # 只显示总计数

# 重命名检测
git diff -M                # 检测重命名（默认开启，可调阈值）
git diff -M50%             # 相似度 >= 50% 即视为重命名

# 拷贝检测
git diff -C                # 同时检测重命名和拷贝

# 词级别 diff（更细粒度）
git diff --word-diff       # 词级别高亮
git diff --word-diff=color # 彩色词级别 diff
git diff --color-words     # 同上，简写形式

# 前缀定制（适用于对比不同目录结构）
git diff --src-prefix=a/ --dst-prefix=b/

# 逐字符比较
git diff --patience        # 使用 patience 算法（见后文）

# 命令行指定
git diff --diff-algorithm=histogram

# 全局配置
git config --global diff.algorithm histogram

# 查看 HEAD 提交的详情
git show

# 查看指定提交
git show abc1234

# 查看缩写（同上，Git 会自动匹配）
git show abc1

# 查看某个标签指向的提交
git show v1.0.0

# 只看统计信息，不显示完整 diff
git show --stat abc1234

# 只看提交消息，不显示 diff
git show --no-patch abc1234
# 或
git show -s abc1234

# 自定义格式
git show --format="%H %an %s" -s abc1234

# 只看某次提交中特定文件的 diff
git show abc1234 -- src/auth/login.ts

# 查看标签对象（含打标签者信息和消息）
git show v1.0.0

# 查看树对象
git show HEAD^{tree}

# 查看某个 blob 的内容
git show HEAD:src/auth/login.ts

# 查看 main 分支上的配置文件
git show main:package.json

# 查看上一次提交时的某个文件
git show HEAD~1:src/auth/login.ts

# 查看某个标签对应版本的文件
git show v2.0.0:CHANGELOG.md

# 按作者汇总提交数
git shortlog

# 指定版本范围
git shortlog v1.0.0..v2.0.0
git shortlog v1.0.0..HEAD

张三 (15):
      fix: 修复登录超时问题
      feat: 添加 OAuth2 支持
      ...

李四 (8):
      refactor: 重构认证模块
      docs: 更新 API 文档
      ...

# 按提交数排序（从多到少）
git shortlog -n

# 只显示提交计数，不显示消息
git shortlog -s

# 同时排序和计数
git shortlog -sn

# 按邮箱而非名字分组
git shortlog -se

# 总结格式（计数 + 名字，一行一个作者）
git shortlog -sn --no-merges v1.0.0..v2.0.0

  15  张三
   8  李四
   3  王五

# .mailmap 文件内容
张三 <zhangsan@company.com> <zhangsan@gmail.com>
张三 <zhangsan@company.com> <zs@old-company.com>

# 只看主线历史（忽略被合并的分支）
git log --first-parent

# 只保留 A 到 B 路径上的提交
git log A..B --ancestry-path

# 生成 commit-graph 加速遍历
git commit-graph write --reachable

# 验证 commit-graph
git commit-graph verify

# 日常开发推荐使用 histogram
git config --global diff.algorithm histogram

# 临时使用其他算法
git diff --diff-algorithm=myers
git diff --diff-algorithm=patience

# 查看文件每一行的归属
git blame src/auth/login.ts

^a1b2c3d (张三 2025-01-10 10:30:15 +0800  1) import { Injectable } from '@angular/core';
e4f5g6h7 (李四 2025-02-20 14:22:33 +0800  2) import { HttpClient } from '@angular/common/http';
e4f5g6h7 (李四 2025-02-20 14:22:33 +0800  3)
^a1b2c3d (张三 2025-01-10 10:30:15 +0800  4) @Injectable({ providedIn: 'root' })
a1b2c3d (张三 2025-03-05 09:15:42 +0800  5) export class LoginService {

# 只看指定行范围
git blame -L 10,30 src/auth/login.ts
git blame -L 10,+5 src/auth/login.ts    # 第 10 行起 5 行
git blame -L "/class LoginService/",+20 src/auth/login.ts  # 正则匹配起止

# 显示邮箱而非名字
git blame -e src/auth/login.ts

# 忽略空白变更
git blame -w src/auth/login.ts

# 忽略移动/拷贝的行
git blame -M src/auth/login.ts           # 检测同一文件内的移动
git blame -C src/auth/login.ts           # 检测从其他文件拷贝的行
git blame -CC src/auth/login.ts          # 更激进的拷贝检测
git blame -CCC src/auth/login.ts         # 最激进的拷贝检测

# 找出 MAX_RETRIES 常量何时被引入
git log -S "MAX_RETRIES" --oneline --all

# 找出某函数何时被删除
git log -S "handleLegacyAuth" --oneline --diff-filter=D

# 只搜索特定文件
git log -S "MAX_RETRIES" -- src/config.ts

# 找出所有修改了 async 函数签名的提交
git log -G "async\s+\w+\(" --oneline

# 找出所有涉及 TODO 注释变更的提交
git log -G "TODO|FIXME" --oneline

# 只看新增文件的提交
git log --diff-filter=A

# 只看删除文件的提交
git log --diff-filter=D

# 只看重命名的提交
git log --diff-filter=R

# 组合：只看新增和修改
git log --diff-filter=AM

# 过滤器含义：
# A = Added, C = Copied, D = Deleted, M = Modified
# R = Renamed, T = Type changed, U = Unmerged
# X = Unknown, B = Broken (pair split)

# 输出 JSON 格式（便于脚本处理）
git log --format='{"hash":"%H","author":"%an","date":"%aI","subject":"%s"}'

# 输出 CSV 格式
git log --format="%H,%an,%aI,%s"

# 每个提交的完整信息，包含 diff
git log -p

# 每个提交的文件级统计
git log --stat

# 定制统计宽度
git log --stat=120

# 列出所有可达提交
git rev-list HEAD

# 计算提交数
git rev-list --count HEAD

# 查找两个分支的分叉点
git rev-list --ancestry-path $(git merge-base main feature)..feature

# 列出某个文件的所有变更提交
git rev-list HEAD -- src/auth/login.ts

# 启动二分查找
git bisect start

# 标记当前版本有 bug
git bisect bad

# 标记已知正常的版本
git bisect good v1.0.0

# Git 自动 checkout 到中间点，测试后标记
git bisect good   # 或 git bisect bad

# 自动化：让 Git 自动运行测试脚本
git bisect run npm test

# 完成后重置
git bisect reset

# 查看 HEAD 的移动历史
git reflog

# 查看特定分支的 reflog
git reflog show main

# 查看所有引用的 reflog
git reflog --all