升级 Docusaurus
Docusaurus 的版本控制基于 主版本.次版本.补丁
方案,并遵循 语义化版本控制。
破坏性变更仅在主版本升级时发布,并在以下升级指南中进行详细记录。
📄️ 升级到 Docusaurus v3
本文档将帮助您将站点从 Docusaurus v2 升级到 Docusaurus v3。
🗃️ 升级到 Docusaurus v2
5 个项目
升级故障排除
在升级 Docusaurus 时,您可能会遇到由缓存依赖项不匹配导致的问题 - 在报告错误或寻求支持之前,您应该执行以下几个故障排除步骤来解决这些常见问题。
运行 clear
命令
此 CLI 命令用于清除 Docusaurus 站点的生成资源、缓存和构建工件。
- npm
- Yarn
- pnpm
- Bun
npm run clear
yarn clear
pnpm run clear
bun run clear
删除 node_modules
和锁定文件
使用以下命令删除 node_modules
文件夹和您的包管理器的锁定文件:
- Bash
- PowerShell
rm -rf node_modules yarn.lock package-lock.json
@('node_modules','yarn.lock','package-lock.json') | Remove-Item -Force -Recurse -ErrorAction SilentlyContinue
然后重新安装包并重新生成锁定文件:
- npm
- Yarn
- pnpm
- Bun
npm install
yarn install
pnpm install
bun install