Mac设备使用NVM无法切换Node.js版本该如何解决？

NVM版本切换失效排查解决方案 #

第一步：验证Node路径优先级 #

• 执行命令查看当前生效的Node安装路径：
  类Unix系统（Mac/Linux）：which node
  Windows系统：where node
• 如果返回的路径不是~/.nvm/versions/node/（类Unix）或NVM安装目录下的node子路径（Windows），说明存在其他全局安装的Node，环境变量优先级高于NVM。
• 解决方案：卸载非NVM路径下的Node，或者调整系统环境变量顺序，将NVM相关路径移动到所有Node相关路径的最上方。

第二步：核对Shell配置文件 #

• 打开你当前使用Shell的配置文件，常见路径为~/.bashrc、~/.zshrc、~/.bash_profile
• 确认文件中存在以下NVM加载配置：

export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"

• 若配置缺失，将上述代码添加到配置文件末尾，执行source 对应配置文件路径生效，重启终端后重试切换。

第三步：检查默认版本绑定状态 #

• 执行nvm alias default查看当前绑定的默认Node版本，若和你设置的版本不一致，重新执行nvm alias default 目标版本号绑定即可。

第四步：排查同类工具冲突 #

• 检查是否安装了n、fnm等其他Node版本管理工具，这类工具会和NVM抢占环境变量优先级，卸载冲突工具后重试。

Windows用户额外检查项 #

• NVM安装路径不能包含中文、空格、特殊字符，否则会导致路径识别失败，若存在上述问题，卸载NVM后重装到无特殊字符的纯英文路径即可。

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