查看: 121|回复: 1

使用nvm-windows管理多版本Node.js:完整安装与环境配置指南

[复制链接]
发表于 2 小时前 | 显示全部楼层 |阅读模式
在日常开发中,同时维护多个Node.js项目经常需要切换不同版本的Node.js运行环境。手动卸载重装不仅效率低,还容易残留旧版本文件,导致环境混乱。本文将介绍利用nvm-windows工具统一管理Node.js多版本,并完成环境变量配置与版本切换的完整流程。所有操作均在Windows系统下以管理员身份运行PowerShell。

一、下载并安装nvm-windows

首先确保当前系统中已卸载所有已安装的Node.js版本,否则后续符号链接可能冲突。打开管理员PowerShell,执行以下命令下载nvm-setup.exe:
  1. Invoke-WebRequest -Uri "https://github.com/coreybutler/nvm-windows/releases/download/1.1.12/nvm-setup.exe" -OutFile "$env:USERPROFILE\Downloads\nvm-setup.exe"
复制代码
下载完成后双击运行安装程序。依次同意许可协议,根据个人偏好设置nvm安装路径(例如D:\Software\nvm)以及Node.js符号链接路径(例如D:\Software\nodejs)。安装程序会自动配置大部分环境变量,但后续仍需验证。

二、验证安装与环境变量

安装完毕后,重新以管理员身份打开PowerShell,依次运行以下三条命令确认nvm可用及环境变量配置正确:
  1. nvm version
复制代码
该命令应返回类似“1.1.12”的版本号。接着检查环境变量:
  1. echo $env:NVM_HOME
  2. echo $env:NVM_SYMLINK
复制代码
输出的路径应与安装时选择的nvm安装路径和符号链接路径一致。如果为空,则需要手动添加系统变量(见第六节)。

三、配置国内镜像加速(可选)

国内用户访问官方Node.js镜像可能较慢,可配置淘宝镜像。在管理员PowerShell中执行:
  1. nvm node_mirror https://npmmirror.com/mirrors/node/
  2. nvm npm_mirror https://npmmirror.com/mirrors/npm/
复制代码
设置后可通过以下命令查看配置文件确认:
  1. type $env:NVM_HOME\settings.txt
复制代码
文件中应包含两行mirror地址。

四、安装多个Node.js版本

先查看线上可用的LTS版本列表:
  1. nvm list available
复制代码
根据输出选择合适的版本号进行安装。例如同时安装Node.js 11.4.0和22.13.1:
  1. nvm install 11.4.0
  2. nvm install 22.13.1
复制代码
安装完成后可用以下命令查看实际存储位置:
  1. Get-ChildItem D:\Software\nvm
复制代码
(请将路径替换为你的nvm安装目录)在nvm安装目录下会看到以版本号命名的文件夹,每个文件夹内包含对应版本的node.exe及相关文件。

五、手动配置系统环境变量(如果安装程序未自动添加)

右击“此电脑”→“属性”→“高级系统设置”→“环境变量”,在“系统变量”中新建两个变量:
- 变量名:NVM_HOME,变量值:你的nvm安装路径(例如D:\Software\nvm)
- 变量名:NVM_SYMLINK,变量值:你的符号链接路径(例如D:\Software\nodejs)

然后在系统变量中找到Path变量并编辑,添加以下两行:
- %NVM_HOME%
- %NVM_SYMLINK%

确保Path中不包含其他指向旧Node.js的路径,最后点击所有“确定”保存。

六、切换并使用指定Node.js版本

完成配置后,关闭并重新以管理员身份打开PowerShell,验证当前可用版本:
  1. nvm list
复制代码
输出列表会显示本地已安装的版本,并在当前使用版本前标注星号。切换版本使用:
  1. nvm use 11.4.0
复制代码
版本号须为已安装的版本。切换成功后,验证Node.js和npm版本:
  1. node --version
  2. npm --version
复制代码
应显示刚切换的版本号,说明环境已生效。

七、总结

通过nvm-windows工具,开发者可以在Windows系统中轻松安装、切换并管理多个Node.js版本,避免因项目依赖不同而反复卸载重装。关键步骤包括:卸载旧版Node.js、设置nvm安装路径与符号链接、配置镜像源、通过nvm install/nvm use命令管理版本、并确保环境变量正确指向NVM_HOME和NVM_SYMLINK。建议将nvm安装路径放在不包含中文和空格的目录中,以减少潜在问题。此方法同样适用于npm包管理器,切换版本时npm会自动跟随Node.js版本。
回复

使用道具 举报

发表于 1 小时前 | 显示全部楼层

Re: 使用nvm-windows管理多版本Node.js:完整安装与环境配置指南

感谢楼主分享这么详细的nvm-windows配置教程!步骤非常清晰,尤其是提醒先卸载旧版Node.js、用管理员权限运行PowerShell,还有环境变量设置和镜像加速这些细节,对于新手来说特别友好。我之前手动画Path经常漏掉,看到你列出NVM_HOME和NVM_SYMLINK的检查方法就放心多了。另外,安装路径避开中文和空格这个建议很实用,之前踩过类似的坑。按照你的流程已经成功装上了11.4.0和22.13.1,切换也很流畅,感谢!
回复 支持 反对

使用道具 举报

您需要登录后才可以回帖 登录 | 注册

本版积分规则

指导单位

江苏省公安厅

江苏省通信管理局

浙江省台州刑侦支队

DEFCON GROUP 86025

Hacking Group 021A

旗下站点

态势感知中心

应急响应中心

红盟安全

联系我们

官方QQ群:112851260

官方邮箱:security#ihonker.org(#改成@)

官方核心成员

关注微信公众号

Archiver|手机版|小黑屋| ( 沪ICP备2021026908号 )

GMT+8, 2026-6-12 23:07 , Processed in 0.028201 second(s), 18 queries , Gzip On, Redis On.

Powered by ihonker.com

Copyright © 2015-现在.

  • 返回顶部