从零到一：nvm 安装、配置与多版本 Node.js 管理实战

1. 为什么需要nvm？

刚接触Node.js开发时，我经常遇到这样的困扰：不同项目需要不同版本的Node.js运行环境。比如公司老项目用的是Node.js 12.x，而新项目要求16.x以上版本。每次切换项目都要重新安装Node.js，不仅麻烦还容易出错。

这时候nvm（Node Version Manager）就派上用场了。它就像个智能遥控器，可以同时管理多个Node.js版本，一键切换毫无压力。我实测下来，用nvm管理版本比手动安装卸载要稳得多，再也不用担心版本冲突问题了。

2. 安装前的准备工作

2.1 检查并卸载旧版Node.js

在安装nvm前，强烈建议先检查系统是否已安装Node.js。我踩过的坑告诉你：如果已有Node.js没卸载干净，nvm可能会工作不正常。

Windows用户可以通过控制面板卸载：

1. 打开"程序和功能"
2. 搜索"Node.js"
3. 右键选择卸载

Mac/Linux用户可以直接在终端运行：

which node

如果返回路径，说明已安装，需要先卸载。

2.2 清理残留文件

卸载程序后，这些地方可能还有残留：

• Windows：删除C:\Program Files\nodejs和用户目录下的.npmrc文件
• Mac/Linux：删除/usr/local/bin/node和/usr/local/lib/node_modules

记得检查环境变量，删除所有与Node.js相关的PATH设置。我建议重启电脑确保完全清理。

3. 安装nvm的三种方式

3.1 官方脚本安装（推荐）

这是最简便的安装方式，一行命令搞定：

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

或者用wget：

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

安装完成后，需要重新打开终端或者运行：

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

3.2 国内镜像安装

如果网络连接不稳定，可以使用国内镜像源：

bash -c "$(curl -fsSL https://gitee.com/RubyKids/nvm-cn/raw/master/install.sh)"

3.3 手动安装

适合需要自定义安装路径的高级用户：

1. 从GitHub下载nvm源码包
2. 解压后找到install.sh
3. 执行安装脚本：

sh /path/to/install.sh

4. 配置nvm环境

安装完成后，需要确认nvm是否正常工作：

nvm --version

如果报错"command not found"，可能是shell配置文件没有自动更新。手动添加以下内容到你的.bashrc或.zshrc文件：

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

然后重新加载配置文件：

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

5. 使用nvm管理Node.js版本

5.1 安装Node.js版本

查看可安装的版本：

nvm ls-remote

安装指定版本（比如16.14.0）：

nvm install 16.14.0

安装最新LTS版本：

nvm install --lts

5.2 切换Node.js版本

临时切换（仅当前终端有效）：

nvm use 16.14.0

设置默认版本（所有新终端生效）：

nvm alias default 16.14.0

5.3 版本管理

查看已安装版本：

nvm ls

卸载指定版本：

nvm uninstall 14.17.0

6. 常见问题解决

6.1 切换版本不生效

这个问题我遇到过多次，特别是在VSCode中。解决方法：

1. 完全关闭所有终端和编辑器
2. 重新打开后再次执行nvm use命令
3. 如果还不行，尝试重启电脑

6.2 安装速度慢

可以设置淘宝镜像加速下载：

export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node/

然后重新安装Node.js版本。

6.3 全局包丢失

切换版本后，之前安装的全局包可能不可用。解决方法：

1. 列出当前版本的全局包：

npm ls -g --depth=0

2. 在新版本中重新安装：

nvm reinstall-packages <旧版本号>

7. 高级技巧

7.1 为项目自动切换版本

在项目根目录创建.nvmrc文件，写入需要的Node.js版本号：

16.14.0

然后运行：

nvm use

nvm会自动读取文件并切换版本。

7.2 多版本并行测试

可以用nvm同时安装多个版本，然后通过脚本测试兼容性：

nvm run 14.17.0 test.js nvm run 16.14.0 test.js

7.3 自定义安装路径

通过环境变量可以自定义nvm和Node.js的安装位置：

export NVM_DIR="/custom/path/to/nvm"

8. 卸载nvm

如果不再需要nvm，可以完全卸载：

8.1 删除nvm目录

rm -rf ~/.nvm

8.2 清理配置文件

从.bashrc、.zshrc等文件中删除nvm相关配置。

8.3 删除环境变量

检查并删除所有与nvm相关的环境变量设置。

在实际项目开发中，nvm已经成为我必不可少的工具。特别是当需要维护多个历史项目时，版本切换变得非常轻松。刚开始使用时可能会遇到一些小问题，但只要按照上述步骤操作，很快就能掌握这个强大的版本管理工具。