API 开发策略

API 开发策略

React Router 是您应用程序的基础。我们希望确保升级到新的主要版本尽可能流畅,同时仍然允许我们在 React 生态系统发展的同时调整和增强行为和 API。

我们的策略和动机在我们的 未来特性 博客文章中进行了更详细的讨论。

未来特性

当 API 以破坏性方式更改时,它会在未来特性中引入。这允许您在它成为下一个主要版本中的默认值之前,一次选择加入一个更改。

  • 在不启用未来特性的情况下,您的应用程序没有任何变化
  • 启用该特性会更改该功能的行为

所有当前的未来特性都记录在 未来特性指南 中,以帮助您保持最新状态。

不稳定特性

不稳定特性用于仍在设计和开发中的功能,并提供给我们的用户,以帮助我们使其正确。

不建议在生产环境中使用不稳定特性

  • 它们会在没有警告和升级路径的情况下发生更改
  • 它们会有 bug
  • 它们没有文档
  • 它们可能会被完全废弃

当您选择加入不稳定特性时,您将成为项目的贡献者,而不是用户。我们感谢您的帮助,但请注意新的角色!

要了解当前的不稳定特性,请关注 变更日志

新功能流程示例

新功能的决策流程如下所示(请注意,此图与 Remix v1/v2 相关,但也适用于 React Router v6/v7)

Flowchart of the decision process for how to introduce a new feature

文档和示例 CC 4.0