Git 完整手册（中高级开发者版）

git status              # 工作区 vs 暂存区
git diff                # 工作区 vs 暂存区
git diff --cached       # 暂存区 vs 本地库
git diff HEAD           # 工作区 vs 最新提交

# 创建新提交时
git commit  # HEAD 和当前分支指针都移动到新提交

# 切换分支时
git switch feature  # HEAD 指向 feature 分支

# 合并分支时
git merge feature   # 可能创建新的合并提交

# 创建新仓库
git init [--initial-branch=main]

# 克隆现有仓库
git clone <url> [directory]
git clone --depth=1 <url>        # 浅克隆
git clone --filter=blob:none <url>  # 部分克隆

# 全局配置
git config --global user.name "Your Name"
git config --global user.email "your@email.com"
git config --global init.defaultBranch main

# 本地配置
git config user.name "Project Name"
git config user.email "project@email.com"

# 查看配置
git config --list
git config user.name

# 拉取策略
git config --global pull.rebase true
git config --global rebase.autoStash true
git config --global fetch.prune true

# 合并策略
git config --global merge.ff only
git config --global rerere.enabled true

# 行结尾处理
git config --global core.autocrlf input  # macOS/Linux
git config --global core.autocrlf true   # Windows

# 推送策略
git config --global push.default simple

git status                    # 详细状态
git status -sb               # 简短状态
git status --porcelain       # 机器可读格式

git diff                     # 工作区 vs 暂存区
git diff --cached            # 暂存区 vs 最新提交
git diff HEAD                # 工作区 vs 最新提交
git diff --name-only         # 只显示文件名
git diff --stat              # 统计信息

git log                      # 详细历史
git log --oneline            # 单行显示
git log --graph --oneline --decorate --all  # 图形化历史
git log --since="2 weeks ago"  # 时间过滤
git log --author="John"      # 作者过滤
git log --grep="fix"         # 提交信息过滤

git show <commit>            # 查看提交详情
git show <commit>:<file>     # 查看文件在特定提交的内容
git describe --tags          # 最近标签描述

git grep "pattern"           # 在工作区搜索
git grep -n "pattern"        # 显示行号
git log -S "pattern"         # 在提交历史中搜索

git add <file>               # 添加特定文件
git add .                    # 添加所有文件
git add -A                   # 添加所有文件（包括删除）
git add -p                   # 交互式添加（分块）
git add -u                   # 只添加已跟踪的文件

git rm <file>                # 删除文件并暂存
git rm --cached <file>       # 从暂存区移除，保留工作区文件
git mv <old> <new>           # 重命名文件（保持历史）

git restore <file>           # 从暂存区恢复工作区
git restore --staged <file>  # 从暂存区移除
git restore --source=HEAD <file>  # 从指定提交恢复

git commit -m "message"      # 提交并添加信息
git commit -am "message"     # 添加所有已跟踪文件并提交
git commit --amend           # 修改最后一次提交
git commit --amend -m "new message"  # 修改提交信息

git reset --soft HEAD~1     # 回退提交，保留暂存区和工作区
git reset --mixed HEAD~1    # 回退提交和暂存区，保留工作区（默认）
git reset --hard HEAD~1     # 回退所有更改（危险）
git reset <commit>          # 重置到指定提交

git revert <commit>          # 创建反向提交（安全）
git revert --no-commit <commit>  # 撤销但不提交
git revert -m 1 <merge-commit>   # 撤销合并提交

git reflog                   # 查看所有 HEAD 移动记录
git reflog show <branch>     # 查看特定分支的 reflog

git branch                   # 本地分支
git branch -r                # 远程分支
git branch -a                # 所有分支
git branch -vv               # 显示上游分支

git branch <name>            # 创建分支
git checkout -b <name>       # 创建并切换分支
git switch -c <name>         # 新命令：创建并切换

git checkout <branch>        # 切换分支
git switch <branch>          # 新命令：切换分支
git switch -                 # 切换到上一个分支

git branch -d <branch>       # 删除已合并的分支
git branch -D <branch>       # 强制删除分支
git push origin --delete <branch>  # 删除远程分支

git merge <branch>           # 合并分支
git merge --no-ff <branch>   # 强制创建合并提交
git merge --ff-only <branch> # 只允许快进合并
git merge --squash <branch>  # 压缩合并

git rebase <branch>          # 变基到指定分支
git rebase -i <commit>       # 交互式变基
git rebase --onto <newbase> <upstream> <branch>  # 变基到新基础
git rebase --continue        # 继续变基
git rebase --abort           # 中止变基

git remote -v                # 查看远程仓库
git remote add <name> <url>  # 添加远程仓库
git remote remove <name>     # 删除远程仓库
git remote set-url <name> <new-url>  # 修改远程 URL

git fetch                    # 获取默认远程仓库
git fetch <remote>           # 获取指定远程仓库
git fetch --all              # 获取所有远程仓库
git fetch --prune            # 清理已删除的远程分支

git pull                     # 拉取并合并
git pull --rebase            # 拉取并变基
git pull --ff-only           # 只允许快进

git push                     # 推送到默认远程仓库
git push <remote> <branch>   # 推送到指定分支
git push -u <remote> <branch>  # 设置上游分支
git push --force-with-lease  # 安全强制推送
git push --tags              # 推送标签

git stash                    # 暂存当前工作
git stash push -m "message"  # 带消息暂存
git stash list               # 查看暂存列表
git stash show stash@{0}     # 查看暂存内容
git stash apply stash@{0}    # 应用暂存
git stash pop stash@{0}      # 应用并删除暂存
git stash drop stash@{0}     # 删除暂存

git cherry-pick <commit>     # 拣选单个提交
git cherry-pick A..B         # 拣选提交范围
git cherry-pick --continue   # 继续拣选
git cherry-pick --abort      # 中止拣选

git bisect start             # 开始二分查找
git bisect bad               # 标记当前为坏提交
git bisect good <commit>     # 标记已知好提交
git bisect reset             # 结束二分查找

git blame <file>             # 查看每行最后修改人
git blame -L 10,50 <file>    # 查看指定行范围

git worktree add <path> <branch>  # 添加工作区
git worktree list                 # 列出工作区
git worktree remove <path>        # 删除工作区

git gc                       # 垃圾回收
git gc --aggressive          # 激进垃圾回收
git fsck                     # 检查对象完整性
git prune                    # 删除不可达对象

git repack -ad               # 重新打包对象
git count-objects -v         # 查看对象统计

git clean -f                 # 删除未跟踪文件
git clean -fd                # 删除未跟踪文件和目录
git clean -n                 # 预览清理操作

git sparse-checkout init --cone
git sparse-checkout set <dir1> <dir2>
git sparse-checkout disable

git tag                      # 列出标签
git tag -a v1.0.0 -m "message"  # 创建注释标签
git tag v1.0.0               # 创建轻量标签
git push --tags              # 推送所有标签
git tag -d v1.0.0            # 删除本地标签

git archive -o release.zip HEAD  # 导出归档
git archive --format=tar.gz HEAD > release.tar.gz

git format-patch <range>     # 生成补丁文件
git am *.patch               # 应用补丁
git apply <patch>            # 应用补丁（不创建提交）

git submodule add <url> <path>  # 添加子模块
git submodule update --init --recursive  # 更新子模块
git submodule deinit <path>     # 停用子模块

git fetch                     # 默认远程仓库所有分支
git fetch --all               # 所有远程仓库
git fetch origin main         # 只拉取 origin/main
git fetch --prune             # 清理已删除的远程分支
git fetch --tags              # 同步标签
git fetch --depth=1           # 浅抓取

git merge <branch>            # 基本合并
git merge --no-ff <branch>    # 强制创建合并提交
git merge --ff-only <branch>  # 只允许快进合并
git merge --squash <branch>   # 压缩合并
git merge -X ours <branch>    # 冲突时偏向当前分支
git merge -X theirs <branch>  # 冲突时偏向目标分支
git merge --abort             # 取消合并

# 推荐使用新命令
git switch <branch>           # 切换分支
git switch -c <branch>        # 创建并切换分支
git switch -                  # 切换到上一个分支

# 老命令（仍可用）
git checkout <branch>
git checkout -b <branch>

# 推荐使用新命令
git restore <file>            # 从暂存区恢复工作区
git restore --staged <file>   # 从暂存区移除
git restore --source=HEAD <file>  # 从指定提交恢复

# 老命令（仍可用）
git checkout -- <file>
git checkout HEAD -- <file>

git rebase <branch>           # 基本变基
git rebase -i <commit>        # 交互式变基
git rebase --onto <newbase> <upstream> <branch>  # 变基到新基础
git rebase --continue         # 继续变基
git rebase --abort            # 中止变基
git rebase --skip             # 跳过当前提交

# 1. 获取最新代码
git fetch origin
git rebase origin/main

# 2. 创建功能分支
git switch -c feature/new-feature

# 3. 开发并提交
git add .
git commit -m "feat: add new feature"

# 4. 推送分支
git push -u origin feature/new-feature

# 5. 创建 Pull Request
# （在 GitHub/GitLab 界面操作）

# 6. 合并后清理
git switch main
git pull origin main
git branch -d feature/new-feature
git push origin --delete feature/new-feature

# 1. 保存当前工作
git stash push -m "wip: current work"

# 2. 切换到主分支
git switch main
git pull origin main

# 3. 创建修复分支
git switch -c hotfix/urgent-fix

# 4. 修复并提交
# ... 修复代码 ...
git add .
git commit -m "fix: urgent bug fix"

# 5. 推送并合并
git push -u origin hotfix/urgent-fix
# 创建 PR 并合并

# 6. 恢复工作
git switch -
git stash pop

# 主分支
main                    # 生产环境
develop                 # 开发环境

# 功能分支
feature/user-auth       # 新功能
feature/payment-system

# 发布分支
release/v1.2.0          # 准备发布

# 热修复分支
hotfix/critical-bug     # 紧急修复

# 只有主分支
main

# 短期功能分支
feature/login-page      # 1-2 天完成
feature/api-integration # 3-5 天完成

# 所有功能都直接合并到 main

# 1. 尝试合并
git merge feature/login

# 2. 查看冲突文件
git status

# 3. 编辑冲突文件
# 手动解决冲突标记：
# <<<<<<< HEAD
# 当前分支内容
# =======
# 目标分支内容
# >>>>>>> feature/login

# 4. 标记已解决
git add <resolved-file>

# 5. 完成合并
git commit

# 1. 开始变基
git rebase main

# 2. 解决冲突
# 编辑冲突文件...

# 3. 标记已解决
git add <resolved-file>

# 4. 继续变基
git rebase --continue

# 5. 如果还有冲突，重复 2-4
# 6. 如果完成，变基结束

# 使用合并工具
git mergetool

# 配置合并工具
git config --global merge.tool vimdiff
git config --global mergetool.vimdiff.cmd 'vimdiff $LOCAL $MERGED $REMOTE'

# 修改提交信息
git commit --amend -m "new message"

# 添加文件到上次提交
git add forgotten-file.txt
git commit --amend --no-edit

# 修改最近 3 个提交
git rebase -i HEAD~3

# 在编辑器中：
# pick abc1234 old commit message
# reword def5678 another commit
# squash ghi9012 third commit

# 保存并退出，按提示操作

# 创建反向提交
git revert <bad-commit>

# 回退多个提交
git revert <old-commit>..<new-commit>

# 回退合并提交
git revert -m 1 <merge-commit>

# 软回退（保留更改）
git reset --soft HEAD~1

# 混合回退（默认）
git reset --mixed HEAD~1

# 硬回退（丢弃更改）
git reset --hard HEAD~1

# 方法1：先获取再合并
git fetch origin
git merge origin/main

# 方法2：先获取再变基
git fetch origin
git rebase origin/main

# 方法3：直接拉取
git pull origin main
git pull --rebase origin main

# 1. 获取远程更新
git fetch origin

# 2. 查看差异
git log HEAD..origin/main --oneline

# 3. 合并或变基
git merge origin/main
# 或
git rebase origin/main

# 4. 解决冲突（如果有）
# ... 解决冲突 ...

# 5. 推送更新
git push origin main

# 危险：可能覆盖他人工作
git push --force origin main

# 安全：检查远程是否有新提交
git push --force-with-lease origin main

# 更安全：指定要覆盖的提交
git push --force-with-lease=origin/main:abc1234 origin main

# 1. 保存当前工作
git stash push -m "emergency stash"

# 2. 切换到生产分支
git switch main
git pull origin main

# 3. 创建热修复分支
git switch -c hotfix/critical-security-fix

# 4. 快速修复
# ... 紧急修复代码 ...
git add .
git commit -m "hotfix: critical security vulnerability"

# 5. 立即推送
git push -u origin hotfix/critical-security-fix

# 6. 创建紧急 PR 并合并
# 7. 部署到生产环境
# 8. 恢复原工作
git switch -
git stash pop

# 如果修复有问题，立即回滚
git revert <hotfix-commit>
git push origin main

# 或者重置到修复前
git reset --hard <commit-before-hotfix>
git push --force-with-lease origin main

# 1. 确保分支是最新的
git fetch origin
git rebase origin/main

# 2. 整理提交历史
git rebase -i HEAD~3

# 3. 推送更新
git push --force-with-lease origin feature/review-ready

# 4. 创建 Pull Request

# 1. 获取反馈
git fetch origin
git switch feature/review-ready

# 2. 根据反馈修改
# ... 修改代码 ...

# 3. 提交修改
git add .
git commit -m "address review feedback"

# 4. 推送更新
git push origin feature/review-ready

# 5. 如果历史被重写
git push --force-with-lease origin feature/review-ready

# 1. 合并到主分支
git switch main
git merge feature/review-ready

# 2. 或者使用 squash 合并
git merge --squash feature/review-ready
git commit -m "feat: implement new feature"

# 3. 推送主分支
git push origin main

# 4. 清理分支
git branch -d feature/review-ready
git push origin --delete feature/review-ready

# 只克隆最近提交
git clone --depth=1 <url>

# 增加深度
git fetch --unshallow

# 浅克隆特定分支
git clone --depth=1 --branch=main <url>

# 不克隆文件内容
git clone --filter=blob:none <url>

# 不克隆大文件
git clone --filter=blob:limit=1m <url>

# 只克隆特定目录
git clone --filter=tree:0 <url>
git sparse-checkout init --cone
git sparse-checkout set src/ docs/

# 启用稀疏检出
git sparse-checkout init --cone

# 设置要检出的目录
git sparse-checkout set src/ tests/

# 添加更多目录
git sparse-checkout add docs/

# 禁用稀疏检出
git sparse-checkout disable

# 清理大文件
git filter-branch --tree-filter 'rm -f large-file.txt' HEAD

# 使用 filter-repo（推荐）
git filter-repo --path large-file.txt --invert-paths

# 清理引用
git for-each-ref --format="delete %(refname)" refs/original | git update-ref --stdin
git reflog expire --expire=now --all
git gc --prune=now --aggressive

# 开发新功能
git switch main
git pull origin main
git switch -c feature/quick-fix
# ... 开发 ...
git add .
git commit -m "feat: quick fix"
git push -u origin feature/quick-fix
# 创建 PR，快速合并

# 创建功能分支
git switch -c feature/new-feature
# ... 开发 ...
git push -u origin feature/new-feature
# 创建 PR，代码审查后合并

# 格式：<type>[optional scope]: <description>

# 类型
feat: 新功能
fix: 修复 bug
docs: 文档更新
style: 代码格式（不影响功能）
refactor: 重构
test: 测试相关
chore: 构建过程或辅助工具的变动

# 示例
git commit -m "feat(auth): add OAuth2 login"
git commit -m "fix(api): resolve timeout issue"
git commit -m "docs: update installation guide"

# 好的提交信息
git commit -m "feat: add user authentication system"
git commit -m "fix: resolve memory leak in image processing"
git commit -m "docs: update API documentation for v2.0"

# 避免的提交信息
git commit -m "fix"
git commit -m "update"
git commit -m "changes"

git commit -m "feat: add user authentication

- Implement OAuth2 integration
- Add JWT token management
- Update user model schema
- Add authentication middleware

Closes #123"

# 用户信息
git config --global user.name "Your Name"
git config --global user.email "your@email.com"

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

# 拉取策略
git config --global pull.rebase true
git config --global rebase.autoStash true

# 推送策略
git config --global push.default simple
git config --global push.autoSetupRemote true

# 合并策略
git config --global merge.ff only
git config --global rerere.enabled true

# 行结尾处理
git config --global core.autocrlf input
git config --global core.ignorecase false

# 凭证管理
git config --global credential.helper osxkeychain  # macOS
git config --global credential.helper manager-core  # Windows
git config --global credential.helper store         # Linux

# 别名配置
git config --global alias.st status
git config --global alias.co checkout
git config --global alias.br branch
git config --global alias.ci commit
git config --global alias.unstage 'reset HEAD --'
git config --global alias.last 'log -1 HEAD'
git config --global alias.visual '!gitk'

# 在项目根目录
git config user.name "Project Name"
git config user.email "project@company.com"
git config core.autocrlf false
git config merge.ours.driver true

git push origin main

git pull origin main
# 或
git fetch origin
git rebase origin/main

# 创建新分支
git switch -c new-branch

# 或切换到现有分支
git switch main

git merge --allow-unrelated-histories origin/main

git pull origin main
git push origin main

# 或强制推送（危险）
git push --force-with-lease origin main

# 暂存更改
git stash
git pull origin main
git stash pop

# 或提交更改
git add .
git commit -m "wip: save changes"
git pull origin main

# 查看所有操作历史
git reflog

# 恢复到特定操作
git reset --hard HEAD@{2}

# 恢复被删除的分支
git branch recover-branch <commit-hash>

# 从暂存区恢复
git checkout HEAD -- <file>

# 从特定提交恢复
git checkout <commit-hash> -- <file>

# 从其他分支恢复
git checkout <branch-name> -- <file>

# 1. 查看 reflog
git reflog

# 2. 找到分支的最后提交
git reflog | grep <branch-name>

# 3. 恢复分支
git branch <branch-name> <commit-hash>

# 1. 查看 reflog
git reflog

# 2. 找到提交的哈希
git reflog | grep <commit-message>

# 3. 恢复提交
git cherry-pick <commit-hash>

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

# 查看对象统计
git count-objects -vH

# 查看最大的文件
git rev-list --objects --all | git cat-file --batch-check='%(objecttype) %(objectname) %(objectsize) %(rest)' | sed -n 's/^blob //p' | sort --numeric-sort --key=2 | tail -10

# 查找大文件
git rev-list --objects --all | git cat-file --batch-check='%(objecttype) %(objectname) %(objectsize) %(rest)' | awk '/^blob/ {if ($3 > 1000000) print $3 " " $4}' | sort -nr

# 使用 filter-repo 清理
git filter-repo --strip-blobs-bigger-than 10M

# 垃圾回收
git gc --aggressive --prune=now

# 重新打包
git repack -Ad

# 清理引用
git for-each-ref --format="delete %(refname)" refs/original | git update-ref --stdin
git reflog expire --expire=now --all
git gc --prune=now

git fetch origin
git log HEAD..origin/main  # 查看远程更新
git merge origin/main      # 或 git rebase origin/main

# 已推送的提交用 revert
git revert <commit>

# 未推送的提交用 reset
git reset --soft HEAD~1    # 保留更改
git reset --mixed HEAD~1   # 保留工作区
git reset --hard HEAD~1    # 丢弃所有更改

git push --force-with-lease origin main

# 1. reflog 是救命稻草
git reflog

# 2. 开启 rerere 自动解决重复冲突
git config --global rerere.enabled true

# 3. 使用 --force-with-lease 安全强推
git push --force-with-lease origin main

# 4. 定期备份重要分支
git push origin <important-branch>

# 5. 使用 worktree 并行开发
git worktree add ../hotfix main

# 创建对象
echo "content" | git hash-object -w --stdin
git hash-object -w <file>

# 查看对象
git cat-file -t <object>     # 查看对象类型
git cat-file -p <object>     # 查看对象内容
git cat-file -s <object>     # 查看对象大小

# 列出树对象
git ls-tree <tree>
git ls-tree -r <tree>        # 递归列出

# 解析引用
git rev-parse HEAD
git rev-parse main
git rev-parse origin/main

# 更新引用
git update-ref refs/heads/new-branch <commit>

# 列出引用
git for-each-ref
git show-ref

# 更新索引
git update-index --add <file>
git update-index --remove <file>
git update-index --skip-worktree <file>

# 读取索引
git ls-files
git ls-files --stage

# 1. 创建文件内容
echo "Hello World" | git hash-object -w --stdin
# 输出：<blob-hash>

# 2. 创建树对象
git update-index --add --cacheinfo 100644 <blob-hash> hello.txt
git write-tree
# 输出：<tree-hash>

# 3. 创建提交对象
git commit-tree <tree-hash> -m "Initial commit"
# 输出：<commit-hash>

# 4. 更新分支引用
git update-ref refs/heads/main <commit-hash>

# 查看提交的树
git cat-file -p <commit> | grep tree

# 查看树的内容
git cat-file -p <tree-hash>

# 查看文件内容
git cat-file -p <blob-hash>

# pre-commit: 提交前检查
#!/bin/sh
# 运行测试
npm test
# 检查代码格式
npm run lint

# commit-msg: 检查提交信息
#!/bin/sh
# 检查提交信息格式
if ! grep -qE "^(feat|fix|docs|style|refactor|test|chore):" "$1"; then
    echo "Invalid commit message format"
    exit 1
fi

# pre-push: 推送前检查
#!/bin/sh
# 运行完整测试套件
npm run test:all

# pre-receive: 接收推送前
#!/bin/bash
# 检查分支保护
if [[ "$1" == "refs/heads/main" ]]; then
    echo "Direct push to main is not allowed"
    exit 1
fi

# update: 更新引用前
#!/bin/bash
# 检查提交权限
if [[ "$1" == "refs/heads/main" ]]; then
    # 检查用户权限
    if ! is_maintainer "$USER"; then
        echo "Only maintainers can push to main"
        exit 1
    fi
fi

# 复制 hook 脚本
cp pre-commit .git/hooks/
chmod +x .git/hooks/pre-commit

# 或使用工具管理
npm install --save-dev husky
npx husky install
npx husky add .husky/pre-commit "npm test"

# 不克隆文件内容
git clone --filter=blob:none <url>

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

# 不克隆树对象
git clone --filter=tree:0 <url>

# 组合过滤
git clone --filter=blob:none --filter=tree:0 <url>

# 启用稀疏检出
git sparse-checkout init --cone

# 设置要检出的目录
git sparse-checkout set src/ tests/

# 添加更多目录
git sparse-checkout add docs/

# 列出当前配置
git sparse-checkout list

# 禁用稀疏检出
git sparse-checkout disable

# 1. 浅克隆
git clone --depth=1 <url>

# 2. 部分克隆
git clone --filter=blob:none <url>

# 3. 稀疏检出
git sparse-checkout init --cone
git sparse-checkout set src/

# 4. 定期清理
git gc --aggressive --prune=now

# 用户信息
user.name = "Your Name"
user.email = "your@email.com"

# 默认分支
init.defaultBranch = main

# 行结尾处理
core.autocrlf = input
core.ignorecase = false
core.filemode = true

# 凭证管理
credential.helper = osxkeychain

# 拉取策略
pull.rebase = true
rebase.autoStash = true

# 获取配置
fetch.prune = true
fetch.pruneTags = true

# 推送策略
push.default = simple
push.autoSetupRemote = true
push.followTags = true

# 合并策略
merge.ff = only
merge.tool = vimdiff
rerere.enabled = true

# 常用别名
alias.st = status
alias.co = checkout
alias.br = branch
alias.ci = commit
alias.unstage = reset HEAD --
alias.last = log -1 HEAD
alias.visual = !gitk