MacOS M2 Ventura环境下无法安装canvas的问题求助

问题核心分析 #

从报错日志可定位两个关键问题：

1. canvas@2.11.0未提供适配Node.js 16（node-v93 ABI）的M2架构预编译包，触发404错误
2. 源码编译阶段缺失pixman-1依赖包，导致node-gyp配置失败

解决方案步骤 #

1. 补全编译依赖 #

之前的brew命令遗漏了pixman，执行以下命令安装完整依赖：

brew install pkg-config cairo libpng jpeg giflib pixman

2. 适配canvas版本或强制源码编译 #

方案A：升级canvas到兼容版本

canvas后续版本已修复M2与Node.js 16的适配问题，直接安装最新稳定版：

npm install canvas@latest
# yarn环境执行：
# yarn add canvas@latest

方案B：强制源码编译（需保留旧版本时）

若必须使用canvas@2.11.0，先设置环境变量让pkg-config找到brew安装的依赖，再强制源码编译：

# 临时配置pkg-config路径
export PKG_CONFIG_PATH="/opt/homebrew/lib/pkgconfig"
# 执行安装
npm install canvas --build-from-source
# yarn环境执行：
# yarn add canvas --build-from-source

3. 清理缓存重试 #

若之前的安装缓存存在异常，先清理后重新安装：

# 清理npm缓存
npm cache clean --force
# 删除本地依赖文件
rm -rf node_modules package-lock.json
# 重新安装项目依赖
npm install

4. 验证Node.js架构（可选） #

确保Node.js为原生ARM64版本（适配M2），执行：

node -p process.arch

输出应为arm64，若显示x64说明使用了Rosetta转译，建议重新安装ARM版Node.js

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