Macbook M1芯片上Node.js安装ref-napi失败求助

问题根源 #

从错误日志的关键报错能直接定位问题：

clang: error: no such file or directory: 'TFG/hola/node_modules/node-addon-api'

你的项目路径/Users/juanan/Desktop/Paper TFG/hola包含空格（Paper TFG部分），导致node-gyp构建时路径被截断，clang无法识别完整的依赖文件路径。

解决方案 #

方案1：迁移项目到无空格路径（推荐） #

• 把带空格的文件夹重命名，比如将Paper TFG改为PaperTFG，项目路径变为/Users/juanan/Desktop/PaperTFG/hola
• 清空项目下的依赖文件和锁文件：

  rm -rf node_modules package-lock.json
  

• 重新执行安装命令：

  npm install ref-napi
  

方案2：临时处理路径空格（不推荐） #

如果无法迁移项目，可尝试通过环境变量让npm兼容带空格的路径：

npm config set script-shell /bin/bash
npm install ref-napi --unsafe-perm=true --allow-root

注：此方法可能存在兼容性风险，优先选方案1。

验证 #

完成操作后，可执行node-gyp configure && node-gyp build验证构建是否正常，确认ref-napi安装成功。

内容的提问来源于stack exchange，提问作者Juan Antonio Martinez Lopez