Git 常用操作命令速查手册

二、基础操作

# 初始化一个新的 Git 仓库
git init
# 初始化并指定仓库名称
git init <project-name>
# 初始化裸仓库（用于作为远程仓库）
git init --bare
# 克隆远程仓库
git clone <repository-url>
# 克隆到指定目录
git clone <repository-url> <directory-name>
# 克隆指定分支
git clone -b <branch-name> <repository-url>
# 浅克隆（只克隆最近的提交历史，节省空间和时间）
git clone --depth=1 <repository-url>
# 查看工作区状态
git status
# 查看状态简洁输出
git status -s
# 添加文件到暂存区
git add <file>
# 添加多个文件
git add <file1> <file2> <file3>
# 添加当前目录所有文件
git add .
# 添加所有文件（包括删除的）
git add -A
# 添加所有已跟踪文件的修改
git add -u
# 交互式添加（选择性添加部分修改）
git add -p
# 提交到本地仓库
git commit -m "提交信息"
# 提交并显示详细差异
git commit -v
# 修改最后一次提交（追加修改）
git commit --amend
# 修改最后一次提交信息
git commit --amend -m "新的提交信息"
# 跳过暂存区直接提交（只针对已跟踪文件）
git commit -am "提交信息"
# 允许空提交（没有任何变更）
git commit --allow-empty -m "空提交"
# 查看工作区与暂存区的差异
git diff
# 查看暂存区与最后一次提交的差异
git diff --cached
# 或 git diff --staged
# 查看工作区与最后一次提交的差异
git diff HEAD
# 查看两个提交之间的差异
git diff <commit1> <commit2>
# 查看某个文件的差异
git diff <file>
# 查看差异统计
git diff --stat
# 删除文件（从工作区和暂存区删除）
git rm <file>
# 只从暂存区删除，保留工作区文件
git rm --cached <file>
# 强制删除（文件有未提交的修改）
git rm -f <file>
# 移动或重命名文件
git mv <old-file> <new-file>
# 查看 Git 命令历史
git reflog
# 查看帮助
git help <command>
# 或 git <command> --help

三、远程仓库操作

# 查看远程仓库列表
git remote
# 查看远程仓库详细信息
git remote -v
# 添加远程仓库
git remote add <remote-name> <repository-url>
# 添加 origin 远程仓库（最常用）
git remote add origin <repository-url>
# 查看某个远程仓库详细信息
git remote show <remote-name>
# 重命名远程仓库
git remote rename <old-name> <new-name>
# 移除远程仓库
git remote remove <remote-name>
# 或 git remote rm <remote-name>
# 修改远程仓库 URL
git remote set-url <remote-name> <new-url>
# 从远程仓库获取数据（不合并）
git fetch <remote-name>
# 获取所有远程仓库的数据
git fetch --all
# 获取指定分支
git fetch <remote-name> <branch-name>
# 从远程仓库拉取并合并到当前分支
git pull <remote-name> <branch-name>
# 拉取当前分支对应的远程分支
git pull
# 使用 rebase 方式拉取（避免合并提交）
git pull --rebase
# 推送到远程仓库
git push <remote-name> <branch-name>
# 推送当前分支到 origin
git push origin <current-branch>
# 推送所有分支
git push --all
# 推送标签
git push --tags
# 推送指定标签
git push origin <tag-name>
# 强制推送（危险操作，会覆盖远程历史）
git push -f
# 或 git push --force
# 更安全的强制推送（不会覆盖他人的提交）
git push --force-with-lease
# 删除远程分支
git push <remote-name> --delete <branch-name>
# 或 git push <remote-name> :<branch-name>
# 设置本地分支跟踪远程分支
git branch --set-upstream-to=<remote-name>/<branch-name>
# 或 git branch -u <remote-name>/<branch-name>
# 推送并设置上游分支
git push -u <remote-name> <branch-name>
# 查看本地分支与远程分支的关联
git branch -vv

四、分支管理操作

# 查看本地分支
git branch
# 查看所有分支（包括远程）
git branch -a
# 查看远程分支
git branch -r
# 查看分支详细信息（包括最后一次提交）
git branch -v
# 查看分支及其跟踪关系
git branch -vv
# 创建新分支
git branch <branch-name>
# 创建并切换到新分支
git checkout -b <branch-name>
# 或（Git 2.23+）
git switch -c <branch-name>
# 从指定提交创建分支
git branch <branch-name> <commit-hash>
# 从远程分支创建本地分支
git checkout -b <local-branch> <remote-name>/<remote-branch>
# 切换分支
git checkout <branch-name>
# 或（Git 2.23+，推荐）
git switch <branch-name>
# 切换到上一个分支
git checkout -
# 或 git switch -
# 创建并切换到孤儿分支（没有历史记录）
git checkout --orphan <branch-name>
# 合并分支到当前分支
git merge <branch-name>
# 不使用快进合并（保留分支历史）
git merge --no-ff <branch-name>
# 仅在可以快进合并时才合并
git merge --ff-only <branch-name>
# 合并时压缩提交（所有提交合并为一个）
git merge --squash <branch-name>
# 中止合并（解决冲突时）
git merge --abort
# 变基操作（将当前分支变基到目标分支）
git rebase <branch-name>
# 交互式变基（可以修改、合并、删除提交）
git rebase -i <commit-hash>
# 交互式变基最近 N 个提交
git rebase -i HEAD~N
# 继续变基（解决冲突后）
git rebase --continue
# 跳过当前冲突的提交
git rebase --skip
# 中止变基
git rebase --abort
# 删除分支（已合并的分支）
git branch -d <branch-name>
# 强制删除分支（未合并的分支）
git branch -D <branch-name>
# 删除远程分支
git push origin --delete <branch-name>
# 重命名当前分支
git branch -m <new-branch-name>
# 重命名指定分支
git branch -m <old-branch-name> <new-branch-name>
# 查看已合并到当前分支的分支
git branch --merged
# 查看未合并到当前分支的分支
git branch --no-merged
# 清理已删除的远程分支引用
git remote prune origin
# 或 git fetch -p

五、撤销操作

# 撤销工作区的修改（恢复到最后一次提交）
git checkout -- <file>
# 或（Git 2.23+）
git restore <file>
# 撤销工作区所有修改
git checkout .
# 或 git restore .
# 取消暂存（将文件从暂存区移回工作区）
git reset HEAD <file>
# 或（Git 2.23+）
git restore --staged <file>
# 取消所有暂存
git reset HEAD
# 重置到指定提交（保留工作区和暂存区的修改）
git reset --soft <commit-hash>
# 重置到指定提交（保留工作区的修改，清空暂存区）
git reset --mixed <commit-hash>
# 或 git reset <commit-hash>
# 重置到指定提交（清空工作区和暂存区，完全回退）
git reset --hard <commit-hash>
# 重置到上一个提交
git reset --hard HEAD^
# 重置到上 N 个提交
git reset --hard HEAD~N
# 重置到远程分支状态
git reset --hard origin/<branch-name>
# 恢复某个文件到指定提交状态
git checkout <commit-hash> -- <file>
# 撤销某次提交（生成新的提交来撤销）
git revert <commit-hash>
# 撤销多个提交
git revert <commit-hash1> <commit-hash2>
# 撤销最近的提交
git revert HEAD
# 撤销合并提交（需要指定父提交）
git revert -m 1 <merge-commit-hash>
# 继续撤销（解决冲突后）
git revert --continue
# 中止撤销
git revert --abort
# 清理未跟踪的文件（查看将被删除的文件）
git clean -n
# 删除未跟踪的文件
git clean -f
# 删除未跟踪的文件和目录
git clean -fd
# 删除未跟踪和已忽略的文件
git clean -fx
# 交互式清理
git clean -i
# 暂存当前工作区（保存临时修改）
git stash
# 暂存并添加说明
git stash save "说明信息"
# 暂存包括未跟踪的文件
git stash -u
# 暂存包括被忽略的文件
git stash -a
# 查看暂存列表
git stash list
# 应用最近的暂存（不删除）
git stash apply
# 应用指定的暂存
git stash apply stash@{n}
# 应用并删除最近的暂存
git stash pop
# 查看暂存的差异
git stash show
# 查看详细差异
git stash show -p
# 删除最近的暂存
git stash drop
# 删除指定的暂存
git stash drop stash@{n}
# 清空所有暂存
git stash clear
# 从暂存创建分支
git stash branch <branch-name>

六、日志与查询操作

# 查看提交历史
git log
# 单行显示提交历史
git log --oneline
# 显示最近 N 条提交
git log -n <number>
# 例如：git log -5
# 显示详细的修改内容
git log -p
# 显示统计信息
git log --stat
# 显示简短统计
git log --shortstat
# 图形化显示分支合并历史
git log --graph
# 美化的图形化日志
git log --graph --oneline --decorate --all
# 自定义日志格式
git log --pretty=format:"%h - %an, %ar : %s"
# 按作者过滤
git log --author="作者名"
# 按提交信息过滤
git log --grep="关键词"
# 按日期过滤（在某个日期之后）
git log --since="2024-01-01"
# 或 git log --after="2024-01-01"
# 按日期过滤（在某个日期之前）
git log --until="2024-12-31"
# 或 git log --before="2024-12-31"
# 相对时间过滤
git log --since="2 weeks ago"
git log --since="3 days ago"
# 查看某个文件的提交历史
git log <file>
# 查看某个文件的详细修改历史
git log -p <file>
# 查看文件的每一行是谁修改的
git blame <file>
# 查看文件指定行的修改历史
git blame -L <start>,<end> <file>
# 显示简短的 blame 信息
git blame -s <file>
# 查看某次提交的详细信息
git show <commit-hash>
# 查看某次提交的文件列表
git show --name-only <commit-hash>
# 查看某次提交的统计信息
git show --stat <commit-hash>
# 查看某次提交的某个文件
git show <commit-hash>:<file>
# 搜索代码内容
git grep "搜索内容"
# 显示行号
git grep -n "搜索内容"
# 显示匹配数量
git grep -c "搜索内容"
# 在指定提交中搜索
git grep "搜索内容" <commit-hash>
# 查看两个提交之间的差异文件列表
git diff --name-only <commit1> <commit2>
# 查看两个分支之间的差异
git diff <branch1> <branch2>
# 查看提交数量统计
git shortlog
# 按提交数量排序
git shortlog -sn
# 查看某个作者的贡献统计
git shortlog --author="作者名"
# 查看引用日志（操作历史）
git reflog
# 查看指定分支的引用日志
git reflog <branch-name>
# 查看所有引用
git show-ref
# 查看文件树对象
git ls-tree <commit-hash>
# 递归查看文件树
git ls-tree -r <commit-hash>
# 查看对象类型
git cat-file -t <object-hash>
# 查看对象内容
git cat-file -p <object-hash>

七、标签管理操作

# 查看所有标签
git tag
# 查看标签详细信息
git tag -l
# 搜索标签（支持通配符）
git tag -l "v1.0.*"
# 创建轻量标签（只是一个提交的引用）
git tag <tag-name>
# 在指定提交上创建标签
git tag <tag-name> <commit-hash>
# 创建附注标签（包含标签信息）
git tag -a <tag-name> -m "标签说明"
# 在指定提交上创建附注标签
git tag -a <tag-name> <commit-hash> -m "标签说明"
# 查看标签信息
git show <tag-name>
# 推送标签到远程
git push origin <tag-name>
# 推送所有标签
git push origin --tags
# 推送所有标签（包括轻量标签和附注标签）
git push --follow-tags
# 删除本地标签
git tag -d <tag-name>
# 删除远程标签
git push origin --delete <tag-name>
# 或 git push origin :refs/tags/<tag-name>
# 检出标签（创建一个分离头指针状态）
git checkout <tag-name>
# 从标签创建分支
git checkout -b <branch-name> <tag-name>
# 验证标签签名（GPG 签名的标签）
git tag -v <tag-name>
# 创建 GPG 签名标签
git tag -s <tag-name> -m "标签说明"

八、高级操作

# 拣选提交（将某个提交应用到当前分支）
git cherry-pick <commit-hash>
# 拣选多个提交
git cherry-pick <commit-hash1> <commit-hash2>
# 拣选提交范围
git cherry-pick <start-commit>..<end-commit>
# 拣选但不自动提交
git cherry-pick -n <commit-hash>
# 继续拣选（解决冲突后）
git cherry-pick --continue
# 中止拣选
git cherry-pick --abort
# 创建补丁文件
git format-patch <commit-hash>
# 创建最近 N 个提交的补丁
git format-patch -n <number>
# 创建两个提交之间的补丁
git format-patch <start-commit>..<end-commit>
# 应用补丁
git apply <patch-file>
# 应用补丁并检查
git apply --check <patch-file>
# 应用 Git 格式的补丁（包含提交信息）
git am <patch-file>
# 创建存档（导出项目）
git archive --format=zip --output=project.zip HEAD
# 导出指定分支
git archive --format=tar --output=project.tar <branch-name>
# 打包仓库（用于备份或迁移）
git bundle create <file.bundle> --all
# 从打包文件克隆
git clone <file.bundle> <directory>
# 验证打包文件
git bundle verify <file.bundle>
# 查看仓库大小
git count-objects -vH
# 垃圾回收（优化仓库）
git gc
# 激进的垃圾回收
git gc --aggressive --prune=now
# 检查仓库完整性
git fsck
# 详细检查
git fsck --full
# 查找丢失的对象
git fsck --lost-found
# 找回删除的分支或提交
git reflog
git checkout <commit-hash>
git branch <new-branch-name>
# 二分查找（查找引入 bug 的提交）
git bisect start
git bisect bad
# 标记当前提交为坏的
git bisect good <commit-hash>
# 标记某个提交为好的
# Git 会自动切换到中间的提交，测试后标记
git bisect good
# 或 git bisect bad
# 重复直到找到问题提交
git bisect reset
# 结束查找
# 自动化二分查找
git bisect start
git bisect bad HEAD
git bisect good <commit-hash>
git bisect run <test-script>
# 子树合并
git read-tree --prefix=<directory>/ -u <branch-name>
# 子树拉取更新
git pull -s subtree <remote-name> <branch-name>
# 重写历史（危险操作）
git filter-branch --tree-filter '<command>' HEAD
# 从历史中删除文件
git filter-branch --tree-filter 'rm -f <file>' HEAD
# 使用 filter-repo 工具（推荐，比 filter-branch 更快）
git filter-repo --path <file> --invert-paths
# 修改提交者信息
git filter-branch --env-filter ' if [ "$GIT_COMMITTER_EMAIL" = "[email protected]" ]; then export GIT_COMMITTER_EMAIL="[email protected]" fi' HEAD
# 查看工作树
git worktree list
# 添加新的工作树
git worktree add <path> <branch-name>
# 删除工作树
git worktree remove <path>
# 清理工作树
git worktree prune
# 浅克隆转完整克隆
git fetch --unshallow
# 稀疏检出（只检出部分文件）
git sparse-checkout init
git sparse-checkout set <directory>
# 禁用稀疏检出
git sparse-checkout disable

九、子模块管理操作

# 添加子模块
git submodule add <repository-url> <path>
# 初始化子模块配置
git submodule init
# 更新子模块（克隆子模块内容）
git submodule update
# 初始化并更新所有子模块
git submodule update --init
# 递归初始化和更新（包括子模块的子模块）
git submodule update --init --recursive
# 克隆包含子模块的仓库
git clone --recursive <repository-url>
# 已克隆仓库后初始化子模块
git submodule update --init --recursive
# 查看子模块状态
git submodule status
# 查看子模块状态（递归）
git submodule status --recursive
# 更新子模块到最新提交
git submodule update --remote
# 更新指定子模块
git submodule update --remote <submodule-name>
# 进入子模块目录
cd <submodule-directory>
# 在子模块中切换分支
cd <submodule-directory> git checkout <branch-name>
# 批量对所有子模块执行命令
git submodule foreach '<command>'
# 例如：拉取所有子模块的更新
git submodule foreach 'git pull origin main'
# 递归执行命令
git submodule foreach --recursive '<command>'
# 删除子模块（分几步）
# 1. 从 .gitmodules 中删除子模块配置
git submodule deinit <submodule-path>
# 2. 从 Git 仓库中删除子模块
git rm <submodule-path>
# 3. 提交更改
git commit -m "删除子模块"
# 4. 删除 .git/modules 中的子模块目录（可选）
rm -rf .git/modules/<submodule-path>
# 查看子模块配置
cat .gitmodules
# 同步子模块 URL（从 .gitmodules 更新到 .git/config）
git submodule sync
# 递归同步
git submodule sync --recursive
# 查看子模块的修改摘要
git diff --submodule
# 配置默认显示子模块差异
git config --global diff.submodule log
# 在父仓库中查看子模块的日志
git log -p --submodule

十、.gitignore 文件管理

# .gitignore 文件示例
# 忽略所有 .log 文件
*.log
# 忽略所有 .tmp 文件
*.tmp
# 忽略 node_modules 目录
node_modules/
# 忽略 build 目录
build/
dist/
# 忽略所有 .env 文件
.env
.env.local
# 忽略 IDE 配置文件
.vscode/
.idea/
*.swp
*.swo
# 忽略 macOS 系统文件
.DS_Store
# 忽略 Windows 系统文件
Thumbs.db
# 但不忽略某个特定文件
!important.log
# 忽略当前目录下的 TODO 文件（不包括子目录）
/TODO
# 忽略所有目录下的 TODO 文件
TODO
# 检查文件是否被忽略
git check-ignore <file>
# 查看为什么文件被忽略
git check-ignore -v <file>
# 强制添加被忽略的文件
git add -f <file>
# 清除已跟踪但现在被忽略的文件缓存
git rm -r --cached .
git add .
git commit -m "应用 .gitignore 规则"

十一、钩子（Hooks）操作

# 钩子文件位置
.git/hooks/
# 常用钩子脚本示例：
# pre-commit（提交前执行）
# 文件：.git/hooks/pre-commit
#!/bin/sh
# 运行代码检查
npm run lint
# commit-msg（提交信息验证）
# 文件：.git/hooks/commit-msg
#!/bin/sh
# 验证提交信息格式
commit_msg=$(cat "$1")
if ! echo "$commit_msg" | grep -qE "^(feat|fix|docs|style|refactor|test|chore):"; then
    echo "错误：提交信息必须以 feat:, fix:, docs: 等开头"
    exit 1
fi
# pre-push（推送前执行）
# 文件：.git/hooks/pre-push
#!/bin/sh
# 运行测试
npm test
# post-checkout（检出后执行）
# 文件：.git/hooks/post-checkout
#!/bin/sh
# 自动安装依赖
npm install
# 使钩子脚本可执行
chmod +x .git/hooks/pre-commit
# 列出所有可用的钩子
ls .git/hooks/
# 使用工具管理钩子（如 husky）
npm install husky -D
npx husky install

十二、Git 别名与自动化

# 常用别名配置
# 状态简写
git config --global alias.st status
# 检出简写
git config --global alias.co checkout
# 提交简写
git config --global alias.ci commit
# 分支简写
git config --global alias.br branch
# 美化日志
git config --global alias.lg "log --graph --pretty=format:'%Cred%h%Creset -%C(yellow)%d%Creset %s %Cgreen(%cr) %C(bold blue)<%an>%Creset' --abbrev-commit --date=relative"
# 查看最后一次提交
git config --global alias.last 'log -1 HEAD'
# 撤销最后一次提交（保留修改）
git config --global alias.undo 'reset HEAD~1 --mixed'
# 修改最后一次提交
git config --global alias.amend 'commit --amend'
# 查看所有别名
git config --get-regexp alias
# 列出所有未跟踪文件
git config --global alias.untracked 'ls-files --others --exclude-standard'
# 列出所有已修改文件
git config --global alias.changed 'diff --name-only'
# 显示贡献者排名
git config --global alias.contributors 'shortlog -sn'
# 快速推送
git config --global alias.pushup '!git push -u origin $(git branch --show-current)'
# 清理已删除的远程分支
git config --global alias.cleanup 'fetch --prune'

十三、团队协作最佳实践

# 提交信息规范（Conventional Commits）
# 功能开发
git commit -m "feat: 添加用户登录功能"
# Bug 修复
git commit -m "fix: 修复登录页面验证码不显示的问题"
# 文档更新
git commit -m "docs: 更新 API 文档"
# 代码格式化
git commit -m "style: 格式化代码"
# 重构
git commit -m "refactor: 重构用户服务层代码"
# 性能优化
git commit -m "perf: 优化数据库查询性能"
# 测试
git commit -m "test: 添加用户模块单元测试"
# 构建/工具
git commit -m "chore: 更新依赖包版本"
# 工作流程示例
# 1. 从主分支创建功能分支
git checkout main
git pull origin main
git checkout -b feature/user-authentication
# 2. 开发并提交
git add .
git commit -m "feat: 实现用户认证功能"
# 3. 保持分支更新
git checkout main
git pull origin main
git checkout feature/user-authentication
git rebase main
# 4. 推送到远程
git push -u origin feature/user-authentication
# 5. 创建 Pull Request（在 GitHub 上操作）
# 6. 合并后清理
git checkout main
git pull origin main
git branch -d feature/user-authentication
# 解决合并冲突
# 1. 拉取最新代码时出现冲突
git pull origin main
# CONFLICT (content): Merge conflict in file.txt
# 2. 查看冲突文件
git status
# 3. 手动编辑冲突文件，保留需要的代码
# <<<<<<< HEAD
# 你的修改
# =======
# 远程的修改
# >>>>>>> origin/main
# 4. 标记冲突已解决
git add file.txt
# 5. 完成合并
git commit
# 使用变基解决冲突
git rebase main
# 解决冲突后
git add .
git rebase --continue

十四、问题排查与修复

# 查看仓库状态
git status -v
# 检查仓库完整性
git fsck --full
# 修复仓库索引
git reset
# 清理无用文件
git clean -fd
# 修复断开的 HEAD
git checkout main
# 恢复丢失的提交
git reflog
git cherry-pick <commit-hash>
# 修复权限问题
chmod -R u+rw .git
# 重新克隆子模块
git submodule deinit --all
git submodule update --init --recursive
# 修复 CRLF 问题
git config core.autocrlf true
git rm --cached -r .
git reset --hard
# 查看对象数量
git count-objects -v
# 压缩仓库
git repack -a -d --depth=250 --window=250
# 清理引用日志
git reflog expire --expire=now --all
# 强制垃圾回收
git gc --prune=now --aggressive
# 验证远程连接
git ls-remote origin
# 测试 SSH 连接
ssh -T [email protected]
# 调试 Git 命令
GIT_TRACE=1 git pull
GIT_CURL_VERBOSE=1 git push

十五、性能优化与最佳实践

# 启用文件系统监控（提升大仓库性能）
git config core.fsmonitor true
git config core.untrackedcache true
# 启用并行处理
git config fetch.parallel 0
# 启用提交图
git config core.commitGraph true
git config gc.writeCommitGraph true
# 生成提交图
git commit-graph write --reachable
# 使用浅克隆节省空间
git clone --depth=1 <repository-url>
# 只克隆单个分支
git clone --single-branch --branch <branch-name> <repository-url>
# 部分克隆（延迟下载对象）
git clone --filter=blob:none <repository-url>
# 稀疏检出（只检出需要的文件）
git sparse-checkout init --cone
git sparse-checkout set <directory>
# 优化仓库大小
git gc --aggressive
git repack -a -d --depth=250 --window=250
# 使用 LFS 管理大文件
git lfs install
git lfs track "*.psd"
git add .gitattributes