Linux搭建Node.js开发环境-Nvm

Nvm（Node Version Manager）是一个轻量级的 Node.js 版本管理工具，能够帮助开发者高效管理多个 Node.js 环境。它的核心特点是隔离性和灵活切换——所有 Node.js 版本都安装在用户独立目录中，完全不影响系统自带的 Node.js 环境。

工作原理：通过 Shell 脚本和 PATH 环境变量管理，自动切换不同版本的 Node.js 和 npm。支持全局、项目目录和临时会话三级版本控制，灵活适应不同开发场景。

设计优势：纯 Shell 脚本实现，无需额外依赖；安装简单，使用便捷；与 npm、yarn 等包管理工具完美兼容。适合需要同时维护多个 Node.js 版本项目的开发者，提供了一种干净、可控的环境管理方案。

---

1. 安装 Nvm

1.1 安装依赖

在安装 Nvm 前，建议先安装相应的编译工具。

Ubuntu/Debian/Mint：

sudo apt update
sudo apt install curl wget git build-essential libssl-dev

CentOS/RHEL/Fedora：

sudo yum install curl wget git make gcc-c++ openssl-devel
# 或 Fedora 使用 dnf
sudo dnf install curl wget git make gcc-c++ openssl-devel

Arch Linux：

sudo pacman -S curl wget git base-devel openssl

1.2 安装 Nvm

使用官方一键安装脚本：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash

或者使用 wget：

wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash

1.3 配置环境变量

安装完成后，根据使用的 Shell 类型，将以下配置添加到对应的配置文件中。

Bash 用户： （默认情况下，安装脚本会自动添加）

echo 'export NVM_DIR="$HOME/.nvm"' >> ~/.bashrc
echo '[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"' >> ~/.bashrc
echo '[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"' >> ~/.bashrc

Zsh 用户： （默认情况下，安装脚本会自动添加）

echo 'export NVM_DIR="$HOME/.nvm"' >> ~/.zshrc
echo '[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"' >> ~/.zshrc
echo '[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"' >> ~/.zshrc

配置完成后，执行以下命令使配置立即生效（重启终端也会自动生效）：

source ~/.zshrc   # Zsh 用户
# 或
source ~/.bashrc  # Bash 用户

验证安装是否成功：

nvm --version

---

2. 基本使用

2.1 安装 Node.js 版本

查看所有可安装的 Node.js 版本：

nvm ls-remote

安装指定版本的 Node.js，例如安装 Node.js 20：

nvm install 20

安装最新的 LTS 版本：

nvm install --lts

2.2 设置默认 Node.js 版本

将指定版本设为全局默认版本：

nvm alias default 20
# 或直接使用
nvm use 20 --default

2.3 查看已安装的 Node.js 版本

列出所有已安装的 Node.js 版本：

nvm ls

2.4 切换 Node.js 版本

切换当前终端会话使用的 Node.js 版本：

nvm use 18

2.5 设置项目本地 Node.js 版本

在项目目录中创建 .nvmrc 文件，指定该目录使用的 Node.js 版本：

echo "20" > .nvmrc

然后在项目目录中运行：

nvm use

系统会自动切换到 .nvmrc 文件中指定的版本。

2.6 其他实用命令

卸载指定版本的 Node.js：

nvm uninstall 16

查看当前使用的 Node.js 版本：

nvm current

运行特定版本的 Node.js 但不切换环境：

nvm run 18 app.js

---

3. 常见问题

3.1 安装速度慢或失败

可以设置镜像源加速下载：

export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node

3.2 npm 全局包管理

每个 Node.js 版本都有独立的全局 npm 包，切换版本后需要重新安装该版本所需的全局包。

3.3 与系统 Node.js 共存

Nvm 默认不会影响系统自带的 Node.js，可以通过以下命令使用系统版本：

nvm use system

---

说明：Nvm 默认将 Node.js 安装到 ~/.nvm/versions/node/ 目录下，不同版本彼此隔离，互不干扰。每个版本都包含独立的 npm 和全局包空间。