升級 Storybook

前端生態系統變化快速。定期升級依賴套件是生活的一部分，無論是升級框架、函式庫、工具，還是以上全部！ Storybook 提供了一些資源來幫助減輕升級的痛苦。

升級腳本

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

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

npx storybook@latest upgrade

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

• storybook@latest upgrade 將升級到最新版本
• storybook@7.6.10 upgrade 將升級到 7.6.10
• storybook@7 upgrade 將升級到最新的 7.x.x 版本

執行命令後，腳本將會

• 將專案中的所有 Storybook 套件升級到指定的版本
• 執行相關的自動遷移，並考量目前版本和指定版本之間的重大變更

驗證升級

為了幫助您驗證升級是否完成，以及您的專案是否仍然如預期般運作，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 命令將使用您指定的任何版本。例如

• storybook@next upgrade 將升級到最新的預發布版本
• storybook@8.0.0-beta.1 upgrade 將升級到 8.0.0-beta.1
• storybook@8 upgrade 將升級到最新的 8.x 版本

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