通用-Nvm基础知识

NVM (Node Version Manager) 使用指南

NVM 是 Node.js 版本管理工具，允许在同一台机器上安装和切换多个 Node.js 版本。

🚀 安装与设置

安装 NVM

bash 复制代码

# macOS/Linux
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

# 或者使用 wget
wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

配置环境变量

bash 复制代码

# 添加到 ~/.bashrc 或 ~/.zshrc
export NVM_DIR="$([ -z "${XDG_CONFIG_HOME-}" ] && printf %s "${HOME}/.nvm" || printf %s "${XDG_CONFIG_HOME}/nvm")"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"

验证安装

bash 复制代码

nvm --version

📦 Node.js 版本管理

查看可用版本

bash 复制代码

nvm list-remote         # 查看所有可安装版本
nvm list-remote --lts   # 只查看 LTS 版本

安装 Node.js

bash 复制代码

nvm install <版本号>          # 安装指定版本
nvm install --lts            # 安装最新的 LTS 版本
nvm install node             # 安装最新的稳定版本
nvm install 18               # 安装 18.x 最新版本
nvm install 18.17.0          # 安装精确版本

切换版本

bash 复制代码

nvm use <版本号>        # 切换到指定版本
nvm use --lts           # 切换到最新的 LTS 版本
nvm use node            # 切换到最新的稳定版本

查看本地版本

bash 复制代码

nvm list                # 查看已安装版本
nvm current             # 查看当前使用的版本
nvm ls                  # 简写形式

设置默认版本

bash 复制代码

nvm alias default <版本号>    # 设置默认版本
nvm alias default lts/*       # 设置 LTS 为默认

🗑️ 版本管理

卸载版本

bash 复制代码

nvm uninstall <版本号>   # 卸载指定版本

设置别名

bash 复制代码

nvm alias <别名> <版本号>    # 为版本设置别名
nvm alias project1 18.17.0   # 例如
nvm use project1             # 使用别名

🔧 高级功能

在项目中使用

bash 复制代码

# 在项目根目录创建 .nvmrc 文件
echo "18.17.0" > .nvmrc

# 使用项目指定的版本
nvm use

# 自动切换版本（需要配置）
nvm use --silent-if-unchanged

运行特定版本

bash 复制代码

nvm run <版本号> <命令>     # 使用指定版本运行命令
nvm run 18 npm install      # 使用 Node 18 运行 npm install
nvm exec <版本号> <命令>     # 另一种方式

查看版本信息

bash 复制代码

nvm version <版本号>         # 查看版本详细信息
nvm which <版本号>           # 查看版本安装路径

💡 常用场景

项目开发

bash 复制代码

# 1. 为不同项目设置不同版本
cd project-a
echo "16.20.0" > .nvmrc

cd ../project-b
echo "18.17.0" > .nvmrc

# 2. 在项目目录自动切换
nvm use  # 会自动读取 .nvmrc

升级 Node.js

bash 复制代码

# 查看并安装最新版本
nvm list-remote | tail -1
nvm install <最新版本>
nvm use <最新版本>
nvm alias default <最新版本>

清理空间

bash 复制代码

# 查看占用空间
du -sh ~/.nvm/versions/node/

# 卸载不需要的版本
nvm uninstall 14.15.0
nvm uninstall 15.0.0

🔍 故障排除

NVM 命令找不到

bash 复制代码

# 重新加载配置
source ~/.bashrc
source ~/.zshrc

# 或者重启终端

Node/npm 版本不匹配

bash 复制代码

# 重新安装 Node.js
nvm reinstall-packages <版本号>

📝 文档信息

作者: 阿鑫
更新日期: 2026.1