2024/09/18/nvm-management-multi-version-node-01.webp

📖. 前言


我们构建一些项目时,经常需要旧版本的 node,如 Hexo 目前支持性比较好的版本是 v12,而最新的 Node 稳定版本是 v16。这个时候,为了避免 bug,我们需要切换 Node 版本。

一. 环境准备


本次教程,适用于 Mac、Linux 和 Windows,使用 NVM 管理 Node 版本。

配置前,请事先卸载你已经安装的 Node 版本和配置的环境变量,避免冲突。

二. Mac / Linux


Mac 和 Linux 都可以使用编译安装的方法,安装 NVM。但是 Mac 用户还是推荐使用 Homebrew 来安装 NVM。

以下方法,参考 NVM 项目发布地址:https://github.com/nvm-sh/nvm。安装完成后,终端输入

nvm

未报 command not find 错误,说明 NVM 已经安装成功。

1. 安装 NVM(推荐👉)


Mac 专属:Homebrew 安装:在安装 Homebrew 情况下,终端输入以下命令行,即可完成安装。

brew install nvm

检查环境变量的配置:

cat ~/.bash_profile

如果出现以下内容则是配置好了,否则请加以下内容添加到 .bash_profile 文件中:

# nvm 下 node 的环境变量配置
export NVM_DIR=~/.nvm
source $(brew --prefix nvm)/nvm.sh

添加完后需要重启脚本:

source ~/.bash_profile
  1. 打开 ~/.zshrc 文件
  2. 找到 # User configuration 所在的行
  3. 在下方添加 source ~/.bash_profile
  4. 保存退出后重新执行脚本 source ~/.zshrc

验证是否安装完成(关闭终端,重新打开新的终端窗口):

nvm --version

2. 安装国内源

大陆这边连接 Node 和 NPM 源有点忙,进而NVM也比较慢,所以我们换成国内源,在终端内输入:

export NVM_NODEJS_ORG_MIRROR=https://npm.taobao.org/mirrors/node/

3. 安装 Node

nvm 安装完成后就可以开始管理 nodejs 的版本了

# 最新的 lts 版本
nvm install --lts

# windows 需要精准的版本号才可以下载(v 要不要都可以)
nvm install v12.18.1

安装完后需要切换 Node 版本

# macOS 系统的 use 指令只是临时切换
nvm alias default 12.18.1

# windows 在首次安装完后必须执行该命令,否则无法找到 node 命令,
nvm use v10.16.3

配置淘宝镜像:

npm config set registry https://registry.npm.taobao.org --global 
npm config set disturl https://npm.taobao.org/dist --global

验证是否安装完成:

npm -v
npx -v
node -v

三. Windows


如果你的操作系统是 Windows 系统

1. 安装 NVM

进入 NVM-Windows 项目发布地址:https://github.com/coreybutler/nvm-windows/releases,选择最新发行版本下载:

2024/09/18/nvm-management-multi-version-node-02.webp

之后,解压出自压缩文件,点击安装:

2024/09/18/nvm-management-multi-version-node-03.webp

这边注意⚠️:NVM 的安装和配置路径不要有中文,因为我 Windows 虚拟机只分配 C 盘,大家可以最好安装到 D 盘等其他用户盘:

2024/09/18/nvm-management-multi-version-node-04.webp

2024/09/18/nvm-management-multi-version-node-05.webp

安装完成后,在 CMD 或者 Powershell 下,输入 NVM,即可发现安装完成:

2024/09/18/nvm-management-multi-version-node-06.webp

2. 配置国内源

大陆这边连接 Node 和 NPM 源有点忙,进而 NVM 也比较慢,所以我们换成国内源:

到你 NVM 安装路径,打开 setting.txt 文件,追加:

# node 使用淘宝源
node_mirror: http://npm.taobao.org/mirrors/node/ 

# npm 使用淘宝源
npm_mirror: https://npm.taobao.org/mirrors/npm/

2024/09/18/nvm-management-multi-version-node-07.webp

3. 安装 Node

首先,我们输入:

nvm list

查看已经安装的版本

2024/09/18/nvm-management-multi-version-node-08.webp

之后,我们安装 v12.21 版本 node:

2024/09/18/nvm-management-multi-version-node-09.webp

这样就已经安装好了,我们测试一下也是可以用的:

2024/09/18/nvm-management-multi-version-node-10.webp

四. NVM 常用命令


macOS:👇

命令 说明
nvm install --lts 下载最新的稳定版
nvm use <版本号> 临时切换版本
nvm alias default <版本号> 永久切换版本(版本别名,default就是默认使用的版本)
nvm uninstall <版本号> 删除指定版本
nvm ls 查看本地所有版本
nvm ls-remote --lts 查看线上所有稳定版

Windows:👇

命令 说明
nvm install <版本号> 下载指定版本
nvm use <版本号> 切换版本
nvm uninstall <版本号> 删除指定版本
nvm list available 查看线上所有版本

🌟. 参考