Git 高级用法与全命令手册（架构师版）

git status              # 哪些文件变了/已暂存
git diff                # 工作区 vs 暂存
git diff --cached       # 暂存 vs 本地库
git diff HEAD           # 工作区 vs 最新提交

git fetch               # 默认远程（origin）所有分支
git fetch --all         # 所有 remote
git fetch origin main   # 拉取 origin/main
git fetch --prune       # 顺便清理远程已删分支的本地引用
git fetch --tags        # 同步标签
git fetch --depth=1     # 浅抓取（仅最近提交）

git checkout main
git merge feature/login          # 尝试快进（fast-forward），否则产生 merge commit
git merge --no-ff feature/login  # 即使可快进，也强制产生 merge commit，保留分支轨迹
git merge --ff-only origin/main  # 仅允许快进，不能则失败
git merge -s ours other          # 冲突时偏向“ours”策略（慎用）
git merge -X theirs other        # 单文件层面的冲突偏向“theirs”（ORT策略参数）
git merge --abort                # 取消进行中的合并

git switch main           # 推荐
git checkout main         # 老命令
git switch -c feature-x   # 新建并切换

git restore path/file            # 用 index 覆盖工作区
git restore --source=HEAD file   # 用某版本覆盖
git checkout -- file             # 老写法（等价于上面）

git switch feature
git rebase main                        # 基本重放
git rebase --onto main A B             # 将 A..B 的提交搬到 main 后
git rebase -i main                     # 交互式：reword/edit/squash/fixup
git rebase --rebase-merges             # 尝试保留合并结构
git rebase --autosquash                # 自动把 fixup!/squash! 提交压进前面的提交
git rebase --autostash                 # 重排前先暂存未提交更改
git rebase --abort | --continue | --skip

git init [--initial-branch=main]     # 新仓库
git clone <url> [dir]                # 克隆（可加 --depth=1 浅克隆）
git config --global user.name "You"
git config --global user.email you@example.com
git config --global init.defaultBranch main
git config --global pull.rebase true
git help <cmd> | git <cmd> -h

git status -sb
git diff [--cached] [--name-only]
git log --graph --oneline --decorate --all
git show <commit>[:path]             # 看提交/文件在该提交的内容
git describe --tags                  # 最近的可达标签描述
git grep -n "pattern"                # 在历史/工作区中搜索

git add -p                   # 交互式分块暂存
git rm path                  # 删除并暂存删除
git mv a b                   # 重命名（保持历史追踪）
git restore --staged file    # 从暂存区移除（保留工作区改动）

git commit -m "feat: ..."          # 新提交
git commit --amend                 # 修正上一提交
git reset --soft HEAD~1            # 回退指针，保留暂存+工作区
git reset --mixed HEAD~1           # （默认）回退并清空暂存，保留工作区
git reset --hard HEAD~1            # 全部回退（危险）
git revert <commit>                # 生成反向提交（不改历史）
git reflog                         # 所有 HEAD 变动轨迹，可救急找回
git notes add -m "extra meta" <commit>   # 给提交加“旁注”

git branch -vv                 # 查看本地分支及上游
git branch -d|-D feature       # 删除分支（-D 强制）
git cherry-pick <commit>       # 拣选单个提交到当前分支
git cherry-pick A..B           # 拣选一段（不含 A，含 B）
git range-diff old..new        # 比较两个范围的差异（rebase 后审阅）

git remote -v
git remote add origin <url>
git remote set-url origin <new-url>
git fetch --all --prune
git pull --rebase --autostash
git push -u origin feature              # 建立上游
git push --force-with-lease             # 安全强推（对比远端快照）
# 子模块
git submodule add <url> path
git submodule update --init --recursive
git submodule deinit -f path
# （备选）git subtree（非内置命令，常装作扩展）

git stash push -m "wip: xx" [-- path]   # 保存未提交改动
git stash list
git stash show -p stash@{0}
git stash apply|pop stash@{0}
git worktree add ../repo-fix <branch|commit>  # 多工作区并行开发
git worktree list
git worktree remove ../repo-fix

git gc --aggressive               # 垃圾回收与紧缩（谨慎用在大仓）
git fsck                          # 完整性检查
git prune                         # 移除不可达对象（配合 reflog 过期）
git repack -ad                    # 重新打包对象，优化大小
git clean -fdx                    # 清理未跟踪/忽略文件（危险）
git sparse-checkout init --cone
git sparse-checkout set dirA dirB # 只检出部分目录

git tag -a v1.2.3 -m "release"
git push --tags
git archive -o release.zip HEAD   # 导出归档
git format-patch origin/main..HEAD  # 生成补丁序列
git am *.patch                    # 应用邮件补丁
git apply --3way diff.patch       # 三方合并应用补丁

git bisect start
git bisect bad                    # 当前坏
git bisect good <commit>          # 某历史好
# 按提示二分检索直至定位坏提交
git blame -L 10,50 path/file      # 谁在何时改了哪些行
git shortlog -sn --all            # 贡献者统计

echo hi | git hash-object -w --stdin        # 产出 blob id
git mktree                                   # 交互读入 "100644 blob <blob-id>\tfile"
git commit-tree <tree-id> -m "first"         # 产出 commit id
git update-ref refs/heads/main <commit-id>   # 建立分支指向它

# 拉取策略
git config --global pull.rebase true          # pull 默认 rebase
git config --global rebase.autoStash true     # rebase 前自动 stash
git config --global fetch.prune true          # fetch 自动 prune
git config --global merge.ff only             # 只允许快进合并
git config --global rerere.enabled true       # 记忆并自动复用冲突解决

# 行结尾与编码
git config --global core.autocrlf input       # mac/linux 推荐，windows 可设 true
git config --global core.ignorecase false

# 默认分支
git config --global init.defaultBranch main

# 推送策略
git config --global push.default simple        # 或 upstream/current

# 凭证
git config --global credential.helper store|manager-core|osxkeychain

# 签名
git config --global user.signingkey <GPG_KEY>
git config --global commit.gpgsign true

git clone --depth=1 <url>                   # 浅克隆
git clone --filter=blob:none <url>          # 部分克隆（需要较新服务器支持）
git sparse-checkout init --cone
git sparse-checkout set src/ docs/
git repack -Ad && git gc

git fetch origin
git rebase origin/main

git commit --amend -m "fix: correct message"

git revert <bad-commit>
git push

git reflog
git branch recover <sha-from-reflog>

git switch release/1.2
git cherry-pick <fix-commit>

git stash push -m "wip"
git switch -c hotfix/xxx
# ... 修完回到原分支
git switch -
git stash pop