跳到主要内容

docusaurus 环境配置

备注

使用 docusaurus 前需安装依赖环境 node.js 和 npm。如果已经安装，可以使用 node -v 和 npm -v 查看版本。

安装 node 和 npm​

安装 node.js 和 npm​

通过命令安装

# Linux系统
sudo apt update
sudo apt install nodejs
sudo apt install npm

通过文件安装

Windows 从官网下载安装包 ，安装 nodejs 会默认同时安装 npm。

image-20250110143943810

更换 npm 源​

网络故障

由于网络原因，国内用户可能无法连接到 npm 官方源。需配置国内镜像源。

淘宝源
npm config set registry https://registry.npmmirror.com

后续升级 nodejs 和 npm​

有时候项目会要求最低 nodejs 和 npm 版本，下面介绍如何升级版本。

使用 nvm 管理 node 版本​

Linux 用户可以使用 nvm 管理 node 版本：

  • 第一步，从 github 克隆 nvm ： https://github.com/nvm-sh/nvm

  • 第二步，进入 nvm 目录，执行命令:

    $ ./nvm-master/install.sh

    执行完毕后会有类似提示

    image-20250110145836497

    复制并执行提示中的 export 命令导入环境变量。

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

    # 查看vnm版本
    $ nvm --version

    # 升级到指定版
    $ nvm install 22.12.0

    # 升级到最新版
    $ nvm install lastest

    # 升级到稳定版
    $ nvm install stable

    升级时间可能会比较长，耐心等待。升级完毕后使用 node -v 查看版本。

备注

Windows 用户可以直接访问 nodejs 官网 下载并安装最新版本。

升级 npm​

npm 升级比较便利，使用命令即可：

# Linux
npm install -g npm@latest
npm -v

windows 以管理员身份运行 powershell，并执行以下命令升级 npm：

# 允许执行脚本运行
Set-ExecutionPolicy RemoteSigned

# 验证执行策略是否已更改，输出应显示为 RemoteSigned
Get-ExecutionPolicy

# 更新和验证 npm 版本
npm install -g npm@latest
npm -v
最后于 更新