第 4 章:Git:存档、看改动、退回去
本章目标:给周报生成器建一个 Git 仓库,学会存档;文件被改坏了能看清改了什么、一条命令退回去;已经存了档的错误改动也能撤销。
开篇:游戏里的存档
打游戏打 Boss 之前,你会先存个档。打输了,读档重来,不用从头开始。
Git 就是代码的存档系统。改之前存一个档,改坏了读档。区别是 Git 的每一个档都留着,什么时候存的、改了哪几行、为什么改,都查得到。
现在这件事比以前更重要:AI 编程工具改代码又快又多,一次能改好几个文件。改好了还好,改坏了,没有存档你很难说清它到底动了哪里。
学完这一章,你能:
- 检查和安装 Git,做好第一次配置
- 用
init、add、commit存档,用status、log看状态 - 文件改坏了:用
diff看改了什么,用restore退回去 - 已经存了档的错误改动:用
revert撤销
本章所有输出都是我在 macOS 上真实运行的结果,只把用户文件夹的路径换成了 ~。
4.1 装好、配好
先看装没装:
git --version我这台显示 git version 2.39.3 (Apple Git-145)。显示版本号就是装好了。
没装的话:macOS 上第一次敲 git 会弹窗提示安装「命令行开发者工具」,点安装就行;Windows 去 git-scm.com 下载安装包,一路默认。
然后做一次性的配置,告诉 Git 你是谁(会写进每个存档里):
git config --global user.name "你的名字"
git config --global user.email "你的邮箱"
git config --global init.defaultBranch main第三行是把默认分支名设成 main,和 GitHub 保持一致。不设也能用,只是会叫 master。
4.2 第一次存档
在周报生成器的文件夹里:
% cd ~/projects/weekly-report
% git init
Initialized empty Git repository in ~/projects/weekly-report/.git/git init 在这个文件夹里建了一个隐藏的 .git 文件夹,所有存档都放在里面。从现在起,这个文件夹就是一个仓库。
看看现在的状态:
% git status
On branch main
No commits yet
Untracked files:
(use "git add <file>..." to include in what will be committed)
notes.md
weekly.py
nothing added to commit but untracked files present (use "git add" to track)两个文件都是 Untracked(还没被 Git 管起来)。存档分两步:先挑出要存的,再存。
% git add weekly.py notes.md
% git status
On branch main
No commits yet
Changes to be committed:
(use "git rm --cached <file>..." to unstage)
new file: notes.md
new file: weekly.py
% git commit -m "周报生成器:能数出本周记录条数"
[main (root-commit) ae7c7a3] 周报生成器:能数出本周记录条数
2 files changed, 8 insertions(+)
create mode 100644 notes.md
create mode 100644 weekly.py| 命令 | 意思 |
|---|---|
git add 文件 | 把这个文件的当前样子放进「准备存档」的篮子里 |
git commit -m "说明" | 把篮子里的东西存成一个档,附一句说明 |
git status | 看现在什么状态:哪些改了、哪些在篮子里 |
ae7c7a3 是这个存档的编号,每个人的都不一样。说明要写清楚改了什么,半年后你看历史时会感谢自己。
看看历史:
% git log --oneline
ae7c7a3 周报生成器:能数出本周记录条数4.3 改坏了:diff 看清,restore 退回
假设你让 AI 帮忙「简化一下代码」,它改完以后,一运行:
% python3 weekly.py
FileNotFoundError: [Errno 2] No such file or directory: 'note.md'先问 Git:哪些文件变了?
% git status
On branch main
Changes not staged for commit:
(use "git add <file>..." to update what will be committed)
(use "git restore <file>..." to discard changes in working directory)
modified: weekly.py
no changes added to commit (use "git add" and/or "git commit -a")weekly.py 被改了。具体改了什么?
% git diff
diff --git a/weekly.py b/weekly.py
index 9398379..9fde624 100644
--- a/weekly.py
+++ b/weekly.py
@@ -1,5 +1,4 @@
from pathlib import Path
-notes = Path("notes.md").read_text(encoding="utf-8")
-lines = [l for l in notes.splitlines() if l.strip()]
-print(f"本周一共 {len(lines)} 条记录")
+notes = Path("note.md").read_text(encoding="utf-8")
+print(f"本周一共 {len(notes.splitlines())} 条记录")读法:- 开头的是原来的,+ 开头的是现在的。一眼就看出问题:文件名被改成了 note.md,少了个 s;而且原来会跳过空行,现在不跳了,记录里有空行时数字就不对了。
不想要这次改动,一条命令退回到上次存档的样子:
% git restore weekly.py
% python3 weekly.py
本周一共 3 条记录
% git status
On branch main
nothing to commit, working tree cleanworking tree clean 的意思是:现在的文件和最后一次存档一模一样。
restore 也是不可撤销的
git restore 会直接丢掉还没存档的改动。如果改动里有你想留的部分,先用 git diff 看清楚,或者先存个档再说。
4.4 已经存了档:revert 撤销
有时候改坏的东西已经 commit 了才发现。比如又存了两个档:
% git commit -am "加一句提醒"
[main 4b2225e] 加一句提醒
1 file changed, 1 insertion(+)
% git commit -am "AI 帮忙重构了一下"
[main a49b19e] AI 帮忙重构了一下
1 file changed, 1 insertion(+), 1 deletion(-)
% git log --oneline
a49b19e AI 帮忙重构了一下
4b2225e 加一句提醒
ae7c7a3 周报生成器:能数出本周记录条数(-am 是「把所有已经被管起来的文件的改动一起 add 再 commit」的简写。)
结果「重构」那次把文件名又改错了。撤销最近这一次存档:
% git revert HEAD --no-edit
[main a3df804] Revert "AI 帮忙重构了一下"
Date: Tue Nov 10 14:00:00 2026 +0800
1 file changed, 1 insertion(+), 1 deletion(-)
% python3 weekly.py
本周一共 3 条记录
记得周五前发出去
% git log --oneline
a3df804 Revert "AI 帮忙重构了一下"
a49b19e AI 帮忙重构了一下
4b2225e 加一句提醒
ae7c7a3 周报生成器:能数出本周记录条数注意两点:
- 「加一句提醒」那次的改动还在(输出多了「记得周五前发出去」),只撤掉了最近那一次
revert不是把历史擦掉,而是新存一个档,内容正好抵消那次改动。历史里四个档都在,谁改了什么、后来又怎么撤的,一清二楚
HEAD 指最近的那个存档。想撤更早的某一次,把 HEAD 换成那次的编号,比如 git revert 4b2225e。
网上常见的 reset --hard 先别用
你会在网上看到 git reset --hard,它能把历史直接退回到某个存档,后面的存档都不要了。它很好用,也很容易丢东西。刚开始只用 restore 和 revert 就够了。
4.5 什么时候存档
| 时机 | 为什么 |
|---|---|
| 让 AI 改代码之前 | 改坏了能退回来;改完 git diff 一看就知道它动了哪里 |
| 一个小功能做完、能跑了 | 一个档对应一件事,说明好写,撤销也干净 |
| 下班前、关电脑前 | 不会有一大堆改动混在一起说不清 |
不用每改一行就存一次,也别攒了一周才存一次。
试一试
- [ ] 在
weekly-report里git init,把两个文件存成第一个档 - [ ] 故意把
notes.md改成note.md,用git diff看改动,再用git restore退回 - [ ] 加一行代码存个档,再用
git revert HEAD撤掉它,看git log里出现了什么
本章小结
| 要点 | 说明 |
|---|---|
| 配置 | user.name、user.email、init.defaultBranch main,只做一次 |
| 存档 | git add 挑文件 → git commit -m "说明" 存档 |
| 看状态 | git status 看哪些变了;git log --oneline 看历史 |
| 看改动 | git diff:- 是原来的,+ 是现在的 |
| 没存档的改动 | git restore 文件 退回到上次存档 |
| 存了档的改动 | git revert 编号 新存一个档把它抵消,历史都留着 |
下一章预告
仓库建好了。可文件夹里还有一个
.env,里面是你的 Key。下次git add .一不小心就把它存进去了,再推到 GitHub,就是公开的。下一章讲
.gitignore,以及 Key 真的传上去以后该怎么办。