3.5 KiB
3.5 KiB
NVM (Node Version Manager) 使用文档
一、什么是 NVM？
NVM（Node Version Manager）是一个用于管理多个 Node.js 版本的工具。它可以让你在同一台机器上安装、切换和使用不同版本的 Node.js，非常适合需要兼顾不同项目 Node.js 版本需求的开发者。
二、安装 NVM
2.1 一键安装
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
2.2 加载 NVM
安装完成后，需要重新加载终端或者执行以下命令使 nvm 生效：
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"
2.3 验证安装
nvm --version
三、配置镜像源（加速 Node.js 下载）
在国内使用 nvm 下载 Node.js 时，建议配置淘宝镜像源以提高下载速度。
临时配置（仅当前会话生效）
export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node
永久配置（写入 shell 配置文件）
echo 'export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node' >> ~/.bashrc
source ~/.bashrc
四、NVM 常用命令
4.1 安装 Node.js
# 安装最新稳定版
nvm install node
# 安装指定版本
nvm install 20.11.0
# 安装最新的 LTS 版本
nvm install --lts
4.2 查看可安装的版本
# 列出所有可安装的版本
nvm ls-remote
# 列出所有 LTS 版本
nvm ls-remote --lts
4.3 切换 Node.js 版本
# 使用指定版本
nvm use 20.11.0
# 使用最新稳定版
nvm use node
# 使用最新的 LTS 版本
nvm use --lts
4.4 查看已安装的版本
nvm ls
4.5 设置默认版本
# 设置系统默认使用的 Node.js 版本
nvm alias default 20.11.0
# 将最新稳定版设为默认
nvm alias default node
4.6 卸载 Node.js 版本
nvm uninstall 20.11.0
五、版本管理实践
5.1 为项目指定 Node.js 版本
在项目根目录创建 .nvmrc 文件：
# .nvmrc 文件内容示例
20.11.0
然后在该目录下运行 nvm use 即可自动切换到对应版本。
5.2 查看当前使用的版本
node -v
npm -v
5.3 版本别名管理
# 创建别名
nvm alias myapp 20.11.0
# 使用别名切换
nvm use myapp
# 删除别名
nvm unalias myapp
六、常见问题
6.1 命令找不到（command not found）
如果重启终端后出现 nvm: command not found，请确保已将 nvm 加载命令添加到 ~/.bashrc、~/.zshrc 或 ~/.profile 文件中。
6.2 下载速度慢
配置淘宝镜像源即可解决：
export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node
6.3 权限问题
使用 nvm 安装的 Node.js 不需要 sudo 权限，如果遇到权限问题，请检查是否使用了系统自带的 Node.js。
七、常用命令速查表
| 命令 | 说明 |
|---|---|
nvm --version |
查看 nvm 版本 |
nvm install <version> |
安装指定版本 |
nvm install node |
安装最新稳定版 |
nvm install --lts |
安装最新 LTS 版本 |
nvm use <version> |
切换使用指定版本 |
nvm ls |
列出已安装版本 |
nvm ls-remote |
列出远程所有版本 |
nvm alias default <version> |
设置默认版本 |
nvm uninstall <version> |
卸载指定版本 |
nvm current |
显示当前使用的版本 |
文档版本: v1.0 最后更新: 2025年