mac 通过homebrew 安装和使用nvm

目录

1. 安装 Homebrew（如未安装）

2. 安装 nvm

3. 配置环境变量

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

对于 bash

4. 应用配置

5. 验证安装

6. 使用 nvm

安装 Node.js 版本

列出可用版本

切换 Node.js 版本

设置默认版本

运行特定版本的 Node.js

查看当前版本

卸载 Node.js 版本

7. 解决常见问题

问题：nvm: command not found

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

8. 高级用法

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

安装全局包时不重复安装

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 相关行

总结命令速查表

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