MacOS Monterey安装配置nvm(Node Version Manager)方法咨询

全程逐行敲命令即可，每一步附预期结果，不需要啃大段原理说明，适配Windows转Mac用户的操作习惯： #

前置清理（必做，避免90%安装冲突） #

打开终端（Launchpad搜索「终端」即可启动，和Windows下启动CMD/PowerShell的逻辑一致），逐行执行以下命令，清理之前残留的nvm、手动安装/brew安装的node文件：

rm -rf ~/.nvm ~/.npm ~/.node-gyp
rm -rf /usr/local/lib/node* /usr/local/include/node*
rm -rf /usr/local/bin/node* /usr/local/bin/npm*
brew uninstall --ignore-dependencies node 2>/dev/null

说明：这步只会清除系统层面的node相关文件，不会影响其他个人文件，执行完没有任何输出是正常现象。

安装nvm主程序 #

终端内直接执行安装命令：

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

• 预期结果：命令跑完后终端会输出一段安装日志，最后提示=> Close and reopen your terminal to start using nvm or run the following to use it now就是安装完成。

环境变量配置（Monterey专属，老教程最容易错的步骤） #

MacOS Monterey默认使用zsh作为终端，环境变量需要写入.zshrc才会永久生效，逐行执行以下3条命令，执行完无输出是正常状态：

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

执行完加载配置，让配置立刻生效：

source ~/.zshrc

• 验证是否配置成功：终端输入nvm -v，如果输出0.39.7这类版本号，没有报command not found错误，就是配置完成。

日常使用命令（和Windows版nvm逻辑完全一致） #

• 安装Node.js长期支持版（最稳定，日常开发推荐）：nvm install --lts
• 查看本地已安装的所有Node.js版本：nvm ls
• 切换到指定版本的Node.js：nvm use <版本号>，例：nvm use 20.11.0
• 设置默认全局使用的Node.js版本，避免每次开终端都要重新切换：nvm alias default lts/*
• 验证Node.js是否安装成功：输入node -v、npm -v能正常输出版本号即可。

常见问题快速排查 #

• 执行nvm命令提示command not found：重新走一遍环境变量配置步骤即可，不需要修改.bash_profile、.profile这类文件，Monterey默认终端不会加载这些文件的配置。
• 安装Node.js时提示权限错误：不要在nvm相关命令前加sudo，nvm默认安装在当前用户目录下，加sudo反而会搞坏目录权限，出现权限问题先执行sudo chown -R $USER ~/.nvm修复目录权限再重试。
• 切换Node版本不生效：先执行前置清理步骤里的命令，把brew安装的、手动安装的全局Node删掉，重启终端再重试即可。

内容的提问来源于stack exchange，提问作者Rene Rubio