跳至內容
Fumadocs

升級

將 Fumadocs 套件更新至最新版本。

請一併升級所有 Fumadocs 套件。Fumadocs UI 將 fumadocs-core 設為 peer dependency,且版本必須與其發布時所搭配的版本完全一致。

以下指令會升級所有 fumadocs-* 與 @fumadocs/* 套件,並保留範本所使用的 fumadocs-ui 別名 (指向 @fumadocs/base-ui) :

npx npm-check-updates -u "fumadocs-*" "@fumadocs/*" && npm install

Yarn 指令改用 npm-check-updates,因為 yarn up 會把別名替換成 Radix UI 版本的 fumadocs-ui。

主要版本

升級跨越主要版本時,請閱讀該版本的發行說明:

  • Fumadocs 16:移除自 15.2 起已棄用的 API,將 fumadocs-core/server 的匯出移至各自對應的模組,並需要 React 19.2。
  • Fumadocs 15:將樣式遷移至 Tailwind CSS v4。
  • Fumadocs MDX 15:需要 fumadocs-core 16.7.0 或更新版本,以及 ESM 格式的 `next.config`。
  • Fumadocs MDX 14:將產生的 .source 資料夾拆分為 server、browser 與 dynamic 三個進入點。

How is this guide?