使用 NVM 管理 Node.js 版本指南（Mac 和 Windows 环境）通过 NVM 可方便管理 Node.js

使用 NVM 管理 Node.js 版本指南（Mac 和 Windows 环境）

一、Mac 环境安装与配置 NVM

1. 安装 NVM

使用 Homebrew 安装 NVM：

brew install nvm

2. 配置环境变量

安装完成后，需要在终端的配置文件中添加 NVM 的环境变量。对于常见的 zsh 环境：

打开 .zshrc 文件：
```
nano ~/.zshrc
```

在文件末尾添加以下内容：

export NVM_DIR="$HOME/.nvm"
[ -s "/opt/homebrew/opt/nvm/nvm.sh" ] && . "/opt/homebrew/opt/nvm/nvm.sh"
[ -s "/opt/homebrew/opt/nvm/etc/bash_completion.d/nvm" ] && . "/opt/homebrew/opt/nvm/etc/bash_completion.d/nvm"

3. 重新加载配置文件

保存修改后，运行以下命令重新加载配置：

source ~/.zshrc

4. 验证安装

执行以下命令检查 NVM 是否安装成功：

nvm -v

如果显示 NVM 版本号，说明安装成功。

二、Windows 环境安装与配置 NVM

1. 下载 NVM for Windows

从 NVM for Windows 官方 GitHub 下载最新版本的安装包。

2. 卸载独立安装的 Node.js（如有）

在安装 NVM 前，如果系统中已经独立安装了 Node.js，需先卸载，以避免冲突：

打开控制面板，卸载 Node.js。
删除以下文件夹（如存在）：
- 用户目录下的 npm、npm-cache 文件夹。
- 以 node 开头的文件夹（如 .node-gyp）。

3. 安装 NVM

运行下载的安装包，按照指引完成安装。注意：避免选择路径中包含中文或空格的目录

4. 验证安装

打开 PowerShell（以管理员身份运行），输入以下命令验证安装：

nvm -v

如果显示 NVM 版本号，说明安装成功。

三、NVM 的常用命令

命令	功能说明
`nvm list available`	查看全部可用的 Node.js 版本
`nvm install <版本号>`	安装指定版本的 Node.js
`nvm use <版本号>`	切换到指定版本的 Node.js
`nvm list`	查看本地已安装的 Node.js 版本
`nvm uninstall <版本号>`	卸载指定版本的 Node.js
`nvm -h`	查看 NVM 的帮助文档

四、使用 NVM 安装 Node.js 18 的示例

以下是通过 NVM 安装 Node.js 18 的详细步骤和示例操作：

1. 查看可用的 Node.js 版本

首先，可以通过以下命令查看所有可用的 Node.js 版本：

nvm list available

输出示例（部分截取）：

这里显示了所有可用的版本，包括 LTS 和最新版本。

2. 安装 Node.js 18

假设需要安装 Node.js 18 的最新版本（如 v18.17.1）：

nvm install 18

输出示例：

Downloading and installing node v18.17.1...
Downloading https://nodejs.org/dist/v18.17.1/node-v18.17.1-darwin-x64.tar.xz...
Now using node v18.17.1 (npm v9.6.7)

NVM 会自动安装指定版本的 Node.js，并将其切换为当前使用的版本。

3. 验证安装的版本

安装完成后，可以运行以下命令确认当前 Node.js 版本：

node -v

输出示例：

v18.17.1

同时，也可以通过以下命令查看当前使用的 Node.js 版本：

nvm current

输出示例：

v18.17.1

4. 切换其他版本（如 Node.js 14）

如果已经安装了多个版本的 Node.js，可以通过以下命令快速切换：

nvm use 14

验证切换后的版本：

node -v

输出示例：

v14.21.3

通过以上步骤，您可以轻松使用 NVM 安装并管理多个 Node.js 版本，包括 Node.js 18 的最新或指定版本。

五、常见问题及解决方案

1. `exit status 1` 或 `exit status 145`

问题描述：切换 Node.js 版本时报错。
可能原因：

安装路径包含中文或空格。
权限不足，无法访问目录。

解决方案：

确保安装路径中无中文或空格。
在管理员模式下运行终端，重新尝试切换版本。

2. NVM 命令无法识别

可能原因：

环境变量未正确配置（Mac）。
PowerShell 未以管理员模式运行（Windows）。

解决方案：

检查 .zshrc 文件中的 NVM 配置是否正确（Mac）。
确保终端以管理员模式运行（Windows）。

3. Node.js 下载缓慢

解决方案：

修改 NVM 配置文件（Windows）：
- 打开 NVM 安装目录下的 settings.txt 文件，添加以下内容：
```
node_mirror: http://npmmirror.com/mirrors/node/
npm_mirror: http://npmmirror.com/mirrors/npm/
```

4. NPM 安装失败或版本异常

解决方案：

找到 Node.js 对应的 NPM 版本：Node.js 版本历史。
从 NPM 官方 GitHub 下载对应版本的压缩包，并手动放置到 NVM 存放的 Node.js 版本目录中：
- 解压后，将 npm 文件夹放入 node_modules 目录。
- 将 npm/bin 中的 npm、npm.cmd、npx、npx.cmd 文件放置到与 node_modules 同级目录。

六、总结

通过 NVM，我们可以方便地安装和切换多个版本的 Node.js，无论是在 Mac 还是 Windows 环境下，都能显著提升开发效率。在实际使用中，注意路径配置、权限问题，并结合常见问题的解决方案，确保工具稳定运行。

推荐资源：

使用 NVM 管理 Node.js 版本指南（Mac 和 Windows 环境）