API 开发策略

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

我们的策略和动机在我们的 Future Flags 博客文章中进行了更详细的讨论。

未来特性 Flags

当 API 发生重大更改时，它会在未来特性 flag 中引入。 这允许您在每次更改成为下一个主要版本中的默认设置之前选择加入。

• 如果未启用未来特性 flag，您的应用程序不会发生任何变化
• 启用该 flag 会更改该功能的行为

所有当前的未来特性 flag 都记录在 Future Flags Guide 中，以帮助您保持最新。

不稳定 Flags

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

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

• 它们会更改，恕不另行通知，也没有升级路径
• 它们会有 bug
• 它们没有文档记录
• 它们可能会被完全废弃

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

由于不稳定 flag 是实验性的，并且不能保证会保留下来，因此我们在 SemVer 补丁版本中发布它们，因为它们不是新的稳定/已记录 API。 当不稳定 flag 稳定为 Future Flag 时，它将在 SemVer 次要版本中发布，并将被正确记录并添加到 Future Flags Guide 中。

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

新功能流程示例

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