升級 Docusaurus

Docusaurus 版本控管基於 major.minor.patch 架構，並遵守 語意化版本控管。

重大變更 僅在主要版本升級時發布，並詳載於下列升級指南中。

📄️ 升級到 Docusaurus v3

本文件將協助你將網站從 Docusaurus v2 升級至 Docusaurus v3。

🗃️ 升級到 Docusaurus v2

5 項

升級疑難排解

升級 Docusaurus 時，可能會遇到因快取依賴項不符所造成的問題 - 在通報錯誤或尋求支援之前，你可以執行下列幾個疑難排解步驟來解決這些常見問題。

執行 clear 指令

此 CLI 指令用於清除 Docusaurus 網站的已產生資源、快取和建置成品。

npm

npm run clear

Yarn

yarn clear

pnpm

pnpm run clear

移除 node_modules 和你的鎖定檔

使用下列指令移除 node_modules 資料夾和你的套件管理員的鎖定檔：

Bash

rm -rf node_modules yarn.lock package-lock.json

PowerShell

@('node_modules','yarn.lock','package-lock.json') | Remove-Item -Force -Recurse -ErrorAction SilentlyContinue

然後，使用以下方式重新安裝套件並重新產生 lock 檔

npm

npm install

Yarn

yarn install

pnpm

pnpm install