MacOS下使用nvm切换Node版本后node -v显示不匹配问题

从你的命令输出能看出，nvm已将默认版本设为v18.17.1，但终端仍使用系统自带的v14.17.5，大概率是nvm未正确加载或路径优先级问题，按以下步骤排查：

1. 确认nvm已正确加载到Shell配置文件 #

MacOS默认使用zsh，检查~/.zshrc文件（若用bash则检查~/.bashrc或~/.bash_profile），确认是否包含nvm的初始化代码：

export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"  # 加载nvm
[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"  # 加载nvm自动补全

如果没有，手动添加上述代码到对应配置文件，然后执行source ~/.zshrc（对应你的Shell类型）使配置生效。

2. 重新设置默认版本并切换 #

执行以下命令强制切换并绑定默认版本：

nvm use 18.17.1
nvm alias default 18.17.1

完成后新开终端，执行node -v验证版本是否切换成功。

3. 检查PATH路径优先级 #

执行echo $PATH，查看输出中nvm的Node路径（/Users/foobar/.nvm/versions/node/v18.17.1/bin）是否在系统Node路径（比如/usr/local/bin）之前。如果系统路径在前，说明系统Node优先级更高，需调整Shell配置文件，将nvm的路径放到PATH最前面：

export PATH="$NVM_DIR/versions/node/v18.17.1/bin:$PATH"

添加后执行source ~/.zshrc生效。

4. 排查其他Node版本管理工具冲突 #

如果你之前安装过n、fnm等其他Node版本管理工具，它们可能干扰nvm的工作。可以暂时禁用这些工具的初始化代码（注释掉配置文件中相关内容），或卸载后再测试nvm是否正常工作。

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