序言

本教程由「小荣的网络开发日志」实操整理编写，实操踩坑验证，内容真实可靠。

遇到操作问题可直接联系作者，转载需标注原文出处，禁止私自篡改商用。

承接网站、APP、小程序、各类脚本定制开发；

AI 编程教学、一对一项目全程陪跑，提供免费技术咨询。

联系方式： 微信：rongyaolg 电话：18375295913

功能回退 && 代码版本管理

学 AI 编程，一定要先学会保存版本。

因为 AI 很方便，但它也可能一次性改很多文件：页面能跑的时候，它帮你优化；页面改坏的时候，也可能把原来能用的功能弄乱。

Git 的作用就是给项目做“存档”。每完成一个小功能，就保存一次。以后 AI 改坏了，你可以看清楚它改了哪里，也可以回到之前还能正常运行的版本。

这篇教程默认你已经装好了 Git。还没安装的同学，先看：Git 入门安装与使用教程

1. 为什么每个项目都要用 Git

不管你用的是 VS Code、Cursor、Kiro、Trae、CodeBuddy，还是配合 Claude Code、Codex CLI 这种终端工具，项目代码最终都是一堆文件。

只要你在改文件，就会遇到这些问题：

一句话：

AI 每完成一个功能，你就用 Git 保存一个版本。

2. 推荐工作流：小步修改，小步保存

小白最容易犯的错是：一天写完很多功能，最后才保存一次。

这样很危险。因为中间任何一步出错，你都不知道从哪里开始坏的。

推荐节奏如下：

复制打开项目
  ↓
确认当前项目能运行
  ↓
让 AI 修改一个小功能
  ↓
运行项目，确认没问题
  ↓
提交一次 Git 版本
  ↓
继续下一个功能

每次提交只做一件事，比如：

• 新增登录页面
• 修复首页按钮样式
• 接入用户列表接口
• 调整移动端布局
• 删除无用代码

不要一次提交“登录 + 支付 + 后台 + 部署配置”。以后想回退其中一个功能会很麻烦。

3. 所有编辑器都差不多：先找左侧 Git 按钮

大多数编辑器左侧都会有一个类似“分支/节点/源代码管理”的按钮。

不同工具名字可能不一样：

如果你找不到，可以按快捷键打开命令面板：

然后搜索：

复制Source Control
Git

4. 建议安装 GitLens

GitLens 是一个 Git 可视化插件，可以让你更容易看懂代码是谁改的、什么时候改的、每次提交改了什么。

建议在 VS Code、Cursor、Trae、Kiro、CodeBuddy 这类兼容 VS Code 插件生态的编辑器里安装。

安装方式通常类似：

1. 打开左侧“扩展”面板。
2. 搜索 GitLens。
3. 找到 GitLens 后点击安装。
4. 安装完成后，重新打开项目。

如果某个编辑器的插件市场搜不到 GitLens，也不用慌。它通常也会自带基础 Git 面板，你仍然可以完成查看改动、提交和回退。

GitLens 主要帮你做三件事：

5. 第一次给项目开启 Git

如果你的项目还没有 Git 仓库，先在项目根目录执行：

复制git init

然后查看当前状态：

复制git status

如果看到很多红色文件，说明这些文件还没有被 Git 保存过。

第一次提交：

复制git add .
git commit -m "初始化项目"

以后这个项目就有第一个存档点了。

6. 每次 AI 修改后，先看改动

AI 改完代码后，不要马上继续让它做下一个功能。

先做三件事：

1. 打开左侧 Git / Source Control 面板。
2. 看看有哪些文件被修改。
3. 点开文件对比，确认改动是不是你要的。

你会看到类似这样的变化：

复制修改：src/pages/index.tsx
修改：src/components/Navbar.tsx
新增：src/components/LoginForm.tsx
删除：src/old-demo.ts

重点看这几类文件：

如果 AI 修改了你没要求它改的地方，可以先不要提交，让 AI 解释原因，或者直接回退那部分改动。

7. 确认能运行，再提交

提交前最好先运行项目。

常见命令：

复制npm run dev
npm run build
npm test

不是每个项目都有这些命令，具体看你的项目说明。

确认没问题后再提交：

复制git add .
git commit -m "新增登录页面"

提交说明要写人话，不要写：

复制update
fix
改了一下
111

推荐写成：

复制新增登录页面
修复移动端导航栏错位
接入用户列表接口
优化课程卡片样式

以后你回头找版本，会非常清楚。

8. AI 改坏了，怎么回退

情况一：还没提交，只想撤销本次修改

如果 AI 改完后你发现完全不对，而且你还没有提交，可以丢弃当前改动。

查看改了什么：

复制git status

丢弃某个文件的修改：

复制git checkout -- 文件路径

比如：

复制git checkout -- src/pages/index.tsx

如果你确定本次所有改动都不要了：

复制git reset --hard

注意：这个命令会丢弃所有未提交修改。执行前一定确认当前改动真的不要了。

情况二：已经提交了，但想回到上一个版本

先查看提交记录：

复制git log --oneline

你会看到类似：

复制a1b2c3d 新增登录页面
e4f5g6h 初始化项目

如果只是想撤销某一次提交，推荐用：

复制git revert 提交ID

例如：

复制git revert a1b2c3d

revert 会生成一个新的提交，用来抵消之前的错误修改。它比较适合小白和多人合作，因为历史记录还在，不容易把别人代码弄乱。

情况三：想回到某个版本重新开始

如果是你自己的本地项目，还没有推送给别人，可以使用：

复制git reset --hard 提交ID

但这个命令会把当前代码直接变成指定版本，后面的提交可能会丢失。

小白优先记住：

9. 用编辑器可视化操作

如果你不想记命令，也可以用编辑器完成。

一般流程是：

1. 点击左侧 Git / Source Control 按钮。
2. 查看“Changes / 更改”列表。
3. 点开文件，看红色和绿色对比。
4. 确认没问题后，输入提交说明。
5. 点击 Commit / 提交。
6. 如果连了远程仓库，再点击 Push / Sync。

回退时，一般可以：

• 右键某个文件，选择“Discard Changes / 放弃更改”。
• 在提交记录里找到旧版本，查看详情。
• 使用 GitLens 查看文件历史。
• 需要完整回退时，再配合命令操作。

不同编辑器按钮位置略有不同，但逻辑一样：

复制查看改动 → 确认没问题 → 写提交说明 → 提交 → 推送

10. 多人合作时一定要先拉取

如果你的项目不止你一个人写，或者你在多台电脑之间切换，开始工作前先拉取最新代码：

复制git pull

做完功能后：

复制git add .
git commit -m "你的修改说明"
git push

多人合作最常见的问题是冲突。

冲突的意思是：你和别人改了同一个地方，Git 不知道该保留谁的。

遇到冲突不要慌：

1. 打开冲突文件。
2. 看清楚哪部分是你的，哪部分是别人的。
3. 保留正确代码，删掉冲突标记。
4. 运行项目确认没问题。
5. 重新提交。

如果你不确定怎么处理，把冲突文件内容发给 AI，让它解释每一段是什么意思，再决定保留哪部分。

11. 推荐提交频率

记住这个规则：

一个可验证的小功能 = 一次提交。

比如：

尤其是用 AI 编程时，推荐每 10 到 30 分钟检查一次改动。

如果某一步已经确认能运行，就赶紧保存版本。

12. 最适合小白的日常清单

每次让 AI 改功能前，先问自己：

• 当前项目能不能正常运行？
• 上一个正常版本有没有提交？
• 我这次只让 AI 改一个小功能吗？

AI 改完后：

• 看左侧 Git 面板，确认改了哪些文件。
• 运行项目，确认没报错。
• 功能没问题就提交。
• 功能有问题就先回退或让 AI 解释。

最后记住一句话：

不要等项目写完才用 Git。Git 是边写边存，不是最后备份。