来源：https://github.com/datawhalechina/vibe-vibe

学会了工具的基本操作，接下来是一些让版本管理更有效的技巧。

Commit 信息怎么写

每次 Commit 都需要写一句描述。好的描述能让你快速找到需要的版本。

好的写法

✅ "添加任务删除功能"
✅ "修复刷新后数据丢失的问题"
✅ "调整按钮颜色为蓝色"
✅ "第四章完成版"
✅ "准备添加深色模式前的备份"

特点：

• 说清楚做了什么
• 一眼就能看懂

不好的写法

❌ "修改了一些东西"
❌ "update"
❌ "fix"
❌ "..."
❌ "1"

问题：

• 看不出做了什么
• 以后找版本时完全没帮助

简单原则

用一句话描述"这次改动做了什么"。

不需要写得很正式，只要自己以后能看懂就行。

多久 Commit 一次

原则：完成一个小功能就 Commit。

推荐的 Commit 时机

• 添加了一个新功能
• 修复了一个问题
• 调整了样式/布局
• 重构了代码结构
• 准备下班/休息

不要等到"完美"了再 Commit。半成品也可以 Commit，反正随时可以继续改。

什么文件应该/不应该提交

有些文件应该纳入版本管理，有些不应该。

应该提交的文件

• 你写的代码（HTML、CSS、JavaScript 等）
• 项目配置文件
• 文档和说明

不应该提交的文件

使用 .gitignore 文件

在项目根目录创建一个名为 .gitignore 的文件，写入要忽略的文件/文件夹：

# 依赖
node_modules/

# 环境配置
.env
.env.local

# 系统文件
.DS_Store
Thumbs.db

# 编译产物
dist/
build/

GitHub Desktop 会自动忽略这些文件，不会把它们纳入版本管理。

三级方案对比与选择

推荐组合

最省心的方案：

1. 日常依赖 AI IDE 自带历史
2. 完成重要功能时手动备份一个文件夹
3. 项目完成后考虑上传到 GitHub

想要专业一点：

1. 从一开始就用 GitHub Desktop
2. 每完成一个功能就 Commit
3. 每天结束时 Push 到云端

本节检查清单

完成本节学习后，确认你掌握了以下内容：

知道在哪里找到 AI IDE 的历史功能
能够使用历史功能回退到之前的版本
会用手动复制文件夹的方式备份项目
知道什么时候应该保存一个版本
（可选）安装了 GitHub Desktop
（可选）成功把项目上传到了 GitHub
（可选）知道 Commit 信息怎么写

恭喜你

从现在起，你的代码有了"时光机"保护。

不管是 AI IDE 自带的历史，还是手动备份，还是 GitHub Desktop——你已经掌握了保护自己劳动成果的能力。

这意味着：

• 你可以大胆尝试新功能，不怕改崩
• 你可以让 AI 做实验性的改动，不满意就回退
• 你的 2 小时成果不会因为一个小失误而白费

这不是终点，而是新的起点。

接下来，我们要把你的待办清单发布到互联网上，让全世界都能访问。

→ 5.2 见世面：把网页发到互联网上