API 开发策略

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

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

未来标志

当 API 发生破坏性变化时，会引入未来标志。这允许您在下一个主版本成为默认设置之前，一次性选择加入一项更改。

• 不启用未来标志，您的应用程序不会有任何变化
• 启用标志会改变该功能的行为

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

不稳定标志

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

不建议在生产环境中使用不稳定标志

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

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

由于不稳定标志是实验性的，并且不保证会保留下来，我们会在 SemVer 补丁版本中发布它们，因为它们不是新的*稳定*/*有文档*的 API。当不稳定标志稳定为未来标志时，它将在 SemVer 次要版本中发布，并会得到适当的文档记录并添加到 未来标志指南中。

要了解当前的不稳定标志，请关注 更新日志。

新功能流程示例

新功能的决策流程大致如下（请注意，此图与 Remix v1/v2 相关，但也适用于 React Router v6/v7）