Node 虚拟环境 - nvm

nvm（Node Version Manager）让你在同一台机器上安装并自由切换多个 Node 版本，按项目隔离，不用 sudo 污染系统全局。例如你的2个项目要求的 Node 版本不同，那用 nvm 装2个符合要求的 Node 版本最省事。

• macOS / Linux / WSL 系统：使用 nvm（nvm-sh）
• Windows 系统：使用 nvm-windows（命令类似但不完全相同）

！！！注意、安装前彻底卸载旧版 Node.js！！！

一、安装 

macOS / Linux

用官方脚本安装（版本号以 releases 最新为准）：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
# 或 wget：
# wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash

脚本会把 nvm 装到 ~/.nvm，并往你的 shell 配置文件（~/.bashrc / ~/.zshrc / ~/.profile）追加如下加载片段：

export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"                    # 加载 nvm
[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion" # 命令补全　

安装完成后打开终端，执行 source ~/.bashrc 让以上配置生效。验证：

nvm --version        # 打印版本号即安装成功
command -v nvm       # 输出 nvm（这是个 shell 函数，不是可执行文件，which nvm 会查不到，属正常）

若提示 nvm: command not found：多半是没有执行  source ~/.bashrc

二、安装并切换 Node

nvm install 20            # 安装最新的 Node 20.x（满足本项目 ≥ 20）
nvm install --lts         # 安装最新 LTS 版
nvm install 22.19.0       # 安装指定版本

nvm use 20                # 当前终端切到 Node 20（启用 Node 20 版本）
nvm alias default 20      # 设为默认版本（以后新开终端自动用它）

node -v && npm -v         # 验证当前生效的版本

常用查询：

nvm ls                    # 列出本机已安装的版本（标出 current 与 default）
nvm ls-remote             # 列出所有可安装的远程版本
nvm ls-remote --lts       # 只看 LTS 版本
nvm current               # 当前终端正在用的版本
nvm which 20              # 某版本 node 可执行文件的路径

三、其他常用操作

nvm uninstall 18                 # 卸载某个版本
nvm run 20 --version             # 用指定版本临时跑一次命令
nvm exec 20 node app.js          # 用指定版本执行命令，不改变当前终端

# 迁移全局包：装新版本时把旧版本的全局包一并装过来
nvm install 22 --reinstall-packages-from=20

注意：全局 npm 包是按 Node 版本隔离的。nvm use 切到另一个版本后，之前 npm install -g 装的命令在新版本下不存在，需要重新 npm install -g（或用上面的 --reinstall-packages-from）

四、Windows（nvm-windows）

4.1、彻底卸载旧版 Node.js

1、卸载程序：

• 打开 控制面板 -> 程序和功能 (或 设置 -> 应用)。
• 找到 Node.js，右键点击 卸载。

2、清理残留文件：

手动删除以下目录（若存在）：

• C:\Program Files\nodejs
• C:\Program Files (x86)\nodejs
• C:\Users\<你的用户名>\AppData\Roaming\npm
• C:\Users\<你的用户名>\AppData\Roaming\npm-cache

注意：提示：AppData 是隐藏文件夹，需在资源管理器“查看”选项中勾选“隐藏的项目”。

3、清理环境变量：

• 右键 此电脑 -> 属性 -> 高级系统设置 -> 环境变量。
• 在 用户变量 和 系统变量 的 Path 中，删除所有包含 nodejs 或 npm 的路径。
• 若存在名为 NODE_PATH 的变量，也请一并删除。

4、验证卸载：

• 打开新的 CMD 窗口，输入 node -v。
• 若提示“不是内部或外部命令”，说明清理成功。

4.2、安装 nvm-windows

Windows 用 nvm-windows（从 releases 下载 nvm-setup.exe 安装）

 

命令略有差异：

nvm list available     # 列出可安装版本
nvm install 20.20.2    # 安装指定版本（建议写完整版本号）
nvm use 20.20.2        # 切换（可能需要管理员权限）
nvm list               # 已安装版本

nvm-windows 没有 --lts 简写，安装时建议指定完整版本号