> ## Documentation Index
> Fetch the complete documentation index at: https://docs.superun.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 版本管理使用指南

> 版本管理的使用技巧和问题解决方案,包括版本历史、回滚等.

## 使用技巧

### 使用历史版本回滚

如果项目出现问题或想回到之前的稳定状态,可以使用历史版本回滚功能.

**适用场景**:

* 最近修改导致功能异常
* 想要回到之前的稳定版本
* 对比不同版本的效果
* 测试不同实现方式

**操作步骤**:

1. 进入项目的版本历史页面
2. 查看所有历史版本的记录
3. 选择要回滚到的目标版本
4. 点击「回滚到此版本」或「恢复此版本」
5. 确认回滚操作
6. 系统会自动恢复到选定的版本状态

**注意事项**:

* 回滚会丢失当前版本到目标版本之间的所有修改
* 回滚后可以继续在此基础上进行新的修改
* 如果项目连接了数据库,注意数据兼容性问题

> 💡 **提示**:经常创建版本标记,可以让你在需要时快速回滚到稳定状态.

***

### 固定每个良好状态

superun 会自动记录每个重要节点的版本历史,无需手动创建版本标记.

**工作原理**:

* 当你完成一个重要功能或修改后,系统会自动在版本历史中创建记录
* 每个版本都包含完整的项目状态,可以随时查看和回滚

![版本历史](https://b.ux-cdn.com/uxarts/files/t20260116115236/swkqgi3g.png)

**操作建议**:

1. 完成一个重要功能后,先测试确保功能正常
2. 系统会自动保存当前状态到版本历史
3. 在版本历史中可以看到所有关键节点的记录

**好处**:

* 可以随时回滚到任意历史版本
* 便于对比不同版本的差异
* 自动记录项目进度,无需手动管理

> 💡 **提示**:版本历史会自动保存,你只需要专注于开发,系统会帮你管理所有版本记录.

***

### 使用历史版本回滚重建

当项目陷入错误循环或结构混乱时,使用版本回滚功能快速回到之前的稳定状态.

**适用场景**:

* 项目结构混乱,难以修复
* 错误太多,修复成本过高
* 想要尝试新的实现方式,需要从稳定版本重新开始
* 需要回到某个功能正常的版本

**操作步骤**:

1. 进入项目的版本历史页面
2. 查看所有历史版本记录,找到功能正常的稳定版本
3. 选择目标版本
4. 点击「恢复此版本」
5. 确认回滚操作
6. 系统会自动恢复到选定版本的状态
7. 在稳定版本基础上继续开发

**注意事项**:

* ⚠️ **重要**:回滚会丢失当前版本到目标版本之间的所有修改,请谨慎操作
* 如果项目连接了数据库,回滚前需要检查数据兼容性,避免数据结构不匹配
* 回滚后可以继续在此基础上进行新的修改

> ⚠️ **注意**:回滚前记得检查数据库连接的兼容性.

***

## 问题解决

### 历史版本回滚后无法操作

**问题现象**:

* 从历史记录回滚后，页面无法点击
* 右侧功能菜单消失
* 无法进行任何操作

**解决方案**:

1. **检查是否为演示版本**:演示版本是只读的，无法操作。如果回滚到了演示版本，需要继续生成研发版本
2. **使用版本历史**:如果回滚后出现问题，可以再次回滚到更早的稳定版本

> ⚠️ **注意**:演示版本的历史回滚需要继续生成研发版本才能正常操作。