> ## 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. **使用版本歷史**:如果回滾後出現問題，可以再次回滾到更早的穩定版本

> ⚠️ **注意**:演示版本的歷史回滾需要繼續生成研發版本才能正常操作。