MacOS M4本地搭建Supabase仓库失败，执行pnpm install报错求助

开发者阿泽

2026-6-14

解决MacOS M4芯片本地搭建Supabase时pnpm install报错的方案

检查Node.js与pnpm版本兼容性
Supabase官方要求Node.js 18.x及以上、pnpm 8.x及以上版本。先确认当前版本：
```
node -v
pnpm -v
```
若版本不符，用nvm切换Node版本（需先安装nvm）：
```
nvm install 18
nvm use 18
npm install -g pnpm@8
```
完成后重新执行pnpm install。
清理pnpm缓存
缓存损坏可能导致依赖安装失败，执行以下命令清理缓存后重试：
```
pnpm store prune
pnpm install
```
适配ARM64架构编译依赖
M4芯片是ARM64架构，部分依赖需指定架构编译，先设置环境变量：
```
export ARCH=arm64
export npm_config_arch=arm64
```
重启终端后再执行pnpm install。
确保Xcode编译工具完整
部分原生依赖需要Xcode Command Line Tools支持，执行以下命令安装或更新：
```
xcode-select --install
```
安装完成后重启终端，重新运行pnpm install。
临时关闭严格peer依赖检查（针对版本冲突报错）
若报错提示peer依赖版本不兼容，可临时关闭严格模式：
```
pnpm install --strict-peer-dependencies=false
```
注意：此为临时解决方案，后续建议排查依赖冲突根源，避免潜在问题。