最新版本
您可以在這裡找到最新的未發布文件和程式碼。您可以使用它來查看即將到來的變更，並向貢獻者提供更好的回饋。
版本控制策略
穩定性確保可重複使用的組件和函式庫、教學、工具及已學習的實務不會意外地過時。穩定性對於 Material UI 周圍生態系統的蓬勃發展至關重要。
本文件包含為您提供領先業界的 UI 函式庫所遵循的實務，並在穩定性方面取得平衡，確保未來變更始終以可預測的方式引入。
MUI 的開源專案遵循 語意化版本 2.0.0。這表示版本號碼有三個部分：major.minor.patch。版本號碼會根據版本中包含的變更程度而遞增。
- 主要版本發布包含重大的新功能，更新期間預期需要一些開發人員協助。這些版本包含重大變更。更新到新的主要版本時，您可能需要執行更新腳本、重構程式碼、執行額外測試，以及學習新的 API。
- 次要版本發布包含重要的新功能。次要版本發布是完全向後兼容的；更新期間預期不需要開發人員協助，但您可以選擇修改您的應用程式和函式庫，以開始使用版本中新增的新的 API、功能和特性。
- 修補程式版本發布風險較低，包含錯誤修復和小的新功能。更新期間預期不需要開發人員協助。
哪些變更不算是重大變更？
我們將「重大變更」定義為升級到新版本時需要更新程式碼庫的變更，但以下情況除外：
- 以「unstable_」開頭的 API。這些是以實驗性功能提供的，我們對其 API 尚無信心。透過以
unstable_前綴發布這些功能，我們可以更快地迭代並更快地獲得穩定的 API，或者只是了解到我們一開始就不需要該 API/功能。 - 文件註明為實驗性的 API。與上述相同。
- 未記錄的 API 和內部資料結構。如果您存取內部屬性，則不提供任何保證。您將自行承擔風險。
- 開發警告。由於這些警告不會影響生產行為，我們可能會在主要版本之間新增新的警告或修改現有的警告。事實上，這使我們能夠可靠地警告即將發生的重大變更。
- 預先發布版本。我們提供預先發布版本作為早期測試新功能的方式，但我們需要彈性根據我們在預先發布期間學到的內容進行變更。如果您使用這些版本，請注意 API 可能在穩定版本發布之前變更。
- 小的 CSS 變更。視覺設計變更如果對您的 UI 造成負面影響的可能性非常低，則不視為重大變更。
發布頻率
規律的發布排程可協助您規劃和協調更新，以配合 MUI 的持續發展。
一般而言，您可以預期以下發布週期
- 主要版本發布每 12 個月一次。
- 每個主要版本發布 1-3 個次要版本。
- 每週發布一個修補程式版本（緊急錯誤修復隨時發布）。
發布排程
| 日期 | 版本 | 狀態 |
|---|---|---|
| 2025 | v7.0.0 | 開始工作 |
| 2024 年 8 月 | v6.0.0 | 已發布 |
| 2021 年 9 月 | v5.0.0 | 已發布 |
| 2019 年 5 月 | v4.0.0 | 已發布 |
| 2018 年 9 月 | v3.0.0 | 已發布 |
| 2018 年 5 月 | v1.0.0 | 已發布 |
您可以關注里程碑以獲得更詳細的概述。
棄用實務
有時「重大變更」（例如移除對特定 API 和功能的支援）是必要的。為了盡可能簡化這些轉換
- 重大變更的數量已降至最低，並且在可能的情況下提供遷移工具（例如程式碼轉換）。
- 以下描述的棄用政策旨在讓您有時間將應用程式更新到最新的 API 和最佳實務。
棄用政策
- 已棄用的功能會在變更日誌中宣布，並在可能的情況下在運行時發出警告。
- 宣布棄用時，會提供建議的更新路徑。
- 在棄用期間，仍支援現有對穩定 API 的使用，因此您的程式碼將在該期間內保持運作。