Git
知识库简介
本目录根据 Git 官方 cheat sheet 整理,并补充了本机安装、每类命令的使用场景、常见风险和更现代的替代写法。命令本身保留英文原样,说明使用中文。
Git 是分布式版本控制系统。本库保留现有命令教程,并用一条面向 AI Agent Engineer 的从零路线把它们串起来:先建立“快照、对象、引用”的心智模型,再理解工作区、暂存区与 HEAD,之后学习分支、差异、撤销、远程协作,最后在隔离实验仓库中完成项目。不要在尚未理解影响时对真实工作区运行清理、硬重置、历史改写或强制推送。
来源
原始页面:Git Cheat Sheet;PDF 版本:cheat-sheet.pdf;Windows 安装页:Installing Git。
命令中的占位符
正文标题或行内命令里的
<path>、<commit>、<branch>、<url>只表示“换成真实值”,不要把尖括号原样输入 PowerShell。为避免误复制,本库的 PowerShell 代码块使用README.md、HEAD~1、feature/demo等可解析示例;路径前的--用于明确结束选项并开始路径参数。
在总路线中的位置
本库位于工程基础阶段。它承接 Markdown 与命令行基础,为后续 Python 项目、Agent 工具、评测资产和生产配置提供可审查、可恢复的变更历史;Git 只追踪版本,不替代测试、制品存储、秘密管理或部署审批。
学习目标
- 解释工作区、暂存区、提交和分支之间的关系。
- 在提交前检查状态、差异、未跟踪文件与敏感信息。
- 使用分支隔离 Agent 代码、提示词、配置和评测变更。
- 选择
restore、revert、reset、reflog等不同恢复方式。 - 安全同步远程仓库,并理解改写已共享历史的风险。
- 在隔离仓库完成从初始化到冲突解决、回退和复盘的实践。
前置知识
主要环境为 Windows 11 与 PowerShell 7。开始前只需会切换目录和编辑文本;建议先完成 Markdown,安装与身份配置从第一课开始。
推荐学习顺序
- 01 本机安装 Git:安装、验证与最小身份配置。
- 02 入门与仓库创建:认识仓库并安全初始化或克隆。
- 02A Git 状态模型与提交图:建立快照、对象、index、
HEAD、引用与提交图心智模型。 - 03 暂存区与文件操作:精确选择本次提交内容。
- 04 提交与提交前检查:建立可审查提交习惯。
- 05 分支切换与分支管理:用引用隔离任务工作线。
- 05A 分支合并与冲突处理:理解 fast-forward、三方合并、冲突解决与安全中止。
- 06 差异对比与提交引用:用证据理解实际改动。
- 07 撤销与清理:先判断状态,再选择恢复命令。
- 08 历史改写与故障恢复:只在理解共享历史后使用。
- 09 历史追踪与代码考古:定位引入某行或某行为的提交。
- 10 远程仓库同步:理解 fetch、pull、push 与冲突。
- 10A 远程协作与离线双克隆实验:区分远程引用并离线模拟两位协作者。
- 11 Git 配置与关键文件:管理配置、忽略和仓库关键文件。
- 12 版本控制实战与自测:在隔离实验仓库完成综合任务。
快速入口
- 本机还没安装 Git:先看 本机安装 Git。
- 新建或获取仓库:看 入门与仓库创建。
- 命令总记混:先看 Git 状态模型与提交图。
- 准备一次提交:先看 暂存区与文件操作,再看 提交与提交前检查。
- 分支开发:看 分支切换与分支管理。
- 合并与冲突:看 分支合并与冲突处理。
- 检查改动:看 差异对比与提交引用。
- 撤销或清理:看 撤销与清理,其中包含高风险命令提醒。
- 修改提交历史:看 历史改写与故障恢复,只建议在理解影响后使用。
- 查历史、找责任行:看 历史追踪与代码考古。
- 与远程仓库同步:看 远程仓库同步。
- 想无账号练远程协作:看 远程协作与离线双克隆实验。
- 用户名、别名、忽略文件:看 Git 配置与关键文件。
动手实践与项目入口
综合任务见 版本控制实战与自测。所有破坏性练习都应在新建的隔离实验仓库进行;先用 git status、git diff 和 git log 保存证据,再执行恢复命令。
掌握标准
- 能画出工作区→暂存区→提交的流向,并用命令验证。
- 每次提交前检查已暂存与未暂存差异、未跟踪文件和凭据风险。
- 能创建分支、制造并解决一个文本冲突,解释最终内容。
- 能区分撤销未提交改动、创建反向提交和移动分支指针。
- 能通过
reflog找回可达性丢失的本地提交。 - 不对共享分支随意改写历史;必须强推时优先理解并使用
--force-with-lease。 - 能说明
.gitignore为什么不能保护已进入历史的凭据。
与其他知识库的关系
| 后续知识库 | 连接点 |
|---|---|
| Markdown | 文档与提示词是可读 diff 的文本资产。 |
| Python基础 | 源码、测试和依赖声明应组成可复现提交。 |
| Linux命令 | 服务器端 Git 操作依赖可靠的命令行与路径判断。 |
| MLOps、LLMOps | Git 记录代码版本,但数据、模型、提示、评测和部署还需额外追踪。 |
| Agent Skills、MCP | 工具契约与配置变更要可审查、可回滚。 |
主要参考资料
核验日期:2026-07-14。当前官方稳定文档基线为 Git 2.55.0;本轮本机在 Windows 11、PowerShell 7、git version 2.54.0.windows.1 下核对可用语法。两者分开记录,不能把本机版本当成全局最新版。具体选项随 Git 版本演进,执行前可用 git help status 这类具体命令查本机文档。