升級 Storybook

前端生態系統是一個快速發展的地方。定期升級相依性是生活的一部分，無論是升級框架、函式庫、工具，還是所有上述項目！ Storybook 提供了一些資源來幫助減輕升級的痛苦。

升級腳本

最常見的升級是 Storybook 本身。 Storybook 版本遵循語意化版本。我們會持續發布包含錯誤修復的修補程式版本、每隔幾個月發布包含新功能的次要 Storybook 版本，以及大約每年發布一次包含重大變更的主要 Storybook 版本。

為了幫助減輕保持 Storybook 最新狀態的痛苦，我們提供了一個命令列腳本

npx storybook@latest upgrade

upgrade 命令將使用您指定的任何版本。例如

執行命令後，腳本將會

除了執行命令之外，我們還建議查看MIGRATION.md 檔案，其中包含可能影響您升級的相關變更和棄用項目的詳細記錄。

為了幫助您驗證升級是否完成，並且您的專案是否仍能如預期般運作，Storybook CLI 提供了doctor 命令，可讓您對專案進行健全狀況檢查，以找出升級後可能發生的常見問題，例如重複的相依性、不相容的附加元件或不符的版本。若要執行健全狀況檢查，請使用您選擇的套件管理員執行下列命令

npx storybook@latest doctor

Storybook 升級並非唯一需要考慮的事項：生態系統的變更也帶來挑戰。例如，知名的前端框架，例如Angular、Next.js 或 Svelte 都已對其生態系統進行重大變更，因此即使您不升級 Storybook 版本，您也可能需要相應地更新設定。這就是 Automigrate 的用途

npx storybook@latest automigrate

它會執行一組標準的設定檢查，說明哪些設定可能過時，並提供自動為您修正這些設定的選項。它也會指向相關的文件，以便您可以了解更多資訊。它會自動作為storybook upgrade 命令的一部分執行，但如果您不想升級 Storybook，也可以單獨使用。

除了上述之外，Storybook 也處於持續開發中，而且我們幾乎每天都會發布預先發佈版本。預先發佈版本是在新功能普遍可用之前試用這些功能的最佳方式，而且我們會盡力保持其穩定性，儘管這並非總是可行。

若要升級至最新的預先發佈版本

npx storybook@next upgrade

upgrade 命令將使用您指定的任何版本。例如

如果您想降級到穩定版本，請手動編輯 package.json 中的套件版本號碼，然後重新安裝。

Storybook 會收集完全匿名的資料，以幫助我們改善使用者體驗。參與是可選的，如果您不想分享任何資訊，可以選擇退出。