Mac使用nvm安装Node时出现不存在旧用户名的权限错误

根本原因 #

你的nvm环境变量或配置中缓存了旧的用户路径，大概率是迁移系统、修改Mac用户名时，未同步更新nvm依赖的HOME环境变量，导致nvm尝试访问不存在的旧用户目录。

逐个解答你的困惑 #

• 为什么会执行mkdir操作？
  nvm安装Node时，会先在$HOME/.nvm/.cache目录下载安装包，再解压到对应版本目录。如果HOME被错误设置为旧用户名路径，nvm会先尝试创建这个不存在的旧用户根目录，因此触发了mkdir命令。

• 为什么提示“Permission denied”而非“Doesn't exist”？
  Mac的/Users目录归root用户所有，普通用户没有在该目录下创建新用户文件夹的权限。当nvm尝试在/Users下创建旧用户名目录时，系统直接返回权限拒绝——权限错误的优先级高于“目录不存在”，所以先抛出权限报错。

• 为什么nvm找不到明明存在的v16.8.1版本？
  这是路径错误引发的连锁假报错：mkdir失败后，nvm中断了后续的版本查找、下载流程，所以提示“版本未找到”，实际问题并非版本不存在，而是前置的目录创建失败。

解决步骤 #

1. 检查当前HOME变量：执行命令

   echo $HOME
   

   确认输出是否为旧用户名路径。
2. 修正HOME环境变量：
   • 打开终端配置文件（zsh用户用~/.zshrc，bash用户用~/.bash_profile），查找是否有手动设置HOME的行，将其修改为当前用户路径（例如/Users/your-current-name），或直接删除该行。
   • 执行命令使配置生效：

     source ~/.zshrc  # zsh用户
     # 或 source ~/.bash_profile  # bash用户
     

3. 重置nvm：执行

   nvm unload && nvm load
   

   或直接重启终端。
4. 重新安装Node：

   nvm install v16.8.1
   

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