nvm 是最稳妥的 Node 版本管理方式,安装在用户目录下,不干扰系统 Node。推荐用 Homebrew 安装 nvm,再配置环境变量、安装多版本、设置默认版及项目自动匹配,并统一 npm 全局安装路径至用户目录。
直接用 nvm 配置是最稳妥、最常用的方式。它不干扰系统自带或全局安装的 node,所有版本都存在你自己的用户目录下,切换干净利落,项目之间完全隔离。
用 Homebrew 安装 nvm(推荐新手)
Homebrew 能自动处理路径和依赖,省去手动改配置文件的麻烦:
- 先确认已装 Homebrew:终端运行
brew -v,有版本号就跳过安装;没有就执行:/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" - 安装 nvm:
brew install nvm - 创建 nvm 存放目录并配置环境变量:
mkdir ~/.nvmecho 'export NVM_DIR="$HOME/.nvm"' >> ~/.zshrcecho '[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"' >> ~/.zshrc - 重载配置:
source ~/.zshrc - 验证:
nvm -v应输出版本号
用 nvm 安装和切换多个 Node 版本
装好 nvm 后,版本管理就变成几条命令的事:
- 查看所有可安装版本:
nvm list-remote(带--lts可只看长期支持版) - 安装常用版本(例如):
nvm install 16.20.2nvm install --ltsnvm install 20.12.0 - 设置默认启动版本:
nvm alias default 18.19.0 - 在当前终端切换版本:
nvm use 16.20.2 - 查看当前生效版本:
nvm current和node -v应一致
让项目自动匹配 Node 版本(可选但实用)
避免每次进项目都手动 nvm use,可以加一个版本声明文件:
- 在项目根目录新建
.nvmrc,内容只写一行,比如:16.20.2 - 进入该目录后,运行
nvm use(不带参数),nvm 会自动读取并切换到指定版本 - 还可配合 shell hook 实现“cd 进目录自动切换”,需要额外在
~/.zshrc中添加一段脚本(如需可提供)
避开常见权限与路径问题
npm 全局安装包(如 vue-cli、pnpm)容易因权限报错,建议统一配到用户目录:
- 创建全局安装目录:
mkdir ~/.npm-global - 配置 npm 使用该目录:
npm config set prefix '~/.npm-global' - 把该目录加入 PATH:
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc - 重载:
source ~/.zshrc - 之后
npm install -g就不再需要sudo,也不会污染系统路径


















