Skip to content

第 4 章:Git:存档、看改动、退回去 ​

本章目标:给周报生成器建一个 Git 仓库,学会存档;文件被改坏了能看清改了什么、一条命令退回去;已经存了档的错误改动也能撤销。

开篇:游戏里的存档 ​

打游戏打 Boss 之前,你会先存个档。打输了,读档重来,不用从头开始。

Git 就是代码的存档系统。改之前存一个档,改坏了读档。区别是 Git 的每一个档都留着,什么时候存的、改了哪几行、为什么改,都查得到。

现在这件事比以前更重要:AI 编程工具改代码又快又多,一次能改好几个文件。改好了还好,改坏了,没有存档你很难说清它到底动了哪里。

学完这一章,你能:

  • 检查和安装 Git,做好第一次配置
  • 用 init、add、commit 存档,用 status、log 看状态
  • 文件改坏了:用 diff 看改了什么,用 restore 退回去
  • 已经存了档的错误改动:用 revert 撤销

本章所有输出都是我在 macOS 上真实运行的结果,只把用户文件夹的路径换成了 ~。


4.1 装好、配好 ​

先看装没装:

bash
git --version

我这台显示 git version 2.39.3 (Apple Git-145)。显示版本号就是装好了。

没装的话:macOS 上第一次敲 git 会弹窗提示安装「命令行开发者工具」,点安装就行;Windows 去 git-scm.com 下载安装包,一路默认。

然后做一次性的配置,告诉 Git 你是谁(会写进每个存档里):

bash
git config --global user.name "你的名字"
git config --global user.email "你的邮箱"
git config --global init.defaultBranch main

第三行是把默认分支名设成 main,和 GitHub 保持一致。不设也能用,只是会叫 master。


4.2 第一次存档 ​

Git 的三个地方:你正在改的文件、准备存档的暂存区、已经存好的历史;add 放进暂存区,commit 存进历史,restore 和 revert 用来退回

在周报生成器的文件夹里:

text
% cd ~/projects/weekly-report
% git init
Initialized empty Git repository in ~/projects/weekly-report/.git/

git init 在这个文件夹里建了一个隐藏的 .git 文件夹,所有存档都放在里面。从现在起,这个文件夹就是一个仓库。

看看现在的状态:

text
% 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 管起来)。存档分两步:先挑出要存的,再存。

text
% 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 是这个存档的编号,每个人的都不一样。说明要写清楚改了什么,半年后你看历史时会感谢自己。

看看历史:

text
% git log --oneline
ae7c7a3 周报生成器:能数出本周记录条数

4.3 改坏了:diff 看清,restore 退回 ​

假设你让 AI 帮忙「简化一下代码」,它改完以后,一运行:

text
% python3 weekly.py
FileNotFoundError: [Errno 2] No such file or directory: 'note.md'

先问 Git:哪些文件变了?

text
% 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 被改了。具体改了什么?

text
% 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;而且原来会跳过空行,现在不跳了,记录里有空行时数字就不对了。

不想要这次改动,一条命令退回到上次存档的样子:

text
% git restore weekly.py
% python3 weekly.py
本周一共 3 条记录
% git status
On branch main
nothing to commit, working tree clean

working tree clean 的意思是:现在的文件和最后一次存档一模一样。

restore 也是不可撤销的

git restore 会直接丢掉还没存档的改动。如果改动里有你想留的部分,先用 git diff 看清楚,或者先存个档再说。


4.4 已经存了档:revert 撤销 ​

有时候改坏的东西已经 commit 了才发现。比如又存了两个档:

text
% 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」的简写。)

结果「重构」那次把文件名又改错了。撤销最近这一次存档:

text
% 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 真的传上去以后该怎么办。

👉 第 5 章:.gitignore 和 GitHub

本文阅读--次|全站访问--次|访客--人