简介

NVM（Node Version Manager）是一款用于管理多个 Node.js 版本的工具，可帮助开发者在不同项目中快速切换 Node.js 版本，有效解决版本兼容性问题。

安装前准备

卸载现有 Node.js

若系统中已安装 Node.js，请彻底卸载（包括删除残留的环境变量和安装目录），避免路径冲突。

下载并安装

• 下载最新版安装包（如 nvm-setup.zip）

• 解压后以管理员身份运行 nvm-setup.exe

• 建议使用默认安装路径：

  C:\Users\<你的用户名>\AppData\Local\nvm

安装程序会自动配置 PATH 环境变量，通常无需手动设置。

配置国内镜像

加速下载

编辑 NVM 安装目录下的 settings.txt 文件（路径示例）：

C:\Users\<你的用户名>\AppData\Local\nvm\settings.txt

添加以下两行（使用阿里云 npmmirror 镜像）：

node_mirror: https://npmmirror.com/mirrors/node/
npm_mirror: https://npmmirror.com/mirrors/npm/

此配置将显著提升 Node.js 和 npm 的下载速度。

环境变量

通常无需手动操作

nvm-windows 安装程序会自动将以下两个路径加入系统 PATH：

• NVM 主目录：%LOCALAPPDATA%\nvm

• Node.js 符号链接目录：%LOCALAPPDATA%\nvm\nodejs

不要手动创建 NVM_HOME 或 NVM_SYMLINK 系统变量，除非你明确知道其用途。若 nvm 命令无效，请：

1. 重启命令行（或重启电脑）；

2. 检查 PATH 是否包含上述路径；

3. 确保使用新的命令行窗口（旧窗口不会加载新 PATH）。

验证安装

1. 以管理员身份打开 CMD 或 PowerShell（后续操作均需管理员权限）

2. 执行：

nvm -v

若输出版本号（如 1.1.12），说明安装成功。

重要：所有涉及 nvm install 或 nvm use 的操作，必须以管理员身份运行命令行，否则会因无法创建符号链接而失败。

常用 NVM 命令

# 查看已安装的 Node.js 版本
nvm ls

# 列出可安装的版本（Windows 仅显示部分）
nvm ls available
# 完整版本列表请访问：https://npmmirror.com/mirrors/node/

# 安装指定版本（例如 20.19.4）
nvm install 20.19.4

# 切换到指定版本
nvm use 20.19.4

# 显示当前激活的 Node.js 版本
nvm current

# 启用/禁用 NVM 管理
nvm on   # 启用（将 nodejs symlink 加入 PATH）
nvm off  # 禁用（移除 symlink，node/npm 不可用）

# 设置代理（可选）
nvm proxy http://your-proxy-url:port

# 卸载指定版本
nvm uninstall 18.17.0

# 查看或设置 NVM 根目录
nvm root [path]

# 查看 NVM 自身版本
nvm version  # 或 nvm -v

安装包管理器

Yarn / pnpm

# 先切换到目标 Node.js 版本
nvm use 20.19.4

# 安装 pnpm 并配置镜像
npm install -g pnpm
pnpm config set registry https://registry.npmmirror.com/
pnpm config set sass_binary_site https://npmmirror.com/mirrors/node-sass/
pnpm -v

# 安装 Yarn 并配置镜像
npm install -g yarn
yarn config set registry https://registry.npmmirror.com/
yarn config set sass_binary_site https://npmmirror.com/mirrors/node-sass/
yarn -v

问题解决

npm : 无法加载文件 C:\nvm4w\nodejs\npm.ps1，因为在此系统上禁止运行脚本。有关详细信息，请参阅 https:/go.microsoft.com/fw

link/?LinkID=135170 中的 about_Execution_Policies。

所在位置 行:1 字符: 1

+ npm install -g pnpm

+ ~~~

+ CategoryInfo : SecurityError: (:) []，PSSecurityException

+ FullyQualifiedErrorId : UnauthorizedAccess

Set-ExecutionPolicy RemoteSigned