Week 07: 调试、恢复与仓库维护

# 1. 开始 bisect
git bisect start

# 2. 标记当前版本 (有 Bug)
git bisect bad

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

# Git 会检出中间提交

# 4. 测试并标记
git bisect good   # 如果正常
git bisect bad    # 如果有问题

# 5. 重复直到找到
# abc1234 is the first bad commit

# 6. 结束 bisect
git bisect reset

git bisect start
git bisect bad HEAD
git bisect good v1.0.0

# 自动测试
git bisect run ./test.sh
# 脚本返回 0 = good, 非 0 = bad

#!/bin/bash
# test.sh

# 编译项目
make || exit 125  # 125 = 跳过此提交

# 运行测试
./run_tests || exit 1  # 1 = bad

exit 0  # good

# 无法测试当前提交时
git bisect skip

# 跳过某个范围
git bisect skip abc1234..def5678

# 查看 bisect 历史
git bisect log

# 保存日志
git bisect log > bisect.log

# 从日志恢复
git bisect replay bisect.log

git reflog
# abc1234 HEAD@{0}: commit: Latest commit
# def5678 HEAD@{1}: checkout: moving from feature to main
# ghi9012 HEAD@{2}: commit: WIP
# jkl3456 HEAD@{3}: reset: moving to HEAD~2

# 不小心 reset 丢失了提交
git reset --hard HEAD~5

# 查看 reflog
git reflog

# 恢复到 reset 之前
git reset --hard HEAD@{1}

# 删除了分支
git branch -D feature

# 查看 reflog
git reflog

# 重新创建分支
git branch feature abc1234

# rebase 后发现问题
git reflog

# 恢复到 rebase 之前
git reset --hard ORIG_HEAD
# 或
git reset --hard HEAD@{2}

# 查看 reflog 过期时间
git config gc.reflogExpire           # 默认 90 天
git config gc.reflogExpireUnreachable # 默认 30 天

# 手动清理
git reflog expire --expire=now --all
git gc

# 完整检查
git fsck

# 静默模式 (只报告错误)
git fsck --no-full

# 检查不可达对象
git fsck --unreachable

# 检查悬空对象
git fsck --dangling

git fsck
# dangling commit abc1234
# dangling blob def5678

# 查看悬空提交内容
git show abc1234

# 创建分支指向它
git branch recovered abc1234

git fsck
# error: sha1 mismatch abc1234
# missing blob def5678

# 运行 gc
git gc

# 激进模式 (更彻底的压缩)
git gc --aggressive

# 立即删除不可达对象
git gc --prune=now

# 配置自动 gc 阈值
git config gc.auto 256                # 松散对象数量
git config gc.autoPackLimit 50        # pack 文件数量

# 禁用自动 gc
git config gc.auto 0

# 检查会删除什么
git prune -n

# 执行删除
git prune

# 删除所有过期对象
git prune --expire=now

# 基本重新打包
git repack

# 生成单个 pack
git repack -a -d

# 激进模式
git repack -A -d --depth=250 --window=250

# 查看仓库大小
du -sh .git

# 查看 pack 文件大小
du -sh .git/objects/pack

# 查看最大的对象
git rev-list --objects --all | \
  git cat-file --batch-check='%(objecttype) %(objectname) %(objectsize) %(rest)' | \
  sort -k3 -n -r | head -20

# 使用 git-filter-repo 删除大文件
git filter-repo --strip-blobs-bigger-than 10M

# 使用 BFG
bfg --strip-blobs-bigger-than 10M

# 运行 gc
git gc --prune=now --aggressive
git reflog expire --expire=now --all

# 强制推送
git push origin --force --all
git push origin --force --tags

# 只克隆最近 N 个提交
git clone --depth=1 url
git clone --depth=10 url

# 只克隆特定分支
git clone --single-branch --branch main url

# 后续获取更多历史
git fetch --unshallow
git fetch --depth=100

# 只克隆 commit 和 tree, 按需获取 blob
git clone --filter=blob:none url

# 限制 blob 大小
git clone --filter=blob:limit=1m url

# 稀疏检出
git clone --filter=blob:none --sparse url
cd repo
git sparse-checkout set src/

# 写入 commit-graph
git commit-graph write --reachable --changed-paths

# 写入 MIDX
git multi-pack-index write --bitmap

# 注册大仓库 (自动配置所有优化参数)
scalar register /path/to/repo

# 克隆大仓库
scalar clone https://github.com/microsoft/git

# 开启后台维护
git maintenance start

# 裸仓库备份
git clone --mirror origin-url backup.git

# 更新备份
cd backup.git
git fetch origin +refs/*:refs/*

# 创建完整备份
git bundle create backup.bundle --all

# 增量备份
git bundle create incremental.bundle main ^v1.0.0

# 验证
git bundle verify backup.bundle

# 1. 裸克隆原仓库
git clone --bare old-url

# 2. 推送到新地址
cd repo.git
git push --mirror new-url

# 3. 或直接更新 remote
git remote set-url origin new-url
git push --mirror