主分支
分支
main (6.23.1)dev
版本
6.23.1v4/5.xv3.x
API 开发策略

API 开发策略

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

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

未来标志

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

  • 在启用未来标志之前,您的应用程序不会发生任何变化。
  • 启用标志会更改该功能的行为。

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

不稳定标志

不稳定标志用于仍在设计和开发中的功能,并提供给我们的用户,以帮助我们将其做好。

不稳定标志不建议用于生产环境。

  • 它们将在没有警告和升级路径的情况下更改。
  • 它们会有错误。
  • 它们没有记录。
  • 它们可能会被完全废弃。

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

要了解当前的不稳定标志,请关注 CHANGELOG

示例新功能流程

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

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