跳到主要内容

安装环境:node和npm

使用 Docusaurus 前必须安装 node.js 和 npm 环境。

一、Windows 系统

直接从 node.js 官网 下载 exe 并安装即可,nodejs 和 npm 会同时安装。

image-20250110143943810

若要更新 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

执行完毕后会有类似提示,复制并执行提示中的命令:

image-20250110145836497

第三步,使用 nvm 命令管理 node 版本

查看nvm版本和获取帮助

nvm --version
nvm --help

升级到最新版本:

nvm install stable

或者指定版本 nvm install 22.12.0