三亩地 三亩地SAN MU DI · CODE DIARY
ARTICLE DETAIL

日记详情

真实记录编程学习的某一天,欢迎挑你感兴趣的翻一翻。

NVM管理速记(不是官方文档不好,而是笔记更有性价比)

NVM管理速记(不是官方文档不好,而是笔记更有性价比)

NVM 管理

一、为什么要用 NVM?

还在为项目上总是要频繁切换 Node.js 版本而烦恼吗?为了便捷地管理 Node.js 版本,顺利维护新老项目,NVM应运而生。


二、NVM 怎么下载?

官方下载

👉 https://nvm.uihtm.com/doc/download-nvm.html

  1. 下载nvm-setup.exe安装包
    安装前务必卸载以前安装过的 Node 环境,以免相互影响。

  2. 选择安装目录
    建议安装在 D 盘根目录:D:\nvm
    ⚠️ 请勿使用中文目录,否则可能引起不必要的问题。

  3. 选择 Node.js 的安装目录
    建议设置为:D:\nvm\nodejs
    以后通过 NVM 安装的 Node.js 版本都会下载到此目录统一管理。

    设置新版本存储根目录的命令示例:

    nvm root D:\nvm\nodejs

三、下载和使用

安装指定版本的 Node.js

nvm install <nodejs版本号>

使用(切换)指定版本

nvm use <nodejs版本号>

示例:

安装最新稳定版

nvm install node

这里的node是一个特殊别名,指向最新的稳定版。

安装完成后,NVM 通常会自动切换到该版本。也可以手动指定:

nvm use node

验证是否安装成功

node -v

四、切换版本

查看已安装的所有版本

nvm ls

当前正在使用的版本前会有一个星号*

NVM 支持的切换方式

切换方式命令示例说明
指定完整版本号nvm use 18.16.0最精确的方式,切换到指定的具体版本
使用主版本号nvm use 16切换到已安装的、主版本号为 16 的最新版本
最新稳定版nvm use node切换到已安装的最新版本 Node.js
最新 LTS 版nvm use --lts切换到已安装的最新长期支持版本(LTS)
特定 LTS 版nvm use lts/hydrogen切换到代号为 “Hydrogen” 的特定 LTS 版本

五、版本管理自动化技巧

设置默认版本

每次打开新终端时都自动使用某个特定版本:

nvm alias default <版本号>

项目级自动切换(推荐)

在项目根目录创建.nvmrc文件,写入所需的 Node.js 版本号,例如创建并写入的指令:

echo "16.14.0" > .nvmrc

之后只要进入该项目目录,运行:

nvm use

NVM 会自动读取.nvmrc文件并切换到对应版本。

查看当前使用的版本

nvm current

六、切换版本时的注意事项

  1. 全局包是独立的
    每个 Node.js 版本都有自己独立的全局node_modules目录。切换版本后,之前版本全局安装的包(如yarnpnpm等)在新版本中无法直接使用,需要重新安装。

  2. 权限问题
    如果在切换时遇到权限错误(尤其在 Windows 上),请尝试以管理员身份运行终端(如 PowerShell、CMD)。

← 返回列表