Mac M1 Pro环境执行npm install/ci时全局变量报错求助

1. 修正Python环境变量（别用别名，直接绑定绝对路径） #

• 先查你当前Python3的实际路径：which python3，比如会得到/opt/homebrew/bin/python3
• 打开~/.zshrc，添加两行：

  export PYTHON=/opt/homebrew/bin/python3
  export PYTHON3=/opt/homebrew/bin/python3
  

• 执行source ~/.zshrc让配置生效，再用echo $PYTHON和echo $PYTHON3确认路径正确

2. 强制npm指定Python版本 #

• 直接给npm硬设Python路径，不用依赖系统全局配置：

  npm config set python /opt/homebrew/bin/python3
  

• 用npm config get python验证，确保输出的是你刚才查的路径

3. 适配M1的arm64架构 #

• 很多npm原生依赖需要适配arm64，执行命令前加架构指定：

  arch -arm64 npm install
  # 用ci的话就换成
  arch -arm64 npm ci
  

• 如果还是不行，试试切换到x86架构（先装Rosetta：softwareupdate --install-rosetta）：

  arch -x86_64 zsh
  # 切换后重新装对应架构的Node（用nvm的话）
  nvm install --arch=x64 <你的项目要求的Node版本>
  nvm use <对应版本>
  # 再执行安装命令
  npm install
  

4. 清理缓存和残留文件 #

• 先清npm缓存：

  npm cache clean --force
  

• 删除项目里的node_modules和锁文件：

  rm -rf node_modules package-lock.json
  

• 之后重新执行npm install或npm ci

5. 匹配项目要求的Node版本 #

• 看项目package.json里的engines字段，用nvm切换到指定版本：

  nvm install <指定版本号>
  nvm use <指定版本号>
  

  版本不匹配很容易导致依赖编译出错，别强行用最新版Node

内容的提问来源于stack exchange，提问作者Kacper Łęczyński