最新版本
您可以在这里找到最新的未发布文档和代码。您可以使用它来查看即将到来的更改，并向贡献者提供更好的反馈。
版本控制策略
稳定性确保可重用的组件和库、教程、工具和已学习的实践不会意外地过时。稳定性对于 Material UI 周围生态系统的蓬勃发展至关重要。
本文档包含为您提供领先的 UI 库的实践，并在稳定性方面取得平衡，确保未来的更改始终可以预测地引入。
MUI 的开源项目遵循语义化版本 2.0.0。这意味着版本号有三个部分：major.minor.patch。版本号根据版本中包含的更改级别递增。
- 主要版本包含重要的新功能，更新期间预计需要一些开发人员的协助。这些版本包括破坏性更改。更新到新的主要版本时，您可能需要运行更新脚本、重构代码、运行其他测试和学习新的 API。
- 次要版本包含重要的新功能。次要版本是完全向后兼容的；更新期间预计不需要开发人员的协助，但您可以选择修改您的应用程序和库，以开始使用版本中添加的新 API、功能和特性。
- 补丁版本是低风险的，包含错误修复和小型新功能。更新期间预计不需要开发人员的协助。
什么不算作破坏性更改？
我们将“破坏性更改”称为在升级到新版本时需要更新代码库的更改，以下情况除外
- 以“unstable_”开头的 API。这些是作为实验性功能提供的，我们对这些 API 尚无信心。通过使用
unstable_前缀发布这些 API，我们可以更快地迭代并更快地获得稳定的 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 的现有使用，因此您的代码在该期间将继续工作。