NVM管理速记(不是官方文档不好,而是笔记更有性价比)
NVM 管理
一、为什么要用 NVM?
还在为项目上总是要频繁切换 Node.js 版本而烦恼吗?为了便捷地管理 Node.js 版本,顺利维护新老项目,NVM应运而生。
二、NVM 怎么下载?
官方下载
👉 https://nvm.uihtm.com/doc/download-nvm.html
下载
nvm-setup.exe安装包
安装前务必卸载以前安装过的 Node 环境,以免相互影响。选择安装目录
建议安装在 D 盘根目录:D:\nvm
⚠️ 请勿使用中文目录,否则可能引起不必要的问题。选择 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 useNVM 会自动读取.nvmrc文件并切换到对应版本。
查看当前使用的版本
nvm current六、切换版本时的注意事项
全局包是独立的
每个 Node.js 版本都有自己独立的全局node_modules目录。切换版本后,之前版本全局安装的包(如yarn、pnpm等)在新版本中无法直接使用,需要重新安装。权限问题
如果在切换时遇到权限错误(尤其在 Windows 上),请尝试以管理员身份运行终端(如 PowerShell、CMD)。
