Skip to main content

NVM（Node Version Manager）的安装与使用手册

以下是 NVM（Node Version Manager）的安装与使用手册，涵盖 安装步骤、常用命令、多版本管理 及 常见问题解决，适用于 Linux/macOS/Windows（WSL）。

1. 安装 NVM

Linux/macOS

通过脚本自动安装：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

或使用 wget：

wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

配置环境变量：

安装完成后，在 ~/.bashrc、~/.zshrc 或 ~/.profile 中自动添加以下内容。如果没有，手动添加：

export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"  # 加载 nvm
[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"  # 自动补全

生效配置：

source ~/.bashrc  # 或 source ~/.zshrc

Windows

Windows 用户需使用 nvm-windows（独立项目）：

  1. 卸载已安装的 Node.js（避免冲突）。
  2. 下载安装包：nvm-windows 最新版。
  3. 以管理员身份运行安装程序，完成后重启终端。

验证安装：

nvm version

2. 常用命令

安装与管理 Node.js 版本

命令 说明
nvm install <version> 安装指定版本（如 nvm install 18.16.0）
nvm install --lts 安装最新的 LTS 版本
nvm uninstall <version> 卸载指定版本
nvm use <version> 切换版本（临时生效）
nvm alias default <version> 设置默认版本（永久生效）
nvm ls 查看已安装的所有版本
nvm ls-remote 查看所有可安装的远程版本

示例：安装并使用 LTS 版本

nvm install --lts
nvm use --lts
nvm alias default 'lts/*'  # 设置默认版本为最新 LTS

3. 多版本项目管理

为不同项目指定 Node 版本

在项目根目录创建 .nvmrc 文件，写入版本号（如 18.16.0），运行以下命令自动切换：

nvm use

全局与项目级包管理

  • 全局包：安装在当前 Node 版本下，所有项目共享。 
    npm install -g yarn
  • 项目级包：安装在项目 node_modules 中，版本隔离。 
    npm install

4. 常见问题解决

1. nvm 命令未找到

  • 原因：Shell 配置未生效。
  • 解决： 
    source ~/.bashrc  # 或 source ~/.zshrc
    检查 ~/.bashrc 是否包含 NVM 环境变量配置。

2. 安装慢或失败

  • 换源（中国大陆用户）： 
    export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node
nvm install 16

3. Windows 权限问题

  • 以管理员身份运行终端。
  • 检查安装路径无空格或特殊字符（如 C:\nvm）。

5. 卸载 NVM

Linux/macOS

rm -rf ~/.nvm

然后删除 ~/.bashrc 或 ~/.zshrc 中的 NVM 相关配置。

Windows

通过控制面板卸载 nvm-windows，并手动删除安装目录（默认 C:\Users\<user>\AppData\Roaming\nvm）。

总结

  • 核心功能：快速切换 Node.js 版本，解决版本冲突问题。
  • 最佳实践：为每个项目配置 .nvmrc，保持环境一致性。
  • 跨平台支持：Linux/macOS 使用原生 NVM，Windows 使用 nvm-windows。

通过 NVM，你可以轻松管理多个 Node.js 版本，提升开发效率！ 🚀

No Comments
Back to top