Git 最小命令

这门课你只需要认这几条命令,而且都交给 Agent 敲。这张卡帮你记住:每条什么时候用、对 Agent 说哪句人话、怎么确认它真做成了。改坏了别慌,翻到最下面那两条后悔药。

这张卡分三块

一句话先记住:开启存档用 git init(一个项目只做一次);存检查点用 git add + git commit;翻账本用 git log;撤回乱改用 git restore。命令归 Agent,你只管会说、会看、指对版本。

1. 四条命令

命令	什么时候用(触发)	你对 Agent 说的人话	怎么确认成功
`git init`	一个新项目第一次要开始存档。一个项目只做一次。	"帮我给这个项目开启 Git 存档(git init)。"	它回一句类似"已初始化空的 Git 仓库",之后再让它存档不报"不是一个 Git 仓库"的错。
`git add`	改了文件,准备把这次改动挑进"待存档的篮子"。通常和 commit 连着做。	(一般不单独说,合在"帮我存检查点"里)	它接着会执行 commit,你看下面 commit 那行的结果即可。
`git commit`	这一版改完、当前一切正常,想存一个检查点。	"帮我存一个检查点,说明写'首页做好了'。"	终端打印一行带编号和你那句说明的结果,例如 `[main 9f3a1c7] 首页做好了`。
`git log`	想看存过哪些检查点、要回退前先找好版本。	"让我看看存过哪些检查点。"	列出从新到旧一串检查点,每条带编号和说明(见下一节怎么读)。
`git restore`	改了一堆还没存,想全部撤掉、回到上一个检查点干净的样子。	"这次改动不要了,撤回到上一个检查点。"	文件立刻变回上一个检查点的样子,刚才的乱改消失。

命令

什么时候用(触发)

你对 Agent 说的人话

怎么确认成功

git init

一个新项目第一次要开始存档。一个项目只做一次。

"帮我给这个项目开启 Git 存档(git init)。"

它回一句类似"已初始化空的 Git 仓库",之后再让它存档不报"不是一个 Git 仓库"的错。

git add

改了文件,准备把这次改动挑进"待存档的篮子"。通常和 commit 连着做。

(一般不单独说,合在"帮我存检查点"里)

它接着会执行 commit,你看下面 commit 那行的结果即可。

git commit

这一版改完、当前一切正常,想存一个检查点。

"帮我存一个检查点,说明写'首页做好了'。"

终端打印一行带编号和你那句说明的结果,例如 [main 9f3a1c7] 首页做好了。

git log

想看存过哪些检查点、要回退前先找好版本。

"让我看看存过哪些检查点。"

列出从新到旧一串检查点,每条带编号和说明(见下一节怎么读)。

git restore

改了一堆还没存,想全部撤掉、回到上一个检查点干净的样子。

"这次改动不要了,撤回到上一个检查点。"

文件立刻变回上一个检查点的样子,刚才的乱改消失。

2. 会看 git log:哪行是"上一个好版本"

回退前,你唯一要做的判断是:在 git log 里指出哪行是还正常的版本。下面这段仿终端示意,帮你认清怎么读。

$ git log --oneline 9f3a1c7 迁框架迁到一半 # 最上面是最新,常常正是坏的这版 2b8d4e0 首页做好了 a17c9f2 迁框架前的干净版本 # 你确定当时正常,退就退到它

存检查点时,说明写得越具体越好。"迁框架前的干净版本"远比"更新一下"有用,因为它就是你日后要退回的那个目的地。

3. 两种后悔药

情况 A · 还没存就坏了

情况 B · 已经存了坏版本

动大手术前,先存一个干净点。迁框架这类大改动之前,先让 Agent 存一个说明清楚的干净检查点(比如"迁框架前的干净版本")。它就是你情况 B 要退回的目的地。没有它,翻车了就没地方退。