15 用 Git 管理正式项目：版本管理，不怕 AI 改错公开

#一、课程回顾

上节课我们升级了开发环境（Warp 终端 + Claude Code + 增强插件），已经具备了更强的工具基础。从这节课开始，我们正式进入项目实战。但在此之前，必须先补上一个从第一节课到现在一直存在的隐患——你的项目文件，改错了就找不回来了。

#二、本节重点

一句话：给你的项目装上"后悔药"和"保险箱"——用 Git 做版本管理，用 Gitee 做云端备份。

完成后你将拥有：

• ✅ 每次改动都能存档，随时回退到任意版本（不怕 AI 改错）
• ✅ 项目自动备份到云端（不怕电脑坏了、换电脑了）
• ✅ 不用记一条 Git 命令，全部让 AI 帮你操作

#三、为什么需要版本管理

从开始学到现在，你大概率遇到过这些情况：

有了 Git 之后：

• 每完成一步就"存个档"，相当于游戏存档点
• 出错了，一句话让 AI 帮你回到任意一个存档点
• 自动备份到 Gitee 云端，电脑坏了也不怕

#四、Git 是什么（一分钟听懂）

• Git 就是给你的项目"存档"的工具——像玩游戏一样，每过一关存一次档，挂了能读档重来
• 或者理解为**"时光机"**：能随时回到项目过去的任何一个时间点
• 第 02 课我们已经装过 Git 了（终端里输入 git -v 能看到版本号就说明装好了）

💡 重点：这节课不教你记 Git 命令。你是产品经理，Git 操作全部让 Claude Code（或 OpenCode）帮你做。你只需要懂"什么时候该存档、什么时候该回退"这个逻辑。

#五、用 AI 做本地版本管理

这部分是核心，体现 Vibe Coding 理念——不用记命令，让 AI 代劳。

#首次使用 Git：配置你的身份（只需做一次）

在第一次用 Git 之前，需要告诉 Git"你是谁"——这样每次提交存档时，Gitee 才能识别这是你提交的。这个配置是全局的，一台电脑只需配置一次，以后所有项目通用。

💡 你在 Gitee 创建仓库后，会看到这样的提示： git config --global user.name '你的用户名' git config --global user.email '你的邮箱' 这就是身份配置。不用自己敲命令，让 AI 帮你做。

对 AI 说：

这是我第一次使用 Git，请帮我配置全局的提交身份：
- 用户名：（填你的 Gitee 用户名）
- 邮箱：（填你注册 Gitee 的邮箱）
配置完成后告诉我结果。

AI 会一次性配好，以后这台电脑上所有 Git 项目都会自动带上你的身份。

#1. 给项目开启 Git（初始化）

打开一个已有项目（比如之前的工具箱），对 AI 说：

帮我用 Git 把这个项目管理起来，初始化仓库，并把当前所有文件做第一次提交，提交说明是"项目初始版本"。

AI 会自动执行初始化 + 第一次存档。

#2. 每完成一个功能就存档（提交）

这是最重要的工作习惯。每做完一个小功能，就对 AI 说：

帮我提交当前的改动，提交说明是"完成了 Excel 合并的隐藏工作表功能"。

💡 存档的节奏：每完成一个小功能、每修复一个 Bug、每天收工前，都让 AI 提交一次。存档越多，后悔药越足。

#3. AI 改坏了？回到上一个版本（回退）

这是 Git 最救命的功能。当 AI 把项目改崩了：

AI 刚才的修改把功能改坏了，帮我回退到上一个版本。

或者更精准地：

帮我看看最近的提交历史，我想回到"完成了 Excel 合并功能"那个版本。

AI 会列出所有存档点，你选一个，它帮你读档。

#4. 查看改了什么（对比）

帮我看看这次改动都修改了哪些文件、改了什么内容。

#六、Gitee 云端同步（国内备份）

本地存档解决了"改错能回退"的问题，但如果电脑坏了、丢了，本地存档也没了。所以还需要把项目备份到云端。

#1. 为什么用 Gitee 而不是 GitHub

Gitee 是国内版的 GitHub，功能一样，但国内访问又快又稳。网址：https://gitee.com

#2. 注册 Gitee 账号

• 打开 https://gitee.com，点右上角「注册」
• 用手机号或邮箱注册都可以，建议用国内邮箱（QQ、163 等），避免收不到验证邮件
• ⚠️ 注册时填的**「个人空间地址」一经选定无法修改**，建议用拼音全称（比如 wwc），它就是你在 Gitee 的唯一标识
• 注册后按提示绑定手机号（不绑定部分功能会受限）

#3. 创建一个仓库（云端项目空间）

• 登录后，点页面右上角的 「+」 → 「新建仓库」
• 填写：
  • 仓库名称：用英文，比如 tool-box（命名规则：字母/数字开头，支持 - _）
  • 是否开源：选**「私有」**（只有你自己能看到，更安全）
  • ⚠️ 不要勾选「初始化仓库」——我们要把本地已有项目推上去，创建一个空仓库最简单，避免冲突
• 点「创建」，完成后会看到仓库页面

#4. 创建 SSH 密钥（让 AI 帮你生成）

SSH 是一种安全的连接方式。我们要在本地生成一把"钥匙"，把其中一半（公钥）交给 Gitee，以后推送就免密了。

对 AI 说：

帮我生成一对 SSH 密钥，用于连接 Gitee。生成后把公钥内容显示给我，我要复制到 Gitee 上。

AI 会执行生成命令（用的是 ed25519 算法，目前推荐），然后把公钥显示给你，内容大概是这个样子（以 ssh-ed25519 开头的一长串）：

ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAI... Gitee SSH Key

复制这整段公钥内容（从 ssh-ed25519 一直到结尾，一个字都不能少）。

#5. 把公钥添加到 Gitee（手动，一次性）

这一步必须在 Gitee 网页上操作，AI 帮不了你：

1. 点 Gitee 右上角头像 → 「个人设置」
2. 左侧菜单找 「安全设置」 → 「SSH 公钥」
3. 在「标题」填一个好认的名字（比如 我的电脑）
4. 在「公钥」粘贴刚才复制的整段公钥
5. 点「确定」，会要求输入 Gitee 登录密码确认，输入后添加成功

⚠️ 一定要加在「个人设置 → SSH 公钥」里，不要加在仓库的「部署公钥」里（部署公钥只能读不能写）。

#6. 验证 SSH 连接（让 AI 帮你测）

对 AI 说：

帮我验证一下 SSH 连接到 Gitee 是否成功。

AI 会执行验证命令。如果成功，会看到类似这样的提示：

Hi 你的用户名! You've successfully authenticated...

如果第一次连接弹出 Are you sure you want to continue connecting (yes/no)?，输入 yes 回车即可（只会问一次）。

#7. 把项目连接到 Gitee 并首次推送

回到 Gitee 仓库页面，点「克隆/下载」，复制 SSH 地址（形如 git@gitee.com:你的用户名/tool-box.git）。

对 AI 说：

我已经在 Gitee 创建了空仓库，SSH 地址是 git@gitee.com:我的用户名/tool-box.git（换成你自己的）。
请帮我把本地项目连接到这个远程仓库，并把代码推送上去。

AI 会自动完成连接 + 推送。推送成功后，刷新 Gitee 仓库页面，你就能看到自己的项目文件躺在云端了。

#8. 以后每次同步

本地提交后，想同步到云端，对 AI 说：

帮我把最新的提交同步到 Gitee。

💡 因为配好了 SSH，以后所有同步都是全自动免密的，AI 一句话搞定。

#七、完整实操演示（跟着做一遍）

用一个最小项目 git-demo，4 步走通 Git 的核心用法。不依赖任何之前的项目，零基础也能跟着做。

#准备：新建演示项目

• 新建文件夹 git-demo，里面放一个 说明.txt，随便写点内容（比如"这是我的第一个 Git 项目"）
• 在 Warp 里打开这个文件夹，启动 Claude Code

前提：第六部分的 Gitee 注册、创建仓库、SSH 密钥配置都已经完成。

#第 1 步 — 开启 Git 并首次存档

对 AI 说：

帮我用 Git 管理这个项目，初始化仓库，并做第一次提交，提交说明是"项目初始版本"。

结果： AI 完成 Git 初始化，把当前文件存为第一个版本。从此你的项目有了"存档"能力。

#第 2 步 — 做个改动，再存一次档

手动操作： 在 git-demo 里新建一个 功能笔记.txt，写点内容。

对 AI 说：

我新增了一个"功能笔记.txt"，帮我提交这次的改动，提交说明是"添加功能笔记"。

结果： AI 把新增的文件存为第二个版本。现在你有两个存档点了。

#第 3 步 — 模拟"改坏了"，然后回退（最救命的一步）

手动操作： 故意把 功能笔记.txt 的内容全删掉、保存（模拟 AI 改崩或自己手滑）。

对 AI 说：

我不小心把"功能笔记.txt"的内容删光了，帮我回退到上一个版本。

结果： AI 帮你读档，说明.txt 的内容完整恢复！这就是 Git 的"后悔药"。

💡 学员体感时刻：这一步最能打动零基础学员——亲眼看着被删掉的内容"复活"，立刻明白 Git 为什么值得用。

#第 4 步 — 同步到 Gitee 云端

前提： 你已在 Gitee 创建了空仓库 git-demo，SSH 已配置好。复制仓库的 SSH 地址。

对 AI 说：

我已经在 Gitee 创建了空仓库，SSH 地址是 git@gitee.com:wwwwwc/git-demo.git。
请帮我把本地项目连接到这个仓库，并把代码推送上去。

结果： AI 自动配置连接 + 推送。打开 Gitee 仓库页面，你能看到 说明.txt 和 功能笔记.txt 都已经在云端了——电脑坏了也不怕。

走完这 4 步，你就掌握了 Git 的全部核心用法：存档、回退、云端备份。以后做正式项目，把 git-demo 换成你的真实项目，流程一模一样。

#八、建立日常 Git 工作习惯

把 Git 融入 Vibe Coding 五步工作流，推荐的每日节奏：

💡 一句话口诀：勤提交、常同步、出事能回退。把 Git 当成你项目的"自动保险"，而不是额外负担。

#进阶：让 AI 自动提交（写进 AGENTS.md）

如果你觉得每次都要手动对 AI 说"帮我提交"太麻烦，又怕自己忘记，有一个一劳永逸的办法——把"自动提交"写进 AGENTS.md。

还记得 AGENTS.md 吗？它是项目的"操作手册"，AI 每次开工都会读它。我们只要在里面加一条规则，AI 以后每次改完代码就会自动提交，不用你再提醒。

对 AI 说：

帮我在 AGENTS.md 里增加一条规则：每次你完成代码修改后，请自动用 Git 提交这次改动，提交说明用一句话简要概括本次修改的内容。同时备份到Gitee。这样我就不用每次手动提醒你了。

AI 会把这条规则写进 AGENTS.md。以后无论你让 AI 做什么改动，它做完都会顺手提交一次，你的项目始终处于"已存档"状态，后悔药随时备着。

💡 这就是 Vibe Coding 的精髓——把你的工作习惯，变成 AI 的自动行为。你定规矩，AI 执行，你只管提需求。

#划重点

#下一节课预告

下一节课，我们正式开始第三部分的核心内容——让 AI 读懂文件。我们会学习用 MinerU 和 OCR 技术，从 PDF、图片里自动提取文字，为后续的发票整理、合同条款提取打好基础。