Git 命令指南：从 0 到熟练、从常用到“几乎全集”（含常见报错与解决）建议收藏！！！

陈天cjq2025-08-18 22:14

Git 命令指南：从 0 到熟练、从常用到"几乎全集"（含常见报错与解决）

写在前面：Git 的命令分为瓷器（Porcelain）和 管道（Plumbing）两类。日常开发主要用瓷器；运维/排障时会碰到若干管道命令。本文先给高频 20 条 ，再按类别梳理几乎所有常见命令 及作用，并附错误排查速查表 。你可以把本文当作 Cheat Sheet + 故障手册。

### 文章目录

  • [Git 命令指南：从 0 到熟练、从常用到"几乎全集"（含常见报错与解决）](#文章目录 Git 命令指南：从 0 到熟练、从常用到“几乎全集”（含常见报错与解决） @[toc] 1）五分钟上手（最常用 20 条） 2）命令详解（瓷器 Porcelain） 2.1 仓库与配置 2.2 快照与索引 2.3 查看与比较 2.4 分支与合并 2.5 远端协作 2.6 清理与维护 3）常用管道（Plumbing）命令（排障必备） 4）典型工作流“菜谱” 4.1 开新功能分支 → 提交 → Rebase → 推 PR 4.2 修正上一提交（不改 SHA 或改 SHA） 4.3 回滚线上问题（公共分支） 4.4 只拿某个修复到当前分支 4.5 暂存现场切分支修 bug 5）命令一览（分类“几乎全集”索引 + 作用） 获取与创建（Getting and Creating Repositories） 快照（Snapshotting） 分支与合并（Branching & Merging） 共享与更新（Sharing & Updating） 查看与比较（Inspection & Comparison） 补丁与邮件（Patching / Email） 维护与管理（Administration / Maintenance） 常用管道（Plumbing）选摘 6）常见报错 & 解决（速查表） 7）Reset / Restore / Checkout 怎么选？ 8）推荐配置（一次到位） 9）附：常见场景脚本与截图建议 10）结语)
  • [@[toc]](#文章目录 Git 命令指南：从 0 到熟练、从常用到“几乎全集”（含常见报错与解决） @[toc] 1）五分钟上手（最常用 20 条） 2）命令详解（瓷器 Porcelain） 2.1 仓库与配置 2.2 快照与索引 2.3 查看与比较 2.4 分支与合并 2.5 远端协作 2.6 清理与维护 3）常用管道（Plumbing）命令（排障必备） 4）典型工作流“菜谱” 4.1 开新功能分支 → 提交 → Rebase → 推 PR 4.2 修正上一提交（不改 SHA 或改 SHA） 4.3 回滚线上问题（公共分支） 4.4 只拿某个修复到当前分支 4.5 暂存现场切分支修 bug 5）命令一览（分类“几乎全集”索引 + 作用） 获取与创建（Getting and Creating Repositories） 快照（Snapshotting） 分支与合并（Branching & Merging） 共享与更新（Sharing & Updating） 查看与比较（Inspection & Comparison） 补丁与邮件（Patching / Email） 维护与管理（Administration / Maintenance） 常用管道（Plumbing）选摘 6）常见报错 & 解决（速查表） 7）Reset / Restore / Checkout 怎么选？ 8）推荐配置（一次到位） 9）附：常见场景脚本与截图建议 10）结语)
  • [1）五分钟上手（最常用 20 条）](#文章目录 Git 命令指南：从 0 到熟练、从常用到“几乎全集”（含常见报错与解决） @[toc] 1）五分钟上手（最常用 20 条） 2）命令详解（瓷器 Porcelain） 2.1 仓库与配置 2.2 快照与索引 2.3 查看与比较 2.4 分支与合并 2.5 远端协作 2.6 清理与维护 3）常用管道（Plumbing）命令（排障必备） 4）典型工作流“菜谱” 4.1 开新功能分支 → 提交 → Rebase → 推 PR 4.2 修正上一提交（不改 SHA 或改 SHA） 4.3 回滚线上问题（公共分支） 4.4 只拿某个修复到当前分支 4.5 暂存现场切分支修 bug 5）命令一览（分类“几乎全集”索引 + 作用） 获取与创建（Getting and Creating Repositories） 快照（Snapshotting） 分支与合并（Branching & Merging） 共享与更新（Sharing & Updating） 查看与比较（Inspection & Comparison） 补丁与邮件（Patching / Email） 维护与管理（Administration / Maintenance） 常用管道（Plumbing）选摘 6）常见报错 & 解决（速查表） 7）Reset / Restore / Checkout 怎么选？ 8）推荐配置（一次到位） 9）附：常见场景脚本与截图建议 10）结语)
  • [2）命令详解（瓷器 Porcelain）](#文章目录 Git 命令指南：从 0 到熟练、从常用到“几乎全集”（含常见报错与解决） @[toc] 1）五分钟上手（最常用 20 条） 2）命令详解（瓷器 Porcelain） 2.1 仓库与配置 2.2 快照与索引 2.3 查看与比较 2.4 分支与合并 2.5 远端协作 2.6 清理与维护 3）常用管道（Plumbing）命令（排障必备） 4）典型工作流“菜谱” 4.1 开新功能分支 → 提交 → Rebase → 推 PR 4.2 修正上一提交（不改 SHA 或改 SHA） 4.3 回滚线上问题（公共分支） 4.4 只拿某个修复到当前分支 4.5 暂存现场切分支修 bug 5）命令一览（分类“几乎全集”索引 + 作用） 获取与创建（Getting and Creating Repositories） 快照（Snapshotting） 分支与合并（Branching & Merging） 共享与更新（Sharing & Updating） 查看与比较（Inspection & Comparison） 补丁与邮件（Patching / Email） 维护与管理（Administration / Maintenance） 常用管道（Plumbing）选摘 6）常见报错 & 解决（速查表） 7）Reset / Restore / Checkout 怎么选？ 8）推荐配置（一次到位） 9）附：常见场景脚本与截图建议 10）结语)
  • [2.1 仓库与配置](#文章目录 Git 命令指南：从 0 到熟练、从常用到“几乎全集”（含常见报错与解决） @[toc] 1）五分钟上手（最常用 20 条） 2）命令详解（瓷器 Porcelain） 2.1 仓库与配置 2.2 快照与索引 2.3 查看与比较 2.4 分支与合并 2.5 远端协作 2.6 清理与维护 3）常用管道（Plumbing）命令（排障必备） 4）典型工作流“菜谱” 4.1 开新功能分支 → 提交 → Rebase → 推 PR 4.2 修正上一提交（不改 SHA 或改 SHA） 4.3 回滚线上问题（公共分支） 4.4 只拿某个修复到当前分支 4.5 暂存现场切分支修 bug 5）命令一览（分类“几乎全集”索引 + 作用） 获取与创建（Getting and Creating Repositories） 快照（Snapshotting） 分支与合并（Branching & Merging） 共享与更新（Sharing & Updating） 查看与比较（Inspection & Comparison） 补丁与邮件（Patching / Email） 维护与管理（Administration / Maintenance） 常用管道（Plumbing）选摘 6）常见报错 & 解决（速查表） 7）Reset / Restore / Checkout 怎么选？ 8）推荐配置（一次到位） 9）附：常见场景脚本与截图建议 10）结语)
  • [2.2 快照与索引](#文章目录 Git 命令指南：从 0 到熟练、从常用到“几乎全集”（含常见报错与解决） @[toc] 1）五分钟上手（最常用 20 条） 2）命令详解（瓷器 Porcelain） 2.1 仓库与配置 2.2 快照与索引 2.3 查看与比较 2.4 分支与合并 2.5 远端协作 2.6 清理与维护 3）常用管道（Plumbing）命令（排障必备） 4）典型工作流“菜谱” 4.1 开新功能分支 → 提交 → Rebase → 推 PR 4.2 修正上一提交（不改 SHA 或改 SHA） 4.3 回滚线上问题（公共分支） 4.4 只拿某个修复到当前分支 4.5 暂存现场切分支修 bug 5）命令一览（分类“几乎全集”索引 + 作用） 获取与创建（Getting and Creating Repositories） 快照（Snapshotting） 分支与合并（Branching & Merging） 共享与更新（Sharing & Updating） 查看与比较（Inspection & Comparison） 补丁与邮件（Patching / Email） 维护与管理（Administration / Maintenance） 常用管道（Plumbing）选摘 6）常见报错 & 解决（速查表） 7）Reset / Restore / Checkout 怎么选？ 8）推荐配置（一次到位） 9）附：常见场景脚本与截图建议 10）结语)
  • [2.3 查看与比较](#文章目录 Git 命令指南：从 0 到熟练、从常用到“几乎全集”（含常见报错与解决） @[toc] 1）五分钟上手（最常用 20 条） 2）命令详解（瓷器 Porcelain） 2.1 仓库与配置 2.2 快照与索引 2.3 查看与比较 2.4 分支与合并 2.5 远端协作 2.6 清理与维护 3）常用管道（Plumbing）命令（排障必备） 4）典型工作流“菜谱” 4.1 开新功能分支 → 提交 → Rebase → 推 PR 4.2 修正上一提交（不改 SHA 或改 SHA） 4.3 回滚线上问题（公共分支） 4.4 只拿某个修复到当前分支 4.5 暂存现场切分支修 bug 5）命令一览（分类“几乎全集”索引 + 作用） 获取与创建（Getting and Creating Repositories） 快照（Snapshotting） 分支与合并（Branching & Merging） 共享与更新（Sharing & Updating） 查看与比较（Inspection & Comparison） 补丁与邮件（Patching / Email） 维护与管理（Administration / Maintenance） 常用管道（Plumbing）选摘 6）常见报错 & 解决（速查表） 7）Reset / Restore / Checkout 怎么选？ 8）推荐配置（一次到位） 9）附：常见场景脚本与截图建议 10）结语)
  • [2.4 分支与合并](#文章目录 Git 命令指南：从 0 到熟练、从常用到“几乎全集”（含常见报错与解决） @[toc] 1）五分钟上手（最常用 20 条） 2）命令详解（瓷器 Porcelain） 2.1 仓库与配置 2.2 快照与索引 2.3 查看与比较 2.4 分支与合并 2.5 远端协作 2.6 清理与维护 3）常用管道（Plumbing）命令（排障必备） 4）典型工作流“菜谱” 4.1 开新功能分支 → 提交 → Rebase → 推 PR 4.2 修正上一提交（不改 SHA 或改 SHA） 4.3 回滚线上问题（公共分支） 4.4 只拿某个修复到当前分支 4.5 暂存现场切分支修 bug 5）命令一览（分类“几乎全集”索引 + 作用） 获取与创建（Getting and Creating Repositories） 快照（Snapshotting） 分支与合并（Branching & Merging） 共享与更新（Sharing & Updating） 查看与比较（Inspection & Comparison） 补丁与邮件（Patching / Email） 维护与管理（Administration / Maintenance） 常用管道（Plumbing）选摘 6）常见报错 & 解决（速查表） 7）Reset / Restore / Checkout 怎么选？ 8）推荐配置（一次到位） 9）附：常见场景脚本与截图建议 10）结语)
  • [2.5 远端协作](#文章目录 Git 命令指南：从 0 到熟练、从常用到“几乎全集”（含常见报错与解决） @[toc] 1）五分钟上手（最常用 20 条） 2）命令详解（瓷器 Porcelain） 2.1 仓库与配置 2.2 快照与索引 2.3 查看与比较 2.4 分支与合并 2.5 远端协作 2.6 清理与维护 3）常用管道（Plumbing）命令（排障必备） 4）典型工作流“菜谱” 4.1 开新功能分支 → 提交 → Rebase → 推 PR 4.2 修正上一提交（不改 SHA 或改 SHA） 4.3 回滚线上问题（公共分支） 4.4 只拿某个修复到当前分支 4.5 暂存现场切分支修 bug 5）命令一览（分类“几乎全集”索引 + 作用） 获取与创建（Getting and Creating Repositories） 快照（Snapshotting） 分支与合并（Branching & Merging） 共享与更新（Sharing & Updating） 查看与比较（Inspection & Comparison） 补丁与邮件（Patching / Email） 维护与管理（Administration / Maintenance） 常用管道（Plumbing）选摘 6）常见报错 & 解决（速查表） 7）Reset / Restore / Checkout 怎么选？ 8）推荐配置（一次到位） 9）附：常见场景脚本与截图建议 10）结语)
  • [2.6 清理与维护](#文章目录 Git 命令指南：从 0 到熟练、从常用到“几乎全集”（含常见报错与解决） @[toc] 1）五分钟上手（最常用 20 条） 2）命令详解（瓷器 Porcelain） 2.1 仓库与配置 2.2 快照与索引 2.3 查看与比较 2.4 分支与合并 2.5 远端协作 2.6 清理与维护 3）常用管道（Plumbing）命令（排障必备） 4）典型工作流“菜谱” 4.1 开新功能分支 → 提交 → Rebase → 推 PR 4.2 修正上一提交（不改 SHA 或改 SHA） 4.3 回滚线上问题（公共分支） 4.4 只拿某个修复到当前分支 4.5 暂存现场切分支修 bug 5）命令一览（分类“几乎全集”索引 + 作用） 获取与创建（Getting and Creating Repositories） 快照（Snapshotting） 分支与合并（Branching & Merging） 共享与更新（Sharing & Updating） 查看与比较（Inspection & Comparison） 补丁与邮件（Patching / Email） 维护与管理（Administration / Maintenance） 常用管道（Plumbing）选摘 6）常见报错 & 解决（速查表） 7）Reset / Restore / Checkout 怎么选？ 8）推荐配置（一次到位） 9）附：常见场景脚本与截图建议 10）结语)
  • [3）常用管道（Plumbing）命令（排障必备）](#文章目录 Git 命令指南：从 0 到熟练、从常用到“几乎全集”（含常见报错与解决） @[toc] 1）五分钟上手（最常用 20 条） 2）命令详解（瓷器 Porcelain） 2.1 仓库与配置 2.2 快照与索引 2.3 查看与比较 2.4 分支与合并 2.5 远端协作 2.6 清理与维护 3）常用管道（Plumbing）命令（排障必备） 4）典型工作流“菜谱” 4.1 开新功能分支 → 提交 → Rebase → 推 PR 4.2 修正上一提交（不改 SHA 或改 SHA） 4.3 回滚线上问题（公共分支） 4.4 只拿某个修复到当前分支 4.5 暂存现场切分支修 bug 5）命令一览（分类“几乎全集”索引 + 作用） 获取与创建（Getting and Creating Repositories） 快照（Snapshotting） 分支与合并（Branching & Merging） 共享与更新（Sharing & Updating） 查看与比较（Inspection & Comparison） 补丁与邮件（Patching / Email） 维护与管理（Administration / Maintenance） 常用管道（Plumbing）选摘 6）常见报错 & 解决（速查表） 7）Reset / Restore / Checkout 怎么选？ 8）推荐配置（一次到位） 9）附：常见场景脚本与截图建议 10）结语)
  • [4）典型工作流"菜谱"](#文章目录 Git 命令指南：从 0 到熟练、从常用到“几乎全集”（含常见报错与解决） @[toc] 1）五分钟上手（最常用 20 条） 2）命令详解（瓷器 Porcelain） 2.1 仓库与配置 2.2 快照与索引 2.3 查看与比较 2.4 分支与合并 2.5 远端协作 2.6 清理与维护 3）常用管道（Plumbing）命令（排障必备） 4）典型工作流“菜谱” 4.1 开新功能分支 → 提交 → Rebase → 推 PR 4.2 修正上一提交（不改 SHA 或改 SHA） 4.3 回滚线上问题（公共分支） 4.4 只拿某个修复到当前分支 4.5 暂存现场切分支修 bug 5）命令一览（分类“几乎全集”索引 + 作用） 获取与创建（Getting and Creating Repositories） 快照（Snapshotting） 分支与合并（Branching & Merging） 共享与更新（Sharing & Updating） 查看与比较（Inspection & Comparison） 补丁与邮件（Patching / Email） 维护与管理（Administration / Maintenance） 常用管道（Plumbing）选摘 6）常见报错 & 解决（速查表） 7）Reset / Restore / Checkout 怎么选？ 8）推荐配置（一次到位） 9）附：常见场景脚本与截图建议 10）结语)
  • [4.1 开新功能分支 → 提交 → Rebase → 推 PR](#文章目录 Git 命令指南：从 0 到熟练、从常用到“几乎全集”（含常见报错与解决） @[toc] 1）五分钟上手（最常用 20 条） 2）命令详解（瓷器 Porcelain） 2.1 仓库与配置 2.2 快照与索引 2.3 查看与比较 2.4 分支与合并 2.5 远端协作 2.6 清理与维护 3）常用管道（Plumbing）命令（排障必备） 4）典型工作流“菜谱” 4.1 开新功能分支 → 提交 → Rebase → 推 PR 4.2 修正上一提交（不改 SHA 或改 SHA） 4.3 回滚线上问题（公共分支） 4.4 只拿某个修复到当前分支 4.5 暂存现场切分支修 bug 5）命令一览（分类“几乎全集”索引 + 作用） 获取与创建（Getting and Creating Repositories） 快照（Snapshotting） 分支与合并（Branching & Merging） 共享与更新（Sharing & Updating） 查看与比较（Inspection & Comparison） 补丁与邮件（Patching / Email） 维护与管理（Administration / Maintenance） 常用管道（Plumbing）选摘 6）常见报错 & 解决（速查表） 7）Reset / Restore / Checkout 怎么选？ 8）推荐配置（一次到位） 9）附：常见场景脚本与截图建议 10）结语)
  • [4.2 修正上一提交（不改 SHA 或改 SHA）](#文章目录 Git 命令指南：从 0 到熟练、从常用到“几乎全集”（含常见报错与解决） @[toc] 1）五分钟上手（最常用 20 条） 2）命令详解（瓷器 Porcelain） 2.1 仓库与配置 2.2 快照与索引 2.3 查看与比较 2.4 分支与合并 2.5 远端协作 2.6 清理与维护 3）常用管道（Plumbing）命令（排障必备） 4）典型工作流“菜谱” 4.1 开新功能分支 → 提交 → Rebase → 推 PR 4.2 修正上一提交（不改 SHA 或改 SHA） 4.3 回滚线上问题（公共分支） 4.4 只拿某个修复到当前分支 4.5 暂存现场切分支修 bug 5）命令一览（分类“几乎全集”索引 + 作用） 获取与创建（Getting and Creating Repositories） 快照（Snapshotting） 分支与合并（Branching & Merging） 共享与更新（Sharing & Updating） 查看与比较（Inspection & Comparison） 补丁与邮件（Patching / Email） 维护与管理（Administration / Maintenance） 常用管道（Plumbing）选摘 6）常见报错 & 解决（速查表） 7）Reset / Restore / Checkout 怎么选？ 8）推荐配置（一次到位） 9）附：常见场景脚本与截图建议 10）结语)
  • [4.3 回滚线上问题（公共分支）](#文章目录 Git 命令指南：从 0 到熟练、从常用到“几乎全集”（含常见报错与解决） @[toc] 1）五分钟上手（最常用 20 条） 2）命令详解（瓷器 Porcelain） 2.1 仓库与配置 2.2 快照与索引 2.3 查看与比较 2.4 分支与合并 2.5 远端协作 2.6 清理与维护 3）常用管道（Plumbing）命令（排障必备） 4）典型工作流“菜谱” 4.1 开新功能分支 → 提交 → Rebase → 推 PR 4.2 修正上一提交（不改 SHA 或改 SHA） 4.3 回滚线上问题（公共分支） 4.4 只拿某个修复到当前分支 4.5 暂存现场切分支修 bug 5）命令一览（分类“几乎全集”索引 + 作用） 获取与创建（Getting and Creating Repositories） 快照（Snapshotting） 分支与合并（Branching & Merging） 共享与更新（Sharing & Updating） 查看与比较（Inspection & Comparison） 补丁与邮件（Patching / Email） 维护与管理（Administration / Maintenance） 常用管道（Plumbing）选摘 6）常见报错 & 解决（速查表） 7）Reset / Restore / Checkout 怎么选？ 8）推荐配置（一次到位） 9）附：常见场景脚本与截图建议 10）结语)
  • [4.4 只拿某个修复到当前分支](#文章目录 Git 命令指南：从 0 到熟练、从常用到“几乎全集”（含常见报错与解决） @[toc] 1）五分钟上手（最常用 20 条） 2）命令详解（瓷器 Porcelain） 2.1 仓库与配置 2.2 快照与索引 2.3 查看与比较 2.4 分支与合并 2.5 远端协作 2.6 清理与维护 3）常用管道（Plumbing）命令（排障必备） 4）典型工作流“菜谱” 4.1 开新功能分支 → 提交 → Rebase → 推 PR 4.2 修正上一提交（不改 SHA 或改 SHA） 4.3 回滚线上问题（公共分支） 4.4 只拿某个修复到当前分支 4.5 暂存现场切分支修 bug 5）命令一览（分类“几乎全集”索引 + 作用） 获取与创建（Getting and Creating Repositories） 快照（Snapshotting） 分支与合并（Branching & Merging） 共享与更新（Sharing & Updating） 查看与比较（Inspection & Comparison） 补丁与邮件（Patching / Email） 维护与管理（Administration / Maintenance） 常用管道（Plumbing）选摘 6）常见报错 & 解决（速查表） 7）Reset / Restore / Checkout 怎么选？ 8）推荐配置（一次到位） 9）附：常见场景脚本与截图建议 10）结语)
  • [4.5 暂存现场切分支修 bug](#文章目录 Git 命令指南：从 0 到熟练、从常用到“几乎全集”（含常见报错与解决） @[toc] 1）五分钟上手（最常用 20 条） 2）命令详解（瓷器 Porcelain） 2.1 仓库与配置 2.2 快照与索引 2.3 查看与比较 2.4 分支与合并 2.5 远端协作 2.6 清理与维护 3）常用管道（Plumbing）命令（排障必备） 4）典型工作流“菜谱” 4.1 开新功能分支 → 提交 → Rebase → 推 PR 4.2 修正上一提交（不改 SHA 或改 SHA） 4.3 回滚线上问题（公共分支） 4.4 只拿某个修复到当前分支 4.5 暂存现场切分支修 bug 5）命令一览（分类“几乎全集”索引 + 作用） 获取与创建（Getting and Creating Repositories） 快照（Snapshotting） 分支与合并（Branching & Merging） 共享与更新（Sharing & Updating） 查看与比较（Inspection & Comparison） 补丁与邮件（Patching / Email） 维护与管理（Administration / Maintenance） 常用管道（Plumbing）选摘 6）常见报错 & 解决（速查表） 7）Reset / Restore / Checkout 怎么选？ 8）推荐配置（一次到位） 9）附：常见场景脚本与截图建议 10）结语)
  • [5）命令一览（分类"几乎全集"索引 + 作用）](#文章目录 Git 命令指南：从 0 到熟练、从常用到“几乎全集”（含常见报错与解决） @[toc] 1）五分钟上手（最常用 20 条） 2）命令详解（瓷器 Porcelain） 2.1 仓库与配置 2.2 快照与索引 2.3 查看与比较 2.4 分支与合并 2.5 远端协作 2.6 清理与维护 3）常用管道（Plumbing）命令（排障必备） 4）典型工作流“菜谱” 4.1 开新功能分支 → 提交 → Rebase → 推 PR 4.2 修正上一提交（不改 SHA 或改 SHA） 4.3 回滚线上问题（公共分支） 4.4 只拿某个修复到当前分支 4.5 暂存现场切分支修 bug 5）命令一览（分类“几乎全集”索引 + 作用） 获取与创建（Getting and Creating Repositories） 快照（Snapshotting） 分支与合并（Branching & Merging） 共享与更新（Sharing & Updating） 查看与比较（Inspection & Comparison） 补丁与邮件（Patching / Email） 维护与管理（Administration / Maintenance） 常用管道（Plumbing）选摘 6）常见报错 & 解决（速查表） 7）Reset / Restore / Checkout 怎么选？ 8）推荐配置（一次到位） 9）附：常见场景脚本与截图建议 10）结语)
  • [获取与创建（Getting and Creating Repositories）](#文章目录 Git 命令指南：从 0 到熟练、从常用到“几乎全集”（含常见报错与解决） @[toc] 1）五分钟上手（最常用 20 条） 2）命令详解（瓷器 Porcelain） 2.1 仓库与配置 2.2 快照与索引 2.3 查看与比较 2.4 分支与合并 2.5 远端协作 2.6 清理与维护 3）常用管道（Plumbing）命令（排障必备） 4）典型工作流“菜谱” 4.1 开新功能分支 → 提交 → Rebase → 推 PR 4.2 修正上一提交（不改 SHA 或改 SHA） 4.3 回滚线上问题（公共分支） 4.4 只拿某个修复到当前分支 4.5 暂存现场切分支修 bug 5）命令一览（分类“几乎全集”索引 + 作用） 获取与创建（Getting and Creating Repositories） 快照（Snapshotting） 分支与合并（Branching & Merging） 共享与更新（Sharing & Updating） 查看与比较（Inspection & Comparison） 补丁与邮件（Patching / Email） 维护与管理（Administration / Maintenance） 常用管道（Plumbing）选摘 6）常见报错 & 解决（速查表） 7）Reset / Restore / Checkout 怎么选？ 8）推荐配置（一次到位） 9）附：常见场景脚本与截图建议 10）结语)
  • [快照（Snapshotting）](#文章目录 Git 命令指南：从 0 到熟练、从常用到“几乎全集”（含常见报错与解决） @[toc] 1）五分钟上手（最常用 20 条） 2）命令详解（瓷器 Porcelain） 2.1 仓库与配置 2.2 快照与索引 2.3 查看与比较 2.4 分支与合并 2.5 远端协作 2.6 清理与维护 3）常用管道（Plumbing）命令（排障必备） 4）典型工作流“菜谱” 4.1 开新功能分支 → 提交 → Rebase → 推 PR 4.2 修正上一提交（不改 SHA 或改 SHA） 4.3 回滚线上问题（公共分支） 4.4 只拿某个修复到当前分支 4.5 暂存现场切分支修 bug 5）命令一览（分类“几乎全集”索引 + 作用） 获取与创建（Getting and Creating Repositories） 快照（Snapshotting） 分支与合并（Branching & Merging） 共享与更新（Sharing & Updating） 查看与比较（Inspection & Comparison） 补丁与邮件（Patching / Email） 维护与管理（Administration / Maintenance） 常用管道（Plumbing）选摘 6）常见报错 & 解决（速查表） 7）Reset / Restore / Checkout 怎么选？ 8）推荐配置（一次到位） 9）附：常见场景脚本与截图建议 10）结语)
  • [分支与合并（Branching & Merging）](#文章目录 Git 命令指南：从 0 到熟练、从常用到“几乎全集”（含常见报错与解决） @[toc] 1）五分钟上手（最常用 20 条） 2）命令详解（瓷器 Porcelain） 2.1 仓库与配置 2.2 快照与索引 2.3 查看与比较 2.4 分支与合并 2.5 远端协作 2.6 清理与维护 3）常用管道（Plumbing）命令（排障必备） 4）典型工作流“菜谱” 4.1 开新功能分支 → 提交 → Rebase → 推 PR 4.2 修正上一提交（不改 SHA 或改 SHA） 4.3 回滚线上问题（公共分支） 4.4 只拿某个修复到当前分支 4.5 暂存现场切分支修 bug 5）命令一览（分类“几乎全集”索引 + 作用） 获取与创建（Getting and Creating Repositories） 快照（Snapshotting） 分支与合并（Branching & Merging） 共享与更新（Sharing & Updating） 查看与比较（Inspection & Comparison） 补丁与邮件（Patching / Email） 维护与管理（Administration / Maintenance） 常用管道（Plumbing）选摘 6）常见报错 & 解决（速查表） 7）Reset / Restore / Checkout 怎么选？ 8）推荐配置（一次到位） 9）附：常见场景脚本与截图建议 10）结语)
  • [共享与更新（Sharing & Updating）](#文章目录 Git 命令指南：从 0 到熟练、从常用到“几乎全集”（含常见报错与解决） @[toc] 1）五分钟上手（最常用 20 条） 2）命令详解（瓷器 Porcelain） 2.1 仓库与配置 2.2 快照与索引 2.3 查看与比较 2.4 分支与合并 2.5 远端协作 2.6 清理与维护 3）常用管道（Plumbing）命令（排障必备） 4）典型工作流“菜谱” 4.1 开新功能分支 → 提交 → Rebase → 推 PR 4.2 修正上一提交（不改 SHA 或改 SHA） 4.3 回滚线上问题（公共分支） 4.4 只拿某个修复到当前分支 4.5 暂存现场切分支修 bug 5）命令一览（分类“几乎全集”索引 + 作用） 获取与创建（Getting and Creating Repositories） 快照（Snapshotting） 分支与合并（Branching & Merging） 共享与更新（Sharing & Updating） 查看与比较（Inspection & Comparison） 补丁与邮件（Patching / Email） 维护与管理（Administration / Maintenance） 常用管道（Plumbing）选摘 6）常见报错 & 解决（速查表） 7）Reset / Restore / Checkout 怎么选？ 8）推荐配置（一次到位） 9）附：常见场景脚本与截图建议 10）结语)
  • [查看与比较（Inspection & Comparison）](#文章目录 Git 命令指南：从 0 到熟练、从常用到“几乎全集”（含常见报错与解决） @[toc] 1）五分钟上手（最常用 20 条） 2）命令详解（瓷器 Porcelain） 2.1 仓库与配置 2.2 快照与索引 2.3 查看与比较 2.4 分支与合并 2.5 远端协作 2.6 清理与维护 3）常用管道（Plumbing）命令（排障必备） 4）典型工作流“菜谱” 4.1 开新功能分支 → 提交 → Rebase → 推 PR 4.2 修正上一提交（不改 SHA 或改 SHA） 4.3 回滚线上问题（公共分支） 4.4 只拿某个修复到当前分支 4.5 暂存现场切分支修 bug 5）命令一览（分类“几乎全集”索引 + 作用） 获取与创建（Getting and Creating Repositories） 快照（Snapshotting） 分支与合并（Branching & Merging） 共享与更新（Sharing & Updating） 查看与比较（Inspection & Comparison） 补丁与邮件（Patching / Email） 维护与管理（Administration / Maintenance） 常用管道（Plumbing）选摘 6）常见报错 & 解决（速查表） 7）Reset / Restore / Checkout 怎么选？ 8）推荐配置（一次到位） 9）附：常见场景脚本与截图建议 10）结语)
  • [补丁与邮件（Patching / Email）](#文章目录 Git 命令指南：从 0 到熟练、从常用到“几乎全集”（含常见报错与解决） @[toc] 1）五分钟上手（最常用 20 条） 2）命令详解（瓷器 Porcelain） 2.1 仓库与配置 2.2 快照与索引 2.3 查看与比较 2.4 分支与合并 2.5 远端协作 2.6 清理与维护 3）常用管道（Plumbing）命令（排障必备） 4）典型工作流“菜谱” 4.1 开新功能分支 → 提交 → Rebase → 推 PR 4.2 修正上一提交（不改 SHA 或改 SHA） 4.3 回滚线上问题（公共分支） 4.4 只拿某个修复到当前分支 4.5 暂存现场切分支修 bug 5）命令一览（分类“几乎全集”索引 + 作用） 获取与创建（Getting and Creating Repositories） 快照（Snapshotting） 分支与合并（Branching & Merging） 共享与更新（Sharing & Updating） 查看与比较（Inspection & Comparison） 补丁与邮件（Patching / Email） 维护与管理（Administration / Maintenance） 常用管道（Plumbing）选摘 6）常见报错 & 解决（速查表） 7）Reset / Restore / Checkout 怎么选？ 8）推荐配置（一次到位） 9）附：常见场景脚本与截图建议 10）结语)
  • [维护与管理（Administration / Maintenance）](#文章目录 Git 命令指南：从 0 到熟练、从常用到“几乎全集”（含常见报错与解决） @[toc] 1）五分钟上手（最常用 20 条） 2）命令详解（瓷器 Porcelain） 2.1 仓库与配置 2.2 快照与索引 2.3 查看与比较 2.4 分支与合并 2.5 远端协作 2.6 清理与维护 3）常用管道（Plumbing）命令（排障必备） 4）典型工作流“菜谱” 4.1 开新功能分支 → 提交 → Rebase → 推 PR 4.2 修正上一提交（不改 SHA 或改 SHA） 4.3 回滚线上问题（公共分支） 4.4 只拿某个修复到当前分支 4.5 暂存现场切分支修 bug 5）命令一览（分类“几乎全集”索引 + 作用） 获取与创建（Getting and Creating Repositories） 快照（Snapshotting） 分支与合并（Branching & Merging） 共享与更新（Sharing & Updating） 查看与比较（Inspection & Comparison） 补丁与邮件（Patching / Email） 维护与管理（Administration / Maintenance） 常用管道（Plumbing）选摘 6）常见报错 & 解决（速查表） 7）Reset / Restore / Checkout 怎么选？ 8）推荐配置（一次到位） 9）附：常见场景脚本与截图建议 10）结语)
  • [常用管道（Plumbing）选摘](#文章目录 Git 命令指南：从 0 到熟练、从常用到“几乎全集”（含常见报错与解决） @[toc] 1）五分钟上手（最常用 20 条） 2）命令详解（瓷器 Porcelain） 2.1 仓库与配置 2.2 快照与索引 2.3 查看与比较 2.4 分支与合并 2.5 远端协作 2.6 清理与维护 3）常用管道（Plumbing）命令（排障必备） 4）典型工作流“菜谱” 4.1 开新功能分支 → 提交 → Rebase → 推 PR 4.2 修正上一提交（不改 SHA 或改 SHA） 4.3 回滚线上问题（公共分支） 4.4 只拿某个修复到当前分支 4.5 暂存现场切分支修 bug 5）命令一览（分类“几乎全集”索引 + 作用） 获取与创建（Getting and Creating Repositories） 快照（Snapshotting） 分支与合并（Branching & Merging） 共享与更新（Sharing & Updating） 查看与比较（Inspection & Comparison） 补丁与邮件（Patching / Email） 维护与管理（Administration / Maintenance） 常用管道（Plumbing）选摘 6）常见报错 & 解决（速查表） 7）Reset / Restore / Checkout 怎么选？ 8）推荐配置（一次到位） 9）附：常见场景脚本与截图建议 10）结语)
  • [6）常见报错 & 解决（速查表）](#文章目录 Git 命令指南：从 0 到熟练、从常用到“几乎全集”（含常见报错与解决） @[toc] 1）五分钟上手（最常用 20 条） 2）命令详解（瓷器 Porcelain） 2.1 仓库与配置 2.2 快照与索引 2.3 查看与比较 2.4 分支与合并 2.5 远端协作 2.6 清理与维护 3）常用管道（Plumbing）命令（排障必备） 4）典型工作流“菜谱” 4.1 开新功能分支 → 提交 → Rebase → 推 PR 4.2 修正上一提交（不改 SHA 或改 SHA） 4.3 回滚线上问题（公共分支） 4.4 只拿某个修复到当前分支 4.5 暂存现场切分支修 bug 5）命令一览（分类“几乎全集”索引 + 作用） 获取与创建（Getting and Creating Repositories） 快照（Snapshotting） 分支与合并（Branching & Merging） 共享与更新（Sharing & Updating） 查看与比较（Inspection & Comparison） 补丁与邮件（Patching / Email） 维护与管理（Administration / Maintenance） 常用管道（Plumbing）选摘 6）常见报错 & 解决（速查表） 7）Reset / Restore / Checkout 怎么选？ 8）推荐配置（一次到位） 9）附：常见场景脚本与截图建议 10）结语)
  • [7）Reset / Restore / Checkout 怎么选？](#文章目录 Git 命令指南：从 0 到熟练、从常用到“几乎全集”（含常见报错与解决） @[toc] 1）五分钟上手（最常用 20 条） 2）命令详解（瓷器 Porcelain） 2.1 仓库与配置 2.2 快照与索引 2.3 查看与比较 2.4 分支与合并 2.5 远端协作 2.6 清理与维护 3）常用管道（Plumbing）命令（排障必备） 4）典型工作流“菜谱” 4.1 开新功能分支 → 提交 → Rebase → 推 PR 4.2 修正上一提交（不改 SHA 或改 SHA） 4.3 回滚线上问题（公共分支） 4.4 只拿某个修复到当前分支 4.5 暂存现场切分支修 bug 5）命令一览（分类“几乎全集”索引 + 作用） 获取与创建（Getting and Creating Repositories） 快照（Snapshotting） 分支与合并（Branching & Merging） 共享与更新（Sharing & Updating） 查看与比较（Inspection & Comparison） 补丁与邮件（Patching / Email） 维护与管理（Administration / Maintenance） 常用管道（Plumbing）选摘 6）常见报错 & 解决（速查表） 7）Reset / Restore / Checkout 怎么选？ 8）推荐配置（一次到位） 9）附：常见场景脚本与截图建议 10）结语)
  • [8）推荐配置（一次到位）](#文章目录 Git 命令指南：从 0 到熟练、从常用到“几乎全集”（含常见报错与解决） @[toc] 1）五分钟上手（最常用 20 条） 2）命令详解（瓷器 Porcelain） 2.1 仓库与配置 2.2 快照与索引 2.3 查看与比较 2.4 分支与合并 2.5 远端协作 2.6 清理与维护 3）常用管道（Plumbing）命令（排障必备） 4）典型工作流“菜谱” 4.1 开新功能分支 → 提交 → Rebase → 推 PR 4.2 修正上一提交（不改 SHA 或改 SHA） 4.3 回滚线上问题（公共分支） 4.4 只拿某个修复到当前分支 4.5 暂存现场切分支修 bug 5）命令一览（分类“几乎全集”索引 + 作用） 获取与创建（Getting and Creating Repositories） 快照（Snapshotting） 分支与合并（Branching & Merging） 共享与更新（Sharing & Updating） 查看与比较（Inspection & Comparison） 补丁与邮件（Patching / Email） 维护与管理（Administration / Maintenance） 常用管道（Plumbing）选摘 6）常见报错 & 解决（速查表） 7）Reset / Restore / Checkout 怎么选？ 8）推荐配置（一次到位） 9）附：常见场景脚本与截图建议 10）结语)
  • [9）附：常见场景脚本与截图建议](#文章目录 Git 命令指南：从 0 到熟练、从常用到“几乎全集”（含常见报错与解决） @[toc] 1）五分钟上手（最常用 20 条） 2）命令详解（瓷器 Porcelain） 2.1 仓库与配置 2.2 快照与索引 2.3 查看与比较 2.4 分支与合并 2.5 远端协作 2.6 清理与维护 3）常用管道（Plumbing）命令（排障必备） 4）典型工作流“菜谱” 4.1 开新功能分支 → 提交 → Rebase → 推 PR 4.2 修正上一提交（不改 SHA 或改 SHA） 4.3 回滚线上问题（公共分支） 4.4 只拿某个修复到当前分支 4.5 暂存现场切分支修 bug 5）命令一览（分类“几乎全集”索引 + 作用） 获取与创建（Getting and Creating Repositories） 快照（Snapshotting） 分支与合并（Branching & Merging） 共享与更新（Sharing & Updating） 查看与比较（Inspection & Comparison） 补丁与邮件（Patching / Email） 维护与管理（Administration / Maintenance） 常用管道（Plumbing）选摘 6）常见报错 & 解决（速查表） 7）Reset / Restore / Checkout 怎么选？ 8）推荐配置（一次到位） 9）附：常见场景脚本与截图建议 10）结语)
  • [10）结语](#文章目录 Git 命令指南：从 0 到熟练、从常用到“几乎全集”（含常见报错与解决） @[toc] 1）五分钟上手（最常用 20 条） 2）命令详解（瓷器 Porcelain） 2.1 仓库与配置 2.2 快照与索引 2.3 查看与比较 2.4 分支与合并 2.5 远端协作 2.6 清理与维护 3）常用管道（Plumbing）命令（排障必备） 4）典型工作流“菜谱” 4.1 开新功能分支 → 提交 → Rebase → 推 PR 4.2 修正上一提交（不改 SHA 或改 SHA） 4.3 回滚线上问题（公共分支） 4.4 只拿某个修复到当前分支 4.5 暂存现场切分支修 bug 5）命令一览（分类“几乎全集”索引 + 作用） 获取与创建（Getting and Creating Repositories） 快照（Snapshotting） 分支与合并（Branching & Merging） 共享与更新（Sharing & Updating） 查看与比较（Inspection & Comparison） 补丁与邮件（Patching / Email） 维护与管理（Administration / Maintenance） 常用管道（Plumbing）选摘 6）常见报错 & 解决（速查表） 7）Reset / Restore / Checkout 怎么选？ 8）推荐配置（一次到位） 9）附：常见场景脚本与截图建议 10）结语)

1）五分钟上手（最常用 20 条）

bash 复制代码 
# 初始化 / 克隆
git init                     # 在当前目录创建仓库
git clone <url>              # 克隆远端仓库

# 快照（工作区 -> 暂存区 -> 提交）
git status                   # 查看状态
git add <file/dir>           # 加入暂存区
git restore --staged <f>     # 从暂存区撤回
git commit -m "msg"          # 提交
git commit --amend           # 修改上一条提交

# 比对与查看
git diff                     # 工作区 vs 暂存区
git diff --staged            # 暂存区 vs HEAD
git log --oneline --graph    # 历史图
git show <commit>            # 看某个提交/对象

# 分支与合并
git branch                   # 列分支
git switch -c feat/x         # 新建并切换
git merge <branch>           # 合并
git rebase <branch>          # 变基（线性历史）

# 远端协作
git remote -v                # 远端列表
git fetch                    # 拉取但不合并
git pull                     # fetch + 合并/变基
git push -u origin main      # 推送并建立上游

# 回滚与恢复
git revert <commit>          # 生成反向提交（推荐）
git reset --hard <commit>    # **危险** 回到某快照
git stash push -m "wip"      # 暂存工作区
git stash pop                # 取出

2）命令详解（瓷器 Porcelain）

2.1 仓库与配置

  • git init：初始化仓库；-b main 指定默认分支名。
  • git clone <url> [dir]：克隆；--depth N 浅克隆。
  • git config [--global] key value：配置；常用：
    • user.name / user.email 身份；
    • init.defaultBranch main 默认分支名；
    • core.autocrlf input|true|false 行尾；
    • pull.rebase true|false|merges 拉取策略；
    • alias.xxx '命令' 自定义别名。

2.2 快照与索引

  • git status：状态。
  • git add：把工作区更改放到暂存区 ；-p 交互式分块。
  • git restore [--staged] <f>：撤销（工作区/暂存区）。
  • git rm [-r] <path>：删除并记录到暂存区；--cached 只从索引移除。
  • git mv <a> <b>：重命名（等价于 add+rm）。
  • git commit [-m]：提交；--amend 修改上一提交；--no-verify 跳过钩子。
  • git tag [v1.0]：打标签；-a 附注；-d 删除；push --tags 推送。

2.3 查看与比较

  • git log [--oneline --graph --decorate]：历史。
  • git show <obj>：查看提交/标签/文件某版本。
  • git diff 与 git diff --staged：差异；--name-only 只看文件名；<A>..<B> 比两点。
  • git blame <f>：逐行追溯。
  • git grep <pattern>：搜索内容。
  • git describe：用最近标签描述提交。

2.4 分支与合并

  • git branch：本地分支；-r 远端；-a 全部。
  • git switch <b> / git checkout <b>：切换；-c 新建。
  • git merge <b>：把 <b> 合并到当前分支；冲突后 git add 解决再 commit。
  • git rebase <b>：把当前分支的提交搬到 <b> 之上；-i 交互式整理（squash / fixup）。
  • git cherry-pick <commit..>：拣选一或多提交。
  • git revert <commit>：生成"反向提交"，推荐用于公共分支。
  • git worktree：多工作树并行开发。

2.5 远端协作

  • git remote add origin <url>：添加远端。
  • git fetch [origin] [refspec]：拉取；--prune 清理远端已删分支。
  • git pull：fetch+合并/变基；推荐明确：git pull --rebase 或配置 pull.rebase=true。
  • git push [--set-upstream] origin <branch>：推送并设置上游；--force-with-lease 安全强推。
  • git submodule：子模块；git submodule update --init --recursive 初始化更新。
  • git sparse-checkout：稀疏检出（只要子目录）。

2.6 清理与维护

  • git clean -fdx：清理未跟踪文件（谨慎）；
  • git gc：垃圾回收；git fsck 完整性检查；
  • git reflog：引用日志（救命神器，找回误删）。
  • git bisect：二分定位问题提交。
  • git range-diff：比较两段提交的差异（PR 变基后对比好用）。
  • git shortlog：提交统计。

3）常用管道（Plumbing）命令（排障必备）

这些命令更底层，名字略"生硬"，但排障/脚本化时非常有用。

  • 对象与树

    • git cat-file -t|-p <obj>：查看对象类型/内容。
    • git ls-tree <commit> [path]：列出树对象。
    • git write-tree / git read-tree：读写索引与树对象。
    • git hash-object -w <file>：把文件写入对象库。

  • 引用与提交图

    • git rev-parse：解析引用（如 HEAD~3）。
    • git rev-list <range>：列出提交序列。
    • git show-ref：列出引用（分支/标签）。
    • git update-ref：直接改引用值（危险）。

  • 索引与路径

    • git ls-files：索引中文件。
    • git check-ignore -v <path>：为什么被 .gitignore 忽略。
    • git update-index：直接操作索引（缓存）。

  • 补丁/导入导出

    • git apply：应用补丁（工作区/索引）；
    • git format-patch / git am：导出/导入邮件补丁流。
    • git bundle：打包仓库为单文件（带历史）。
    • git fast-export / git fast-import：高速迁移。

  • 维护

    • git repack / git prune / git gc：对象整理与清理。
    • git verify-commit / verify-tag / verify-pack：校验签名/包。
    • git maintenance start|run：后台维护任务（8.0+）。

历史命令（不再推荐）：git filter-branch（改历史，慢且危险）。现代做法请用 git filter-repo（外部工具）。

4）典型工作流"菜谱"

4.1 开新功能分支 → 提交 → Rebase → 推 PR

bash 复制代码 
git switch -c feat/api
# ...修改...
git add -A && git commit -m "feat: api"
git fetch origin main
git rebase origin/main          # 线性历史
git push -u origin feat/api

4.2 修正上一提交（不改 SHA 或改 SHA）

bash 复制代码 
git commit --amend --no-edit    # 只补文件，不改提交信息（会改 SHA）
# 若公共分支已共享，谨慎：git push --force-with-lease

4.3 回滚线上问题（公共分支）

bash 复制代码 
git revert <bad-commit>         # 生成反向提交，不改历史
git push

4.4 只拿某个修复到当前分支

bash 复制代码 
git cherry-pick <fix-commit>

4.5 暂存现场切分支修 bug

bash 复制代码 
git stash push -m "wip"
git switch -c hotfix/x
# 修复...
git switch -
git stash pop

5）命令一览（分类"几乎全集"索引 + 作用）

下面按 git help -a 的常见分组给出名称 + 一句作用 （粗体为高频）：

获取与创建（Getting and Creating Repositories）

  • init 初始化仓库
  • clone 克隆仓库
  • config 配置
  • help 帮助
  • worktree 多工作树

快照（Snapshotting）

  • add 加入暂存区
  • status 状态
  • diff 差异
  • commit 创建提交
  • reset 回到某状态（移动 HEAD/索引/工作区）
  • rm/mv/restore 删除/移动/恢复
  • stash 暂存现场
  • tag 标签
  • bisect 二分定位

分支与合并（Branching & Merging）

  • branch 分支管理
  • switch/checkout 切换
  • merge 合并
  • rebase 变基
  • cherry-pick 拣选
  • revert 反向提交
  • range-diff 比较两段提交差异
  • worktree 并行工作树

共享与更新（Sharing & Updating）

  • remote 管理远端
  • fetch 拉取不合并
  • pull 拉取并合并/变基
  • push 推送
  • submodule 子模块
  • sparse-checkout 稀疏检出
  • bundle 打包传输

查看与比较（Inspection & Comparison）

  • log 历史
  • show 查看对象
  • grep 搜索
  • blame 逐行追溯
  • shortlog 统计
  • reflog 引用日志
  • describe 标签描述

补丁与邮件（Patching / Email）

  • format-patch / am 导出/应用补丁
  • apply 应用 patch
  • send-email（可选组件） 发送补丁

维护与管理（Administration / Maintenance）

  • gc 垃圾回收
  • fsck 完整性检查
  • repack/prune 重打包/清理
  • verify-commit/tag/pack 验证
  • update-server-info 无智能服务的 HTTP 支持
  • filter-branch（历史）历史重写（不推荐）
  • maintenance 后台维护任务

常用管道（Plumbing）选摘

  • cat-file / ls-tree / ls-files 查看对象/树/索引
  • hash-object / write-tree / read-tree 操作对象/树
  • rev-parse / rev-list / show-ref / update-ref 解析与管理引用
  • check-ignore / check-attr 忽略与属性检查
  • pack-objects / index-pack / verify-pack 包操作
  • fast-export / fast-import 迁移
  • symbolic-ref 设置/读取符号引用（如 HEAD）

说明：Git 官方共有上百条命令，以上已覆盖日常开发与绝大多数排障所需。如需逐条 man page，请在本地运行 git help -a / git help <cmd>。

6）常见报错 & 解决（速查表）

报错/症状 原因 解决
fatal: not a git repository 不在仓库内/子目录丢失 .git cd 到仓库；或确认 .git 未被删
fatal: remote origin already exists 重复添加远端 git remote set-url origin <url> 或 git remote remove origin
error: failed to push some refs / non-fast-forward 远端有你本地没有的提交 git pull --rebase 后再 git push；或用 --force-with-lease
Updates were rejected because the remote contains work... 同上 同上，优先用 rebase 合并远端
refusing to merge unrelated histories 两端历史无共同祖先 git pull --allow-unrelated-histories（仅一次性合并）
detached HEAD 处在游离 HEAD（检出到提交） git switch -c tmp 建分支保存，或 git switch <branch>
合并冲突 <<<<<<< 两边同时修改 手动解决后 git add + git commit；或 git merge --abort
Permission denied (publickey) SSH Key 未配置 生成并添加公钥；或改用 HTTPS
SSL certificate problem 证书问题 配置受信 CA 或改用 SSH（不建议全局禁用验证）
LF will be replaced by CRLF 行尾转换提示 设置 git config core.autocrlf input（mac/linux）或 true（windows）
filename too long（Windows） 路径过长 管理员打开 git config --system core.longpaths true
index.lock 存在 上次异常中断 确认无 git 进程后删除 .git/index.lock
fatal: bad object <sha> / 对象损坏 仓库损坏/中断 git fsck，必要时 git gc --prune=now 或重新克隆
RPC failed; curl 56 / 推送大文件失败 大文件/网络问题 走 Git LFS：git lfs install && git lfs track；检查代理/网络
Your branch is behind 本地落后 git pull --rebase
fatal: The current branch has no upstream branch 未设上游 git push -u origin <branch>
shallow update not allowed 浅克隆限制 git fetch --unshallow 或全量克隆

救援三板斧

  1. git reflog 找回引用移动历史；
  2. git fsck 检查对象库；
  3. 新克隆一份 与本地比对，必要时 cherry-pick 搬迁。

7）Reset / Restore / Checkout 怎么选？

  • git restore <file>：把工作区文件还原为索引或指定提交。
  • git restore --staged <file>：把暂存区还原为 HEAD。
  • git reset --soft|--mixed|--hard <commit>：移动 HEAD（及索引/工作区）。
    • --soft 只动 HEAD；--mixed（默认）动 HEAD+索引；--hard 三者都回退（危险）。
  • git switch：专注切分支；git checkout 兼顾检出文件/分支（老习惯）。

8）推荐配置（一次到位）

bash 复制代码 
git config --global user.name  "你的名字"
git config --global user.email "you@example.com"
git config --global init.defaultBranch main
git config --global pull.rebase false        # 或 true，团队统一即可
git config --global core.autocrlf input      # mac/linux; windows 可 true
git config --global fetch.prune true
git config --global alias.lg "log --oneline --graph --decorate --all"

9）附：常见场景脚本与截图建议

  • DDL/造数 不适用 Git，但你可以准备一个"示例仓库"用于截图：
    1. 制造冲突并演示解决；
    2. EXPLAIN 不适用，改用 git log --graph/range-diff 展示 rebase 前后；
    3. "慢查截图"换成 慢推送/大文件报错 的复现终端截图。
  • 若要做团队规范 ，附上 .gitignore 模板、pre-commit 钩子示例（如 lint、secret 扫描）。

10）结语

Git 不止会用 add/commit/push 。把条件 rebase、cherry-pick、revert、reflog、bisect 这些"王牌"掌握后，你基本能从容处理 90% 的协作与故障。本文把高频操作、几乎全量命令目录、以及常见错误与解法都放到了一处，建议收藏为团队的随手册。

热门推荐
01UV安装并设置国内源02Qwen3-Coder 快速上手教程 | Qwen Code + Claude Code03【2025.08.06最新版】Android Studio下载、安装及配置记录（自动下载sdk）04KGG转MP3工具|非KGM文件|解密音频052025最新国内服务器可用docker源仓库地址大全（2025年8月更新）06蜘蛛磁力 搜索引擎大全，如何使用蜘蛛磁力查找磁力链接07TRAE 规则（Rules）配置指南：个人习惯、团队规范与最佳实践08NVIDIA显卡驱动、CUDA、cuDNN 和 TensorRT 版本匹配指南09阿里开源首个图像生成基础模型——Qwen-Image本地部署教程，超强中文渲染能力刷新SOTA！10TRAE Rules 实践：为项目配置 6A 工作流