高级操作

# 暂存当前修改
git stash
git stash push -m "WIP: refactoring login"

# 暂存所有（包括未跟踪的文件）
git stash -u
git stash --include-untracked

# 查看 stash 列表
git stash list
# stash@{0}: On main: WIP: refactoring login
# stash@{1}: On feature: Half-done work

# 恢复最近一次 stash（不删除 stash 记录）
git stash apply
git stash apply stash@{1}

# 恢复最近一次 stash（删除 stash 记录）
git stash pop

# 查看 stash 内容
git stash show -p
git stash show -p stash@{1}

# 删除 stash
git stash drop stash@{0}
git stash clear                # 清空所有

# 从 stash 创建分支
git stash branch <branch_name> stash@{0}

# 场景：开发到一半，需要紧急修复 bug
git stash -u                   # 暂存当前工作
git checkout main
git checkout -b hotfix
# ... 修复、提交 ...
git checkout feature
git stash pop                  # 恢复之前的工作

# 启动二分查找
git bisect start

# 标记当前版本为 bad（有问题）
git bisect bad HEAD

# 标记已知正常版本为 good
git bisect good v1.0
# Git 会自动 checkout 中间的某个提交

# 测试后标记
git bisect good                 # 这个版本没问题
git bisect bad                  # 这个版本有问题

# 重复 good/bad，直到定位到引入 bug 的第一个 commit

# 结束 bisect
git bisect reset               # 回到原始分支

# 自动化 bisect（推荐）
git bisect start HEAD v1.0
git bisect run ./test_script.sh  # 脚本返回 0=good, 非 0=bad

# test_script.sh
#!/bin/bash
npm test -- --testPathPattern="failing_test" > /dev/null 2>&1
exit $?

# 自动跑
git bisect start HEAD v2.0
git bisect run ./test_script.sh
# Git 自动二分查找，输出第一个 bad commit
git bisect reset

# 轻量标签（只记录引用）
git tag v1.0

# 注释标签（推荐——包含元数据）
git tag -a v1.0 -m "Release version 1.0"
git tag -a v1.0 -m "Release v1.0" <commit_hash>   # 为历史提交打标签

# 查看标签
git tag                         # 列出所有
git tag -l "v1.*"               # 通配符过滤
git show v1.0                   # 查看标签详情

# 推送标签
git push origin v1.0            # 推送单个
git push --tags                 # 推送所有本地标签

# 删除标签
git tag -d v1.0                 # 本地
git push origin --delete v1.0  # 远程

# 基于标签创建分支
git checkout -b hotfix-v1.0 v1.0

git describe <ref>
# 输出：v1.0-5-gabc1234
#       │    │  │
#       │    │  └── hash 前缀（g = git）
#       │    └── 距离 tag 有 5 个提交
#       └── 最近的 tag

# 当 ref 正好是一个 tag 时，只输出 tag 名称
git describe HEAD
# → v2.0

# 创建新的 worktree
git worktree add ../project-hotfix hotfix
# 在 ../project-hotfix 目录中检出 hotfix 分支

# 创建并检出到新分支
git worktree add -b new-feature ../project-feature main

# 查看所有 worktree
git worktree list

# 删除 worktree
git worktree remove ../project-hotfix
# 或先手动删除目录，然后：
git worktree prune

# 添加子模块
git submodule add <url> <path>
git submodule add git@github.com:lib/common.git libs/common

# 克隆带子模块的仓库
git clone --recurse-submodules <url>
# 已克隆但忘加 --recurse-submodules 时：
git submodule update --init --recursive

# 更新子模块到最新提交
git submodule update --remote

# 查看子模块状态
git submodule status
git submodule foreach git status   # 在每个子模块中执行命令

# 添加外部仓库为子目录
git subtree add --prefix=libs/common <url> main --squash

# 拉取更新
git subtree pull --prefix=libs/common <url> main --squash

# 推送修改回上游
git subtree push --prefix=libs/common <url> main

# 客户端钩子（在 .git/hooks/ 下）

# 示例：pre-commit 钩子（自动 lint）
# .git/hooks/pre-commit
#!/bin/sh
npm run lint
if [ $? -ne 0 ]; then
    echo "Lint failed. Commit aborted."
    exit 1
fi

# 启用钩子（文件需要可执行权限）
chmod +x .git/hooks/pre-commit

# Husky（Node.js 项目）
npm install husky --save-dev
npx husky install
npx husky add .husky/pre-commit "npm run lint"
npx husky add .husky/commit-msg 'npx --no -- commitlint --edit $1'

# 分支被删除后，通过 reflog 找到其最后的 commit
git reflog
# 找到删除前该分支的 HEAD 位置
git branch recovered_branch <hash>

git reflog
# HEAD@{0}: reset: moving to HEAD~5  ← 误操作
# HEAD@{1}: commit: Important work   ← 丢失的重要提交
git reset --hard HEAD@{1}

# 场景：feature 分支基于 develop，现在要移到 main 上
# git rebase --onto <new-base> <upstream> <branch>

git rebase --onto main develop feature
# 将 feature 中不在 develop 上的提交，移植到 main 上

# 开启 rerere
git config --global rerere.enabled true

# 当解决完一次冲突后，Git 记录解决方案
# 下次遇到相同冲突时，自动应用记录的解

# 查看记录
git rerere status
git rerere diff

# 安装 Git LFS
git lfs install

# 追踪大文件
git lfs track "*.psd"
git lfs track "*.zip"
git lfs track "data/*.csv"

# 查看追踪模式
git lfs track

# .gitattributes 会被自动更新
# *.psd filter=lfs diff=lfs merge=lfs -text

# 之后像普通文件一样使用即可
git add file.psd
git commit -m "Add design file"
git push