API 開發策略

React Router 是您應用程式的基礎。我們希望確保升級到新的主要版本盡可能順暢，同時仍允許我們隨著 React 生態系統的發展調整和增強行為和 API。

我們的策略和動機在我們的 Future Flags 部落格文章中有更詳細的討論。

未來標記

當 API 以破壞性的方式變更時，它會在未來標記中引入。這允許您在變為下一個主要版本的預設值之前，選擇一次啟用一個變更。

• 如果未啟用未來標記，您的應用程式將不會有任何變更
• 啟用標記會變更該功能的行為

所有目前的未來標記都記錄在未來標記指南中，以協助您保持最新狀態。

不穩定標記

不穩定標記適用於仍在設計和開發中的功能，並提供給我們的使用者，以協助我們使其正確。

不建議在生產環境中使用不穩定標記

• 它們會在沒有警告且沒有升級路徑的情況下變更
• 它們會有錯誤
• 它們沒有文件記錄
• 它們可能會被完全廢棄

當您選擇加入不穩定標記時，您將成為專案的貢獻者，而不是使用者。我們感謝您的協助，但請注意新的角色！

由於不穩定標記是實驗性的，且不保證會保留，因此我們在 SemVer 修補程式版本中發布它們，因為它們不是新的穩定/已記錄 API。當不穩定標記穩定為未來標記時，將在 SemVer 次要版本中發布，並將正確記錄在文件中並新增至未來標記指南。

若要了解目前的不穩定標記，請密切關注更新日誌。

範例新功能流程

新功能的決策流程如下所示（請注意，此圖表與 Remix v1/v2 相關，但也適用於 React Router v6/v7）。