
如果您需要在Windows系统上搭建Node.js开发环境,并且希望灵活管理多个Node.js版本以适配不同项目需求,则必须完成两个核心任务:一是正确安装Node.js运行时,二是部署nvm-windows工具实现多版本共存与快速切换。以下是具体操作步骤:
一、通过官方安装包安装Node.js基础环境
此方法适用于首次配置Node.js环境,或无需多版本管理的轻量级使用场景。安装过程会同时部署npm包管理器,为后续依赖安装提供支持。
1、访问Node.js官方网站https://nodejs.org,点击“Download”按钮下载最新LTS版本的Windows Installer(.msi文件)。
2、双击下载完成的.msi安装包,启动安装向导,勾选“I accept the Terms in the License Agreement”后点击“Next”。
3、在“Custom Setup”页面中,确保“Add to PATH”选项被选中,以便在任意命令行窗口中直接调用node和npm命令。
4、继续点击“Next”,选择安装路径(默认为C:\Program Files\nodejs\),最后点击“Install”完成安装。
5、打开Windows PowerShell或CMD,执行node -v与npm -v验证是否输出版本号,确认安装成功。
二、使用nvm-windows安装并管理多个Node.js版本
nvm-windows是一个专为Windows设计的Node.js版本管理工具,允许用户在同一系统中安装、卸载、启用不同版本的Node.js,并通过简单命令实现即时切换,避免全局环境冲突。
1、前往nvm-windows GitHub发布页https://github.com/coreybutler/nvm-windows/releases,下载最新nvm-setup.zip压缩包。
2、解压zip文件,双击运行nvm-setup.exe,按提示完成安装;安装过程中请勿修改默认安装路径(通常为C:\Users\用户名\AppData\Roaming\nvm)。
3、安装完成后,关闭当前终端,重新打开PowerShell或CMD,执行nvm version检查是否返回nvm版本号;若提示“nvm: command not found”,需重启系统或手动将nvm安装目录加入系统PATH环境变量。
4、执行nvm list available查看所有可安装的Node.js版本列表,注意区分LTS版本(标有lts字样)与Current版本。
5、执行nvm install 18.19.0安装指定版本(此处以18.19.0为例),安装过程自动下载并解压对应二进制文件至nvm安装目录下的v18.19.0子文件夹。
6、执行nvm use 18.19.0激活该版本,此时node -v应返回18.19.0;再次执行nvm list可看到当前活动版本前带有星号标记。
三、通过nvm-windows切换已安装的Node.js版本
当多个Node.js版本已通过nvm安装完毕后,切换操作仅需一条命令即可生效,所有终端新会话均继承当前设定的活跃版本,无需重启系统或重装软件。
1、执行nvm list列出当前已安装的所有Node.js版本,并识别出目标版本号(如16.20.2、20.11.0等)。
2、执行nvm use 16.20.2将运行时切换至16.20.2版本,该操作立即改变当前终端中的node与npm指向。
3、执行nvm alias default 16.20.2设置默认版本,此后每次新开终端窗口时,nvm将自动加载此版本,无需重复执行use命令。
4、若某项目需长期绑定特定Node.js版本,可在项目根目录下创建.nvmrc文件,写入版本号(例如14.21.3),然后在该项目目录中执行nvm use(不带参数),nvm将自动读取.nvmrc并切换至对应版本。
四、卸载不再需要的Node.js版本以释放磁盘空间
nvm-windows支持安全移除指定版本,不会影响其他已安装版本或系统PATH配置,适合清理测试版本或过时LTS版本。
1、执行nvm list确认待卸载版本的确切名称(如v14.21.3,注意含v前缀)。
2、执行nvm uninstall v14.21.3触发卸载流程,nvm将删除该版本对应的所有文件及缓存数据。
3、执行nvm list再次检查输出结果,确认该版本已从列表中消失。
4、若当前活跃版本恰好是待卸载版本,nvm会在卸载前提示错误;此时需先执行nvm use切换至其他已安装版本,再进行卸载操作。

评论(0)