通过nvm管理node版本

905 阅读2分钟

以下是 Windows 系统下使用 nvm 的详细指南,涵盖安装、管理 Node.js 版本及常见问题解决:


一、nvm 的作用

  • 多版本 Node.js 管理:在同一台机器上安装和切换不同 Node.js 版本。
  • 环境隔离:不同项目可独立使用指定版本,避免全局冲突。

二、安装 nvm-windows

1. 下载安装包

  • 官方地址:nvm-windows
  • 选择 nvm-setup.exe(推荐)或 nvm-noinstall.zip(需手动配置)。

2. 安装步骤

  1. 以管理员身份运行 nvm-setup.exe
  2. 安装路径建议选择 无空格和中文的路径(如 D:\nvm)。
  3. 安装完成后,打开 命令提示符(CMD)(非 PowerShell)验证:
    nvm 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 版本

nvm install lts

2. 安装特定版本

nvm install 20.10.0

3. 切换版本

nvm use 20.10.0
# 输出:Now using Node.js 20.10.0

4. 设置默认版本

nvm alias default 20.10.0

五、注意事项

  1. 以管理员身份运行 CMD
    安装或切换版本时需管理员权限,否则可能失败。
  2. 路径无空格
    Node.js 安装路径(通过 nvm root 查看)建议不含空格(如 C:\nodejs)。
  3. 兼容性问题
    部分 npm 包可能与高版本 Node.js 不兼容,需切换至低版本测试。
  4. 全局包隔离
    不同 Node.js 版本的全局 npm 包相互独立,切换版本后需重新安装。

六、常见问题解决

1. nvm 命令未找到

  • 检查环境变量:确保 nvm 安装路径(如 D:\nvm)已添加到系统 PATH
  • 重启终端或电脑:环境变量更新后需重启生效。

2. 切换版本失败

  • 关闭占用进程:关闭所有 Node.js 相关进程(如 VS Code、终端)。
  • 手动删除旧版本残留:进入 nvm 安装目录删除对应版本文件夹。

3. 安装缓慢或失败

  • 使用国内镜像(如淘宝源):
    nvm node_mirror https://npmmirror.com/mirrors/node/
    nvm npm_mirror https://npmmirror.com/mirrors/npm/
    
  • 关闭防火墙或代理:临时关闭安全软件后重试。

七、验证环境

node -v  # 检查当前 Node.js 版本
npm -v   # 检查 npm 版本

通过上述步骤,你可以在 Windows 系统上高效管理多个 Node.js 版本,灵活应对不同项目需求!