---
title: "5.1.6 版本管理最佳实践"
order: 7
---


![05-advanced_5.1-version-control_5.1.6-best-practices.png](/images/Basic/05-advanced_5.1-version-control_5.1.6-best-practices.png)
# 5.1.6 版本管理最佳实践

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

## Commit 信息怎么写

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

### 好的写法

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

特点：
- 说清楚**做了什么**
- 一眼就能看懂

### 不好的写法

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

问题：
- 看不出做了什么
- 以后找版本时完全没帮助

### 简单原则

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

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

## 多久 Commit 一次

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

| 做法 | 优缺点 |
|------|-------|
| 每改一行就 Commit | ❌ 太频繁，历史太乱 |
| 做完一个功能就 Commit | ✅ 推荐，粒度合适 |
| 写了一大堆再 Commit | ❌ 出问题难回退，找不到问题点 |

### 推荐的 Commit 时机

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

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

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

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

### 应该提交的文件

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

### 不应该提交的文件

| 类型 | 例子 | 为什么 |
|------|------|-------|
| 依赖包文件夹 | `node_modules/` | 太大，可以重新安装 |
| 环境配置 | `.env` | 可能包含密码等敏感信息 |
| 系统文件 | `.DS_Store`（Mac） | 与项目无关 |
| 编译产物 | `dist/`、`build/` | 可以重新生成 |

### 使用 .gitignore 文件

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

```
# 依赖
node_modules/

# 环境配置
.env
.env.local

# 系统文件
.DS_Store
Thumbs.db

# 编译产物
dist/
build/
```

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

::: tip 提示
如果你用的是纯 HTML/CSS/JS 的简单项目（比如待办清单），暂时不需要担心 `.gitignore`。这个文件在项目变复杂后才会用到。
:::

## 三级方案对比与选择

| 方案 | 学习成本 | 可靠性 | 云端备份 | 适合场景 |
|------|---------|-------|---------|---------|
| AI IDE 自带历史 | 零 | 中 | 否（网页版除外） | 日常小改动 |
| 手动复制文件夹 | 零 | 高 | 否 | 重要节点备份 |
| 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 小时成果不会因为一个小失误而白费

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

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

::: tip 鼓励
从"代码改崩了就没了"到"随时可以回退"——这是一个重要的思维转变。

你已经比很多初学者更懂得保护自己的成果。继续前进！
:::

→ [5.2 见世面：把网页发到互联网上](../5.2-deployment/)