安装环境:node和npm
使 用 Docusaurus 前必须安装 node.js 和 npm 环境。
一、Windows 系统
直接从 node.js 官网 下载 exe 并安装即可,nodejs 和 npm 会同时安装。

若要更新 nodejs,则重新下载 exe 安装。
可以使用命令行更新 npm ,以管理员身份运行 powershell:
# 允许执行脚本运行
Set-ExecutionPolicy RemoteSigned
# 验证执行策略是否已更改,输出应显示为 RemoteSigned
Get-ExecutionPolicy
# 更新和验证 npm 版本
npm install -g npm@latest
npm -v
二、Linux 系统
Linux 系统以 Debian 系为例。
2.1 安装 node.js 和 npm
sudo apt update
sudo apt install nodejs
sudo apt install npm
查看版本
$ nodejs -v
v20.18.2
$ npm -v
10.9.2
2.2 配置 npm 镜像源
由于网络原因,可能无法获取官方源,所以配置国内源(淘宝源)
npm config set registry https://registry.npmmirror.com
2.3 升级 nodejs 和 npm
随着 Docusaurus 版本的更新,npm 也需要更新
npm install -g npm@latest
npm -v
node.js 更新较为麻烦,最简单的方法是使用 nvm 管理 node.js 版本。
第一步,克隆 nvm
git clone https://github.com/nvm-sh/nvm.git
第二步,执行安装脚本
./nvm/install.sh
执行完毕后会有类似提示,复制并执行提示中的命令:

第三步,使用 nvm 命令管理 node 版本
查看nvm版本和获取帮助
nvm --version
nvm --help
升级到最新版本:
nvm install stable
或者指定版本 nvm install 22.12.0