VVibeCoding 助手
🧯 第 03 阶段 · 避坑零基础友好

Git 到底是什么:版本管理、备份与命令行入门

用大白话搞懂 Git 是什么、有什么用,以及每句命令行代码到底在说什么,改错了也能退回去。

⏱ 25 分钟 · ☑ 5 个实操任务

为什么要备份

AI 动手改文件,本质上是把「改错了怎么办」的悬念交给了你。没有备份,一次乱改可能毁掉你几个小时的心血。有了备份,你随时能说一句:回到刚才那个版本。

Git 到底是什么(大白话)

Git 是一个给文件夹拍照存档的工具,它像一个「时间机器 + 隐形账本」:

  • 你随时可以给整个项目拍一张「快照」(叫提交 / commit)
  • 所有快照按时间排成一条历史记录
  • 想回到哪一张快照,说一声就回去

Git 本身是一个命令行程序:它没有好看的界面,你通过「终端 / PowerShell」里敲命令来指挥它。这也是为什么教程里会出现一串代码。

好消息:Codex 桌面应用自带 Git 面板,你可以在界面里看到改动、提交和回滚,不用记命令。WorkBuddy 里也可以直接用 Git 命令。但看懂基础命令,你会更清楚自己到底在做什么。

Git 有什么用

  1. 随时回到过去:改坏了,退回上一张快照
  2. 清楚看到改动:谁改了什么、改了多少行,一目了然
  3. AI 协作的安全网:每次让 AI 动手前先存档,它随便改你都不怕

命令行代码都是什么意思

先学会「读命令」的方法:命令行代码 = 程序名 + 动作 + 参数。

比如 git add -A:

  • git:要用的程序(Git)
  • add:动作,把文件加进「待存档」列表
  • -A:参数,意思是「全部」(All)

整句话翻译:让 Git 把这里所有改动都放进待存档列表。

常用命令对照表

命令大白话翻译什么时候用
git init对这个文件夹开启存档功能项目刚开始时用一次
git status看看现在有哪些改动、哪些还没存档让 AI 动手前后各看一眼
git diff看看具体改了哪几行、改成什么样判断 AI 有没有乱动
git add -A把所有改动放进「待存档」篮子提交前
git commit -m "说明"拍一张快照,并写上这张快照的名字每个稳定版本拍一次
git checkout -- .把没存档的改动全部扔掉,回到上一张快照改坏了要退回时
git log查看历史快照列表想回忆之前提交过什么

三个最容易看晕的命令,拆开讲

git add -A

  • -A 是 --all 的缩写,意思是「全部」
  • 别漏了 -A:没有它,Git 不知道你要存档哪些文件

git commit -m "提交当前状态"

  • -m 是 message(留言)的缩写,后面引号里的字就是这张快照的「名字」
  • 名字要写得看得懂,比如「完成个人主页第一版」,别写「111」

git checkout -- .

  • checkout 动作:把文件恢复到某个状态
  • -- 表示「后面跟着的是文件路径,不是别的参数」
  • . 表示「当前文件夹里的所有文件」
  • 连起来:把当前文件夹所有文件恢复到上次存档的样子

⚠️ 这条命令会丢弃所有未提交的改动。执行前确认:当前不想保留的东西都没有了。

三步走:先提交,再让 AI 改

第一步:初始化

在项目文件夹里打开终端,运行一次:

git init

第二步:提交当前状态

每次「让 AI 动手之前」,先提交一张快照:

git add -A
git commit -m "提交当前状态,准备让 AI 修改"

第三步:改坏了就回滚

如果 AI 改完你不满意,把改动全部退回:

git checkout -- .

在 Codex 界面里怎么看改动

Codex 桌面应用的 diff 面板会显示 AI 改了哪些文件、改了哪几行:

  • 绿色:新增的内容
  • 红色:删除的内容
  • 你可以在面板里给 AI 留意见,也可以逐块选择保留或放弃

看不懂代码没关系,看「文件名字 + 改动多少行」就能判断它有没有乱动。

一个安全的工作节奏

提交当前状态 → 让 AI 改 → 看 diff → 满意就提交新版本 / 不满意就回滚

把这个节奏固定下来,你就拥有了「随便试错」的底气。

命令记不住怎么办

不用背。每次忘了,直接把问题丢给 AI:

我想把项目恢复到上一次提交的样子,该用什么命令?用大白话解释每一步。

或者把报错贴给它:

我运行 [命令] 报了这个错:[报错]。告诉我这是什么意思、下一步该做什么。

新手最容易卡住的两个问题

1. 提示「Please tell me who you are」

Git 不知道你是谁,先设置一次:

git config --global user.name "你的名字"
git config --global user.email "你的邮箱"

2. 中文文件名显示成乱码

运行:

git config --global core.quotepath false

除了 Git,还有两件事

  • 重要文件单独备份:比如照片、文稿,可以定期复制到网盘或移动硬盘
  • 不要把重要项目放在临时文件夹:C 盘系统盘或下载文件夹都不安全

下一步

基础版 Git 你已经会了。进阶模块还会教分支、合并、冲突,以及怎么用 GitHub 协作:去进阶模块看看。