Electron Forge项目node-gyp重建Canvas模块失败：找不到cairo.h文件

一、优先用预编译包跳过本地编译 #

本地编译Canvas依赖多、易出错，优先直接拉取适配Electron的预编译二进制包：

• 配置镜像源加速预编译包下载：

  yarn config set canvas_binary_host_mirror https://registry.npmmirror.com/-/binary/canvas/
  

• 卸载并重新安装Canvas，确保触发预编译包逻辑：

  yarn remove canvas
  yarn add canvas --ignore-scripts=false
  

二、本地编译的精准依赖配置（Windows） #

如果必须本地编译，补充以下操作：

• 安装GTK3 Runtime（不是开发包），将其bin目录（如C:\GTK3\bin）加到系统PATH最前端，重启终端让PATH生效。
• 手动指定cairo的头文件和库路径给编译命令：

  yarn add canvas --build-from-source --cairo-lib=C:\GTK3\lib --cairo-include=C:\GTK3\include\cairo
  

• 确认VS2022已安装桌面开发C++ workload，并勾选Windows SDK 10.0.19041.0+、MSVC v142 build tools组件，这是Windows下node-gyp编译的核心依赖。

三、适配Electron环境的模块重建 #

Electron的Node版本与系统Node可能不一致，用专用工具重建：

• 安装electron-rebuild：

  yarn add --dev electron-rebuild
  

• 强制重建Canvas模块：

  npx electron-rebuild -f -w canvas
  

四、修复GTK DLL缺失警告 #

• 将GTK3 bin目录下的所有DLL，复制到项目的node_modules/canvas/build/Release目录；或者确保GTK的bin目录已加入系统PATH（需重启终端）。
• 安装Visual C++ Redistributable for Visual Studio 2022（x64），解决底层运行时依赖。

五、修复MSBuild执行失败 #

• 打开Visual Studio Installer，执行VS2022的修复操作，排除组件损坏问题。
• 手动指定MSBuild路径给包管理器：

  yarn config set msbuild_path "C:\Program Files\Microsoft Visual Studio\2022\Community\MSBuild\Current\Bin\MSBuild.exe"
  

  注意替换为你实际的VS安装路径（如Professional版本替换Community）。

内容的提问来源于stack exchange，提问作者Hassan Inayat Chaudhry