升级 Docusaurus
Docusaurus 的版本号是基于 major.minor.patch 方案，并遵从语义化版本规范。
破坏性更改只在主版本号（major）升 级时发布，并在以下升级指南中详细记录。
📄️ 到 Docusaurus v3
此文档将会帮助你将站点从 Docusaurus v2 升级到 Docusaurus v3。
🗃️ 到 Docusaurus v2
5 items
Troubleshooting upgrades
When upgrading Docusaurus you may experience issues caused by mismatching cached dependencies - there are a few troubleshooting steps you should perform to resolve these common issues before reporting a bug or seeking support.
Run the clear command
This CLI command is used to clear a Docusaurus site's generated assets, caches and build artifacts.
- npm
- Yarn
- pnpm
npm run clear
yarn clear
pnpm run clear
Remove node_modules and your lock file(s)
Remove the node_modules folder and your package manager's lock file using the following:
- Bash
- PowerShell
rm -rf node_modules yarn.lock package-lock.json
@('node_modules','yarn.lock','package-lock.json') | Remove-Item -Force -Recurse -ErrorAction SilentlyContinue
Then reinstall packages and regenerate the lock file using:
- npm
- Yarn
- pnpm
npm install
yarn install
pnpm install