mac 通过homebrew 安装和使用nvm

[1. 安装 Homebrew（如未安装）](#1. 安装 Homebrew（如未安装）)

[2. 安装 nvm](#2. 安装 nvm)

[3. 配置环境变量](#3. 配置环境变量)

[对于 zsh（macOS Catalina 及以后默认）](#对于 zsh（macOS Catalina 及以后默认）)

[对于 bash](#对于 bash)

[4. 应用配置](#4. 应用配置)

[5. 验证安装](#5. 验证安装)

[6. 使用 nvm](#6. 使用 nvm)

[安装 Node.js 版本](#安装 Node.js 版本)

列出可用版本

[切换 Node.js 版本](#切换 Node.js 版本)

设置默认版本

[运行特定版本的 Node.js](#运行特定版本的 Node.js)

查看当前版本

[卸载 Node.js 版本](#卸载 Node.js 版本)

[7. 解决常见问题](#7. 解决常见问题)

[问题：nvm: command not found](#问题：nvm: command not found)

问题：不同终端会话中版本不一致

[8. 高级用法](#8. 高级用法)

在每个项目中使用不同版本

安装全局包时不重复安装

[9. 卸载 nvm](#9. 卸载 nvm)

总结命令速查表

在 macOS 上通过 Homebrew 安装和使用 nvm 的完整指南。

1. 安装 Homebrew（如未安装）

复制代码

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

2. 安装 nvm

复制代码

brew install nvm

3. 配置环境变量

根据你的 shell 类型配置（推荐使用 zsh）：

对于 zsh（macOS Catalina 及以后默认）

复制代码

echo 'export NVM_DIR="$HOME/.nvm"' >> ~/.zshrc
echo '[ -s "/usr/local/opt/nvm/nvm.sh" ] && \. "/usr/local/opt/nvm/nvm.sh"  # Load nvm' >> ~/.zshrc
echo '[ -s "/usr/local/opt/nvm/etc/bash_completion.d/nvm" ] && \. "/usr/local/opt/nvm/etc/bash_completion.d/nvm"  # Load nvm completion' >> ~/.zshrc

对于 bash

复制代码

echo 'export NVM_DIR="$HOME/.nvm"' >> ~/.bash_profile
echo '[ -s "/usr/local/opt/nvm/nvm.sh" ] && \. "/usr/local/opt/nvm/nvm.sh"' >> ~/.bash_profile
echo '[ -s "/usr/local/opt/nvm/etc/bash_completion.d/nvm" ] && \. "/usr/local/opt/nvm/etc/bash_completion.d/nvm"' >> ~/.bash_profile

4. 应用配置

复制代码

source ~/.zshrc  # 或 source ~/.bash_profile

5. 验证安装

复制代码

nvm --version
# 应该显示版本号，如：0.39.5

6. 使用 nvm

安装 Node.js 版本

复制代码

# 安装最新 LTS 版本
nvm install --lts

# 安装特定版本
nvm install 20.13.1

# 安装最新版本
nvm install node

列出可用版本

复制代码

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

切换 Node.js 版本

复制代码

nvm use 18.20.2     # 切换到指定版本
nvm use --lts       # 切换到 LTS 版本
nvm use node        # 切换到最新版本

设置默认版本

复制代码

nvm alias default 20.13.1

运行特定版本的 Node.js

复制代码

nvm run 18.20.2 app.js

查看当前版本

复制代码

nvm current

卸载 Node.js 版本

复制代码

nvm uninstall 16.20.2

7. 解决常见问题

问题：`nvm: command not found`

解决方法：

确保正确配置了 shell 文件（.zshrc 或 .bash_profile）
执行 source ~/.zshrc（或对应的配置文件）

检查 Homebrew 安装路径：

复制代码

echo 'export NVM_DIR="$HOME/.nvm"' >> ~/.zshrc
echo '[ -s "/opt/homebrew/opt/nvm/nvm.sh" ] && \. "/opt/homebrew/opt/nvm/nvm.sh"' >> ~/.zshrc
echo '[ -s "/opt/homebrew/opt/nvm/etc/bash_completion.d/nvm" ] && \. "/opt/homebrew/opt/nvm/etc/bash_completion.d/nvm"' >> ~/.zshrc

问题：不同终端会话中版本不一致

解决方法：

设置默认别名：
复制代码
```
nvm alias default 20.13.1
```
确保在 shell 配置文件中设置了默认版本

8. 高级用法

在每个项目中使用不同版本

在项目根目录创建 .nvmrc 文件：

复制代码

echo "20.13.1" > .nvmrc

然后运行：

复制代码

nvm use  # 自动使用 .nvmrc 中指定的版本

安装全局包时不重复安装

复制代码

npm config set prefix ~/.npm-global
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

9. 卸载 nvm

复制代码

brew uninstall nvm
rm -rf ~/.nvm
# 然后从 .zshrc 或 .bash_profile 中删除 nvm 相关行

总结命令速查表

命令	描述
`nvm install --lts`	安装最新 LTS 版本
`nvm use 18.20.2`	切换到指定版本
`nvm alias default 20.13.1`	设置默认版本
`nvm ls`	列出已安装版本
`nvm ls-remote`	列出远程可用版本
`nvm current`	显示当前版本
`nvm run 16.20.2 app.js`	用指定版本运行脚本
`nvm uninstall 16.20.2`	卸载指定版本

通过 Homebrew 安装的 nvm 会自动更新，当你运行 brew upgrade 时，nvm 也会随之更新。