M1 Mac(arm64)安装Nuxt3依赖时npm失败及Node版本问题排查

问题场景 #

在x64架构电脑上创建初始状态的Nuxt3项目，克隆到M1 Mac后执行npm install时出现异常。

错误表现 #

• 核心报错：找不到@rollup/rollup-darwin-x64，同时提示npm存在可选依赖相关bug
• 附加警告：Node.js 17.4.0版本过低，但本地原本以为只安装了v21版本

尝试过的无效操作 #

• 更新npm到最新版本
• 执行npm cache clean --force清理缓存
• 修改package-lock.json中的依赖版本或架构相关配置

最终根因与解决方案 #

根因 #

本地存在遗留的全局Node v17版本，该版本会干扰npm的依赖拉取逻辑：npm基于旧版本的Node架构判断（x64），尝试拉取对应架构的rollup包，而M1 Mac需要的是arm64版本；同时旧版本本身触发了版本过低警告。

解决步骤 #

1. 检查当前全局Node版本：

   node -v
   

   确认是否确实存在v17版本残留
2. 彻底卸载遗留的Node v17版本（根据你使用的版本管理工具操作，比如nvm、n或官方卸载脚本）
3. 切换并锁定到Node v21版本：

   # 若使用nvm
   nvm use 21
   nvm alias default 21
   

4. 删除项目下的node_modules和package-lock.json，重新执行：

   npm install
   

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