NVM (Node Version Manager) 使用指南

NVM (Node Version Manager) 使用指南

简介

NVM (Node Version Manager) 是一个用于管理多个 Node.js 版本的工具。它允许你在同一台计算机上安装和切换不同版本的 Node.js。

安装指南

Windows 安装

1. 下载安装包

   • 访问 nvm-windows releases
   • 下载最新版本的 nvm-setup.exe

2. 安装步骤

   • 运行 nvm-setup.exe
   • 按照安装向导完成安装
   • 安装完成后，打开新的命令提示符或 PowerShell 窗口

3. 验证安装

   nvm version
   

macOS/Linux 安装

1. 使用 curl 安装

   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
   

2. 配置环境变量
   将以下内容添加到 ~/.zshrc 或 ~/.bash_profile：

   export NVM_DIR="$HOME/.nvm"
   [ -s "$NVM_DIR/nvm.sh" ] && . "$NVM_DIR/nvm.sh"  # This loads nvm
   [ -s "$NVM_DIR/bash_completion" ] && . "$NVM_DIR/bash_completion"  # This loads nvm bash_completion
   

3. 使配置生效

   source ~/.zshrc  # 如果使用 zsh
   # 或
   source ~/.bash_profile  # 如果使用 bash
   

基本使用

查看可用版本

nvm ls-remote          # 列出所有可用的远程版本
nvm ls                 # 列出已安装的版本

安装 Node.js

nvm install 18.19.0    # 安装指定版本
nvm install node       # 安装最新版本
nvm install lts/*      # 安装最新的 LTS 版本

切换 Node.js 版本

nvm use 18.19.0        # 切换到指定版本
nvm use node           # 切换到最新版本
nvm use lts/*          # 切换到最新的 LTS 版本

设置默认版本

nvm alias default 18.19.0  # 设置默认版本

其他常用命令

nvm current            # 显示当前使用的版本
nvm uninstall 16.0.0   # 卸载指定版本
nvm alias              # 查看所有别名
nvm which 18.19.0      # 查看指定版本的安装路径

最佳实践

1. 安装建议

   • 建议安装 LTS 版本作为主要使用版本
   • 可以同时安装多个版本进行测试
   • 为项目指定固定的 Node.js 版本

2. 项目配置

   • 在项目根目录创建 .nvmrc 文件指定 Node.js 版本：

     echo "18.19.0" > .nvmrc
     

   • 进入项目目录时自动切换版本：

     nvm use
     

3. 版本切换

   • 在不同项目间切换时，使用 nvm use 命令
   • 设置一个默认版本避免每次都要手动切换

常见问题解决

1. Windows 环境变量问题

   • 确保 NVM_HOME 和 NVM_SYMLINK 环境变量正确设置
   • 重启命令提示符或 PowerShell

2. macOS/Linux 权限问题

   chmod +x ~/.nvm/nvm.sh
   

3. 安装失败解决方案

   • 检查网络连接
   • 使用镜像源
   • 清理缓存后重试

使用技巧

1. 使用别名

   nvm alias mynode 18.19.0  # 创建别名
   nvm use mynode            # 使用别名
   

2. 自动切换版本

   • 在项目中使用 .nvmrc 文件
   • 配合 shell 脚本实现自动切换

3. 性能优化

   • 及时清理不用的版本
   • 定期更新 nvm 本身

注意事项

1. 版本管理

   • 不要同时使用系统全局安装的 Node.js
   • 保持 nvm 为唯一的 Node.js 版本管理工具

2. 全局包管理

   • 每个 Node.js 版本都有独立的全局包
   • 切换版本后需要重新安装全局包

3. 项目依赖

   • 确保团队使用相同的 Node.js 版本
   • 在 package.json 中指定 engines 字段