【Git 权威指南】读书笔记 - 独奏

diff -u hello.old hello.new > hello.patch     # -u: unified 格式，带上下文，是补丁的必备参数
patch hello.old < hello.patch                  # 升级到 new
patch -R hello.old < hello.patch               # -R: 反向，回到 old
patch -p1 < changes.patch                      # -p1: 跳过路径首层，用于跨目录补丁

--- hello.old   2026-05-14 10:00:00
+++ hello.new   2026-05-14 10:05:00
@@ -1,3 +1,3 @@
 hello
-world
+git
 !

brew install git                                     # macOS
sudo apt install git git-doc git-svn git-email gitk  # Debian / Ubuntu

git help -w <subcommand>

git config --global user.name "Jiang Xin"
git config --global user.email jiangxin@ossxp.com

git config --global alias.br branch
git config --global alias.ci commit
git config --global alias.co checkout
git config --global alias.st status

git config --global core.quotepath false

git init demo               # 等价于 mkdir demo && cd demo && git init
cd demo
ls -aF                      # → ./  ../  .git/

strace -e 'trace=file' git status

git rev-parse --git-dir          # → /path/to/demo/.git
git rev-parse --show-toplevel    # → /path/to/demo

git config core.bare              # 读
git config a.b something          # 写 → [a] b = something
git config x.y.z others           # 写 → [x "y"] z = others

GIT_CONFIG=test.ini git config a.b.c.d "hello, world"

git config --global user.name "Jiang Xin"
git commit --amend --allow-empty --reset-author

git add welcome.txt
git diff                     # 工作区 vs 暂存区
git diff --cached            # 暂存区 vs HEAD
git status -s                # 简洁状态：?? 未跟踪 / A  新增 / M  暂存 /  M 仅工作区改 / MM 都改
git commit -m "which version checked in?"
git log --pretty=oneline

git ls-tree -l HEAD          # HEAD 的 tree
git ls-files -s              # 暂存区的 tree

git log -1 --pretty=raw
# commit  e695606fc5e31b2ff9038a48a3d363f4c21a3d86   ← 本次提交
# tree    f58da9a820e3fd9d84ab2ca2f1b467ac265038f9   ← 提交对应的目录快照
# parent  a0c641e92b10d8bcca1ed1bf84ca80340fdefee6   ← 上一次提交

git cat-file -t e695606      # → commit
git cat-file -t f58d         # → tree
git cat-file -t fd3c06       # → blob
git cat-file -p fd3c06       # → 文件内容

ls .git/objects/e6/95606fc5e31b2ff9038a48a3d363f4c21a3d86

cat .git/HEAD                          # → ref: refs/heads/master
cat .git/refs/heads/master             # → e695606fc5e31b2ff9038a48a3d363f4c21a3d86

git cat-file commit HEAD | wc -c                          # → 234   content 字节数
( printf "commit 234\000"; git cat-file commit HEAD ) | sha1sum
# → e695606fc5e31b2ff9038a48a3d363f4c21a3d86             手工算的
git rev-parse HEAD
# → e695606fc5e31b2ff9038a48a3d363f4c21a3d86             Git 自己给的，完全一致

git cat-file -p e695
git cat-file -p e695^
git rev-parse e695^{tree}

git reset --hard HEAD^         # 拨回到上一个 commit

git reset HEAD <file>          # 撤出暂存区（git add 的反操作），工作区不动
git reset --soft HEAD^         # 撤销最近一次 commit，改动留在暂存区，便于修改后重新 commit
git reset --hard HEAD^         # 彻底丢掉最近一次 commit + 所有未提交改动

git reflog show master | head -5
# 9e8a761 master@{0}: 9e8a761: updating HEAD
# e695606 master@{1}: HEAD^: updating HEAD
# 4902dc3 master@{2}: commit: does master follow this new commit?

git reset --hard master@{2}    # 拨回到两步之前

git checkout HEAD^
# You are in 'detached HEAD' state.

cat .git/HEAD
# 3175afde9450a1dc40b09d05a012b45e967cb80f   ← 直接是 SHA-1，不再是 "ref: refs/heads/xxx"

git checkout master
git merge <游离提交的 SHA-1>

git stash                       # 默认只暂存已跟踪文件；-u 含未跟踪，-a 含被忽略
git stash list                  # 查看 stash 栈
git stash pop                   # 恢复并删除最近一笔
git stash apply stash@{1}       # 恢复但不删除指定 stash
git stash drop stash@{1}        # 删除指定 stash
git stash branch <name>         # 基于某次 stash 创建分支

git tag -m "v1.0 release" v1.0          # 附注 tag，会生成独立的 tag 对象
git tag v1.0-lw                          # 轻量 tag，只是引用文件指向某 commit
git rev-parse refs/tags/v1.0

git describe
# v1.0-2-g8861c65
#  └┬─┘ │ └──┬──┘
# 最近tag │   该提交 SHA-1 前缀
#       距 tag 的提交数

git add -u                     # 已跟踪文件的所有改动（含删除），不含新文件
git add -A                     # 所有改动（含删除、含新文件）

git cat-file -p HEAD~1:welcome.txt > welcome.txt
git add welcome.txt && git commit -m "restore welcome.txt"

git mv welcome.txt README       # 等价于 mv + git rm + git add

git add -f hello.h

git archive -o latest.zip HEAD
git archive -o partial.tar HEAD src doc
git archive --format=tar --prefix=foo-1.0/ v1.0 | gzip > foo-1.0.tar.gz

git rev-list --oneline G..D            # D 的历史 - G 的历史
git rev-list --oneline ^G D            # 等价写法，^X = 排除 X 及其历史
git rev-list --oneline D F             # D 和 F 的历史的并集

git rev-parse --git-dir                # .git 目录位置
git rev-parse --show-toplevel          # 工作区根
git rev-parse --show-cdup              # 到根的相对深度
git rev-parse --symbolic --branches    # 列出所有分支名

git log --oneline -5                   # 最近 5 条单行
git log --graph --oneline              # 字符版分支图
git log -p <file>                      # 含 diff
git log --stat                         # 含变更摘要
git log --pretty=raw -1                # 看 tree/parent/author 原始信息

git config --global alias.glog "log --graph --oneline --decorate"

git blame README                # 每行首显示引入该行的 commit + author
git blame -L 6,+5 README        # 只看第 6 行起的 5 行

git bisect start
git bisect bad HEAD                    # 当前是坏的
git bisect good v1.0                   # v1.0 时是好的
# Git 自动 checkout 中间提交，跑测试后告诉它 good / bad
git bisect good
git bisect bad
# ... 直到锁定第一个坏提交
git bisect reset

git commit --amend                     # 修补最近一次 commit（改文件或改 message）
git commit --amend --no-edit           # 只补文件，不改 message

git reset --soft HEAD~3
git commit -m "squashed 3 commits"

git cherry-pick <commit>

git rebase --onto <newbase> <since> <till>
# 把 (since, till] 这段提交摘出来，逐个重放到 newbase 之上

git rebase -i HEAD~5
# pick   保留
# reword 改 message
# edit   中途停下手改
# squash 合并到上一个
# fixup  合并到上一个，丢弃 message
# drop   删除该 commit

# 1. 用某次提交的 tree 直接造一个孤儿提交（无 parent）
echo "Initial squashed commit" | git commit-tree HEAD~100^{tree}
# → 输出新 commit 的 SHA-1，记为 $ORPHAN

# 2. 把 HEAD~100 之后的所有提交嫁接到孤儿之上
git rebase --onto $ORPHAN HEAD~100 master

git revert HEAD                # 撤销最近一次
git revert <commit>            # 撤销指定提交

git clone <url> <dir>                  # 含工作区
git clone --bare <url> <dir.git>       # 裸库，无工作区
git clone --mirror <url> <dir.git>     # 裸库 + 注册上游，可持续 git fetch 同步

git init --bare /srv/git/demo.git      # 新建空裸库
git push /srv/git/demo.git              # 工作区可直接 push 进去