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

解决方法：

1. 确保正确配置了 shell 文件（.zshrc 或 .bash_profile）

2. 执行 source ~/.zshrc（或对应的配置文件）

3. 检查 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

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

解决方法：

1. 设置默认别名：

   nvm alias default 20.13.1

2. 确保在 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 也会随之更新。