功能生命周期

本页面解释了 Storybook 团队如何使用四种生命周期标签来对功能进行分类：实验性 (Experimental)、预览版 (Preview)、稳定版 (Stable) 和 已弃用 (Deprecated)。

这些标签帮助用户了解我们对各项功能的承诺程度、预期的质量、发生重大变更的可能性以及预计的时间表。通过使这一过程透明化，我们旨在支持用户做出更好的采用决策，并在 Storybook 的发展过程中建立信任。

实验性

此阶段标志着功能开发的开始，在此期间我们验证想法并塑造方向。

实验性功能是可用的，但仍在不断发展中，可以根据实际使用情况进行迭代。它们非常适合在原型或早期集成中使用，但还不能作为构建关键路径的基础。每个实验性功能都附带一份RFC，我们在其中分享初步想法并报告进展。我们强烈鼓励您提供反馈，以帮助指导后续步骤。

在此阶段，我们致力于全面探索该概念。因此，在稳定之前，具体的实现细节可能会发生重大变化。

预览版

预览版功能已接近生产就绪状态，通常比较可靠，并附带文档，解决了大部分已知问题。它们应在至少一种支持的框架中完全可用，但在其他框架中可能仍不完整或不够完善。这些功能适合在实际项目中使用，我们鼓励团队采用它们并分享反馈。

虽然功能方向稳定，但我们可能会在次要版本中引入最小的重大更改，以弥补不足之处或优化行为。在这种情况下，我们会在可能的情况下提供自动化迁移工具，以简化过渡。我们的目标是在升级到稳定版之前，收集反馈并迭代 1-2 个次要版本。

稳定版

稳定版功能已完全支持，可在所有项目中安全用于生产。它们已充分文档化，在我们所有的核心框架中经过全面测试，并遵循语义化版本控制 (semantic versioning)。用户可以期望获得长期支持，任何重大更改都将保留在主版本发布中。

已弃用

已弃用功能正在逐步淘汰中，并将在未来的主版本中移除。用户应尽快迁移到受支持的替代方案。这些功能不再获得积极的开发或错误修复，其功能可能会随着时间的推移而下降。虽然它们可能仍然有效，但不应将其用于新开发。

通常，已弃用的功能将在下一个主版本周期内被移除（例如，如果在 8.x 中弃用，则预计在 9.0 中移除）。