# Material-UI 的不同版本

<p class="description">你可以随时回到本页来切换你在查阅的不同版本的文档。</p>

## Released versions

The most recent stable version (✓) is recommended for use in production.

{{"demo": "pages/versions/ReleasedVersions.js", "hideToolbar": true, "bg": "inline"}}

## 最新的版本

在这里您可以找到最新的尚未发布的文档和代码。 您可以使用它来查看即将实施的更新 , 并给 Material-UI 的贡献者提供更好的反馈。

{{"demo": "pages/versions/LatestVersions.js", "hideToolbar": true, "bg": "inline"}}

## 版本控制方案

稳定的版本保证了可重复使用的组件和库、教程、工具和学习教程不会意外的过时。 稳定性是 Material-UI 生态系统蓬勃发展的关键。

本文档包含了为您提供的一些前沿的 UI 库所遵循的练习， 在保持稳定的同时确保今后的变更总是以可预测的方式引进。

Material-UI 遵循[Semantic Versioning 2.0.0](https://semver.org/)。 Material-UI 的版本号由三部分组成： `major.minor.patch`。 版本号的递增是根据发行的更改级别而定义的。

- **主要发行（Major releases）**包含了重要的新功能，更新时需要一些但有限的开发人员的支持。 当更新到一个新的主要的发行版本时，您可能需要运行更新脚本，重构代码，运行其他测试以及学习新的 API。
- **次要发行版本（Minor releases）**包含重要的新功能。 次要发行版本完全向后兼容；更新时不需要开发人员的支持，但您可以选择修改应用程序和库来使用新的版本中添加的新 API ，特征和功能。
- **修订发行版本（Patch releases）**的风险低，包含了对 bug 的修复和发行一些较小的新功能。 更新时不需要开发人员的支持。

## 发布周期

一个定期的发布周期可以帮助您规划和适应 Material-UI 不断的演变。

通常情况下，你可以预期以下的发布周期：

- 每12个月发布一个**主**版本。
- 每个主版本会包含 1 - 3 个**次要**版本。
- 每周发布**修订版本**更新（会随时发布用于紧急的 bugfix）。

## 发布时间表

| 日期         | 版本     | 状态  |
|:---------- |:------ |:--- |
| 2018 年 5 月 | v1.0.0 | 已发布 |
| 2018 年 9 月 | v3.0.0 | 已发布 |
| 2019 年 5 月 | v4.0.0 | 已发布 |
| 2021 年第一季度 | v5.0.0 | ⏳   |


查看 [里程碑](https://github.com/mui-org/material-ui/milestones) 可以得到一个更详细的总览。

> ⚠️ **免责声明** ：我们在动态的环境中运作，情况随时可能发生变化。 提供的信息旨在规划框架总体的发展方向。 它意味着以上信息仅供参考。 根据我们的交付能力，我们随时可能决定增加或删除一些新的项目，去目的是保证项目的质量标准。 Material-UI 的任何功能的开发，发布和时间安排，均由 Material-UI 自行决定。 指导方针不代表我们在任何时间交付的承诺，义务或者保证。

## 政策支持

您可以查看 [所支持版本](/getting-started/support/#supported-versions) 的详细信息。

## 弃用的实践

有时候，一些**“破坏性的改变”**是必要的，例如删除对 select API 和功能的支持。

为了尽可能轻松地实现这些过渡：

- 我们会尽量将破坏性的改变降到最低，并且尽可能提供一些辅助迁移的工具。
- 请您遵循以下描述的弃用政策，这样就有时间将您的应用程序更新到最新版本的 API 和最佳的实践。

### 弃用政策

- 我们会尽量在更新日志中公布过时的功能，并尽可能在运行时发出警告。
- 当宣布一个弃用方案时，我们也会推荐一些更新的路径。
- 在弃用期间我们仍支持已有的稳定 API，所以您的代码将在此期间可以正常运行。
- 而对于那些需要更新您的应用程序的同版本依赖（React），只会在主版本发布时介绍。