三十的博客

Mac 系统下 Node.js 环境配置指南：使用 NVM 管理多版本

发布时间
最后更新
阅读量 加载中...

什么是 NVM？

🔗 官方文档

NVM (Node Version Manager) 是一个命令行工具，允许你在同一台计算机上安装和管理多个 Node.js 版本。主要功能包括：

📌 官方声明：NVM 不推荐 通过 Homebrew 安装，可能导致权限问题

安装步骤

卸载旧版本（如有）

bash 
rm -rf ~/.nvm

官方脚本安装（推荐）

国际网络用户

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

国内用户加速方案

bash 
bash -c "$(curl -fsSL https://gitee.com/mirrors/nvm/raw/v0.39.5/install.sh)"

配置立即生效

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

✅ 验证安装：执行 nvm --version 应显示版本号

基础使用

安装 Node.js

bash 
# 安装最新LTS版本（推荐）
nvm install --lts

# 安装指定版本
nvm install 20.15.0

# 验证安装
node -v  # 显示Node.js版本
npm -v   # 显示npm版本

版本管理

bash 
# 查看已安装版本
nvm ls

# 查看远程可用版本
nvm ls-remote

# 切换版本
nvm use 18

# 设置默认版本
nvm alias default 20

镜像加速（国内必看）

  1. 编辑 shell 配置文件：
bash 
vim ~/.zshrc  # 或 ~/.bash_profile
  1. 添加以下配置：
bash 
export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node/
npm config set registry https://registry.npmmirror.com/
  1. 保存并生效：
bash 
source ~/.zshrc

项目级版本控制

  1. 在项目根目录创建 .nvmrc 文件：
bash 
echo "20.15.0" > .nvmrc
  1. 进入目录自动切换版本：
bash 
nvm use

常见问题

1. 命令未找到

bash 
# 检查环境变量配置
cat ~/.zshrc | grep nvm

# 重新加载配置
source ~/.zshrc

2. 安装失败

bash 
# 使用镜像重试
NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node/ nvm install 18

3. 权限问题

bash 
sudo chown -R $(whoami) ~/.nvm

完整卸载

bash 
rm -rf ~/.nvm
sed -i '' '/nvm/d' ~/.zshrc  # 删除配置项

最佳实践

多版本测试 ​

bash 
nvm exec 16 node app.js

查看版本详情 ​

bash 
nvm version-remote --lts

快速安装 npm 包 ​

bash 
nvm use 20 && npm install -g yarn
#Env #Mac #Nodejs #工具