以下是 Windows 系统下使用 nvm 的详细指南,涵盖安装、管理 Node.js 版本及常见问题解决:
一、nvm 的作用
- 多版本 Node.js 管理:在同一台机器上安装和切换不同 Node.js 版本。
- 环境隔离:不同项目可独立使用指定版本,避免全局冲突。
二、安装 nvm-windows
1. 下载安装包
- 官方地址:nvm-windows
- 选择
nvm-setup.exe
(推荐)或nvm-noinstall.zip
(需手动配置)。
2. 安装步骤
-
以管理员身份运行
nvm-setup.exe
。 -
安装路径建议选择 无空格和中文的路径 (如
D:\nvm
)。 -
安装完成后,打开 命令提示符(CMD) (非 PowerShell)验证:
cmdnvm version # 输出示例:1.1.12
三、基本使用命令
命令 | 作用 | 示例 |
---|---|---|
nvm list available |
查看可安装的 Node.js 版本 | |
nvm install <version> |
安装指定版本 | nvm install 20.10.0 |
nvm use <version> |
切换版本 | nvm use 18.18.2 |
nvm ls |
查看已安装版本(当前使用标 * ) |
|
nvm uninstall <version> |
卸载指定版本 | nvm uninstall 16.13.0 |
nvm on |
启用 nvm | |
nvm off |
禁用 nvm |
四、操作示例
1. 安装最新 LTS 版本
cmd
nvm install lts
2. 安装特定版本
cmd
nvm install 20.10.0
3. 切换版本
cmd
nvm use 20.10.0
# 输出:Now using Node.js 20.10.0
4. 设置默认版本
cmd
nvm alias default 20.10.0
五、注意事项
- 以管理员身份运行 CMD :
安装或切换版本时需管理员权限,否则可能失败。 - 路径无空格 :
Node.js 安装路径(通过nvm root
查看)建议不含空格(如C:\nodejs
)。 - 兼容性问题 :
部分 npm 包可能与高版本 Node.js 不兼容,需切换至低版本测试。 - 全局包隔离 :
不同 Node.js 版本的全局 npm 包相互独立,切换版本后需重新安装。
六、常见问题解决
1. nvm
命令未找到
- 检查环境变量 :确保
nvm
安装路径(如D:\nvm
)已添加到系统PATH
。 - 重启终端或电脑:环境变量更新后需重启生效。
2. 切换版本失败
- 关闭占用进程:关闭所有 Node.js 相关进程(如 VS Code、终端)。
- 手动删除旧版本残留 :进入
nvm
安装目录删除对应版本文件夹。
3. 安装缓慢或失败
-
使用国内镜像 (如淘宝源):
cmdnvm node_mirror https://npmmirror.com/mirrors/node/ nvm npm_mirror https://npmmirror.com/mirrors/npm/
-
关闭防火墙或代理:临时关闭安全软件后重试。
七、验证环境
cmd
node -v # 检查当前 Node.js 版本
npm -v # 检查 npm 版本
通过上述步骤,你可以在 Windows 系统上高效管理多个 Node.js 版本,灵活应对不同项目需求!