Git 完整命令参考手册

git config [<scope>] [options] <key> [<value>]

# 设置用户名和邮箱
git config --global user.name "Your Name"
git config --global user.email "your@email.com"

# 查看所有配置及来源
git config --list --show-origin

# 设置默认编辑器
git config --global core.editor "vim"

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

# 配置别名
git config --global alias.co checkout
git config --global alias.br branch
git config --global alias.st status
git config --global alias.lg "log --oneline --graph --all"

# 删除配置项
git config --global --unset user.name

# 编辑全局配置文件
git config --global -e

# 设置换行符处理
git config --global core.autocrlf input

# 设置凭证缓存
git config --global credential.helper cache

git help [options] [<command>]

# 查看 commit 命令帮助
git help commit

# 列出所有命令
git help -a

# 在浏览器中打开帮助
git help -w merge

# 简短帮助
git commit -h

git clone [options] <repository> [<directory>]

# 基本克隆
git clone https://github.com/user/repo.git

# 克隆到指定目录
git clone https://github.com/user/repo.git my-folder

# 浅克隆（只获取最近1次提交，加速下载）
git clone --depth 1 https://github.com/user/repo.git

# 克隆指定分支
git clone --branch develop https://github.com/user/repo.git

# 克隆并初始化子模块
git clone --recurse-submodules https://github.com/user/repo.git

# 使用 SSH 克隆
git clone git@github.com:user/repo.git

# 部分克隆（不下载 blob，按需获取）
git clone --filter=blob:none https://github.com/user/repo.git

# 稀疏检出克隆
git clone --sparse https://github.com/user/repo.git

# 镜像克隆
git clone --mirror https://github.com/user/repo.git

git init [options] [<directory>]

# 在当前目录初始化
git init

# 在指定目录初始化
git init my-project

# 创建裸仓库
git init --bare my-project.git

# 指定初始分支名为 main
git init -b main

# 使用 SHA-256
git init --object-format=sha256

git add [options] [<pathspec>...]

# 添加单个文件
git add file.txt

# 添加所有更改
git add -A

# 添加当前目录下所有更改
git add .

# 交互式选择暂存内容
git add -p

# 强制添加被忽略的文件
git add -f build/output.log

# 标记新文件（稍后再暂存内容）
git add -N new_file.txt

# 模拟运行
git add -n .

git commit [options] [--] [<pathspec>...]

# 基本提交
git commit -m "feat: add login feature"

# 暂存并提交所有已跟踪文件
git commit -am "fix: resolve crash issue"

# 修改最近一次提交
git commit --amend -m "updated commit message"

# 修改最近一次提交但不改信息
git commit --amend --no-edit

# 空提交（常用于触发 CI）
git commit --allow-empty -m "trigger build"

# 跳过钩子
git commit -n -m "wip: quick save"

# 创建 fixup 提交
git commit --fixup=abc1234

# 签名提交
git commit -S -m "signed commit"

# 指定作者
git commit --author="Name <email>" -m "message"

git status [options] [--] [<pathspec>...]

# 查看状态
git status

# 简洁模式
git status -s

# 显示分支信息的简洁模式
git status -sb

# 显示被忽略的文件
git status --ignored

# 显示 stash 数量
git status --show-stash

# 详细模式（显示差异）
git status -v

git rm [options] [--] <file>...

# 删除文件
git rm file.txt

# 只从 Git 跟踪中移除，保留本地文件
git rm --cached file.txt

# 递归删除目录
git rm -r folder/

# 停止跟踪某类文件
git rm --cached "*.log"

git mv [options] <source> <destination>

# 重命名文件
git mv old_name.txt new_name.txt

# 移动文件到子目录
git mv file.txt src/file.txt

# 强制移动
git mv -f source.txt destination.txt

git notes [<subcommand>] [options]

# 给当前提交添加注释
git notes add -m "This needs review"

# 给指定提交添加注释
git notes add -m "Bug introduced here" abc1234

# 查看注释
git notes show

# 删除注释
git notes remove abc1234

git branch [options] [<branch-name>] [<start-point>]

# 列出本地分支
git branch

# 列出所有分支
git branch -a

# 显示当前分支名
git branch --show-current

# 创建新分支
git branch feature/login

# 删除分支
git branch -d feature/login

# 强制删除未合并的分支
git branch -D feature/login

# 重命名当前分支
git branch -m new-name

# 查看分支详细信息（含上游）
git branch -vv

# 查看已合并的分支
git branch --merged

# 设置上游分支
git branch -u origin/main

# 按提交日期排序
git branch --sort=-committerdate

git switch [options] <branch>

# 切换分支
git switch main

# 创建并切换
git switch -c feature/new-feature

# 切换到上一个分支
git switch -

# 分离 HEAD
git switch --detach v1.0.0

# 创建孤立分支
git switch --orphan gh-pages

git checkout [options] <branch>
git checkout [options] [<tree-ish>] -- <pathspec>...

# 切换分支
git checkout develop

# 创建并切换到新分支
git checkout -b feature/new-feature

# 从指定分支创建新分支
git checkout -b feature/new origin/develop

# 恢复单个文件到最近提交的状态
git checkout -- file.txt

# 从指定提交恢复文件
git checkout abc1234 -- file.txt

# 创建孤立分支
git checkout --orphan gh-pages

git restore [options] [--] <pathspec>...

# 丢弃工作区的修改
git restore file.txt

# 取消暂存（撤销 git add）
git restore --staged file.txt

# 从指定提交恢复文件
git restore --source=HEAD~2 file.txt

# 同时恢复工作区和暂存区
git restore --staged --worktree file.txt

# 交互式恢复
git restore -p file.txt

git push [options] [<remote>] [<refspec>...]

# 推送当前分支
git push

# 首次推送并设置上游
git push -u origin main

# 安全的强制推送（推荐）
git push --force-with-lease origin main

# 删除远程分支
git push origin --delete feature/old-branch
git push origin :feature/old-branch  # 简写

# 推送所有标签
git push --tags

# 原子推送
git push --atomic origin main feature

git pull [options] [<remote>] [<refspec>...]

# 拉取并合并
git pull

# 拉取并变基
git pull --rebase

# 拉取指定远程分支
git pull origin develop

# 只允许快进合并
git pull --ff-only

# 自动暂存本地修改后拉取
git pull --autostash --rebase

# 允许合并无关历史
git pull --allow-unrelated-histories origin main

git fetch [options] [<remote>] [<refspec>...]

# 获取默认远程仓库的更新
git fetch

# 获取所有远程仓库
git fetch --all

# 获取并清理无效引用
git fetch --prune

# 获取指定远程仓库
git fetch upstream

# 获取指定分支
git fetch origin main

git remote [options]
git remote <subcommand> [options]

# 查看远程仓库
git remote -v

# 添加远程仓库
git remote add origin https://github.com/user/repo.git
git remote add upstream https://github.com/original/repo.git

# 修改远程 URL
git remote set-url origin git@github.com:user/repo.git

# 查看远程仓库详情
git remote show origin

# 删除远程仓库
git remote remove upstream

# 重命名远程仓库
git remote rename origin main-remote

# 清理无效的远程分支引用
git remote prune origin

git merge [options] [<commit>...]

# 合并分支
git merge feature/login

# 禁止快进合并
git merge --no-ff feature/login

# 压缩合并
git merge --squash feature/login

# 中止合并
git merge --abort

# 使用 theirs 策略解决冲突
git merge -X theirs feature/login

# 合并但不自动提交
git merge --no-commit feature/login

# 允许合并无关历史
git merge --allow-unrelated-histories other-repo/main

git rebase [options] [<upstream> [<branch>]]
git rebase [options] --onto <newbase> [<upstream> [<branch>]]

# 变基到 main 分支
git rebase main

# 交互式变基最近 3 个提交
git rebase -i HEAD~3

# 变基到指定提交
git rebase --onto main feature/base feature/current

# 中止变基
git rebase --abort

# 解决冲突后继续
git rebase --continue

# 自动暂存后变基
git rebase --autostash main

# 每个提交后运行测试
git rebase -i --exec "npm test" HEAD~5

# 自动更新相关分支引用
git rebase --update-refs main

git cherry-pick [options] <commit>...

# 应用单个提交
git cherry-pick abc1234

# 应用多个提交
git cherry-pick abc1234 def5678

# 应用一个范围的提交（不含起始提交）
git cherry-pick abc1234..def5678

# 应用但不自动提交
git cherry-pick -n abc1234

# 记录原始 hash
git cherry-pick -x abc1234

# 中止 cherry-pick
git cherry-pick --abort

git log [options] [<revision-range>] [-- <path>...]

# 简洁日志
git log --oneline

# 图形化显示所有分支
git log --oneline --graph --all

# 最近 5 次提交
git log -5

# 显示文件修改统计
git log --stat

# 按作者过滤
git log --author="John"

# 按日期范围
git log --since="2024-01-01" --until="2024-12-31"

# 按提交信息搜索
git log --grep="fix"

# 查看某个文件的历史（跟踪重命名）
git log --follow -- file.txt

# 自定义格式
git log --pretty=format:"%h %Cgreen%an%Creset %s" --date=short

# 搜索添加了某字符串的提交
git log -S "function_name"

# 查看文件指定行范围的历史
git log -L 10,20:file.txt

# 反转输出顺序
git log --reverse --oneline

git diff [options] [<commit>] [--] [<path>...]
git diff [options] <commit> <commit> [--] [<path>...]
git diff [options] --cached [<commit>] [--] [<path>...]

# 查看工作区与暂存区的差异
git diff

# 查看暂存区与最近提交的差异
git diff --staged

# 比较两个分支
git diff main..develop

# 比较两个提交
git diff abc1234..def5678

# 只看文件名
git diff --name-only

# 查看某个文件的差异
git diff -- file.txt

# 忽略空白变化
git diff -w

# 查看统计信息
git diff --stat

# 使用 patience 算法
git diff --patience

# 按单词显示差异
git diff --word-diff

git show [options] [<object>...]

# 查看最近一次提交
git show

# 查看指定提交
git show abc1234

# 查看某个提交中的某个文件
git show abc1234:file.txt

# 查看标签信息
git show v1.0.0

# 只看统计信息
git show --stat

# 不显示差异
git show -s abc1234

git blame [options] [<rev>] [--] <file>

# 查看文件每行的修改信息
git blame file.txt

# 查看指定行范围
git blame -L 10,20 file.txt

# 显示邮箱
git blame -e file.txt

# 忽略空白变化
git blame -w file.txt

# 检测代码移动和复制
git blame -M -C file.txt

# 查看指定函数
git blame -L :myFunction file.txt

git shortlog [options] [<revision-range>] [-- <path>...]

# 按作者汇总
git shortlog

# 按提交数量排序
git shortlog -sn

# 显示邮箱
git shortlog -sne

# 按 trailer 分组
git shortlog --group=trailer:co-authored-by

git describe [options] [<commit-ish>...]

# 描述当前提交
git describe

# 使用所有标签
git describe --tags

# 始终输出（即使没有标签）
git describe --always

# 检查是否有未提交的修改
git describe --dirty

git reset [<mode>] [<commit>]
git reset [options] [--] <pathspec>...

# 取消暂存（保留修改）
git reset HEAD file.txt

# 回退到上一个提交（保留修改在暂存区）
git reset --soft HEAD~1

# 回退到上一个提交（保留修改但取消暂存）
git reset HEAD~1

# 回退到上一个提交（丢弃所有修改，谨慎使用）
git reset --hard HEAD~1

# 回退到指定提交
git reset --hard abc1234

# 交互式重置
git reset -p

git revert [options] <commit>...

# 撤销指定提交
git revert abc1234

# 撤销但不自动提交
git revert --no-commit abc1234

# 撤销合并提交（保留主线 1）
git revert -m 1 abc1234

# 撤销多个提交
git revert abc1234..def5678

# 中止 revert
git revert --abort

git reflog [show] [options] [<ref>]
git reflog expire [options]
git reflog delete [options] <ref>@{<specifier>}

# 查看 HEAD 的引用日志
git reflog

# 查看指定分支的引用日志
git reflog show main

# 限制显示数量
git reflog -10

# 恢复误删的提交
git reflog  # 找到目标 commit hash
git reset --hard HEAD@{2}  # 恢复到指定状态

# 清理过期的 reflog
git reflog expire --expire=30.days --all

git clean [options] [--] [<pathspec>...]

# 预览将被删除的文件
git clean -dn

# 删除未跟踪的文件和目录
git clean -df

# 删除所有未跟踪文件（包括被忽略的）
git clean -dfx

# 只删除被忽略的文件
git clean -dfX

# 交互式删除
git clean -di

# 排除某些文件
git clean -df -e "*.config"

git stash [push] [options] [--] [<pathspec>...]
git stash <subcommand> [options]

# 保存当前修改
git stash

# 保存并添加描述
git stash push -m "work in progress: login feature"

# 包含未跟踪文件
git stash -u

# 只 stash 暂存区的内容
git stash push --staged

# 查看所有 stash
git stash list

# 恢复最近的 stash
git stash pop

# 恢复指定的 stash
git stash apply stash@{2}

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

# 删除指定 stash
git stash drop stash@{1}

# 清除所有 stash
git stash clear

# 从 stash 创建分支
git stash branch new-branch stash@{0}

# 交互式选择要 stash 的内容
git stash push -p

git tag [options] [<tagname>] [<commit>]

# 列出所有标签
git tag

# 列出匹配的标签
git tag -l "v1.*"

# 创建轻量标签
git tag v1.0.0

# 创建附注标签
git tag -a v1.0.0 -m "Release version 1.0.0"

# 给历史提交打标签
git tag -a v0.9.0 abc1234 -m "Beta release"

# 删除本地标签
git tag -d v1.0.0

# 删除远程标签
git push origin --delete v1.0.0

# 推送标签到远程
git push origin v1.0.0
git push origin --tags

# 按版本号排序
git tag --sort=-v:refname

# 验证签名标签
git tag -v v1.0.0

git submodule [<command>] [options]

# 添加子模块
git submodule add https://github.com/user/lib.git Libraries/lib

# 克隆后初始化并更新子模块
git submodule update --init --recursive

# 更新子模块到远程最新
git submodule update --remote

# 查看子模块状态
git submodule status

# 对所有子模块执行命令
git submodule foreach git pull origin main

# 对所有子模块递归执行
git submodule foreach --recursive git fetch

# 删除子模块
git submodule deinit Libraries/lib
git rm Libraries/lib

# 设置子模块跟踪分支
git submodule set-branch -b main Libraries/lib

git subtree <command> [options] <prefix>

# 添加子树
git subtree add --prefix=lib https://github.com/user/lib.git main --squash

# 拉取子树更新
git subtree pull --prefix=lib https://github.com/user/lib.git main --squash

# 推送子树更改
git subtree push --prefix=lib https://github.com/user/lib.git main

# 拆分子目录
git subtree split --prefix=lib -b lib-branch

git grep [options] <pattern> [<tree>] [-- <pathspec>...]