Windows环境下node-gyp安装失败，无法运行node canvas相关命令

看起来你在安装node-canvas时被node-gyp的路径问题绊住了，我之前在Windows环境下折腾原生模块时也遇到过类似的坑，给你梳理几个针对性的解决步骤：

先搞定「node-gyp: command not found」的问题 #

这个错误本质是系统没找到node-gyp的可执行文件，大概率是没全局安装或者PATH配置有问题：

1. 全局安装node-gyp（用Windows原生终端）
   别先用Git Bash，打开CMD或者PowerShell（右键以管理员身份运行更好），执行：

   npm install -g node-gyp
   

   安装完成后直接输入node-gyp -v，如果能输出版本号，说明全局安装成功了。

2. 修复Git Bash的PATH配置
   Git Bash的环境变量和Windows系统PATH经常有差异，你可以在Git Bash里先运行echo $PATH，看看你的全局npm路径（一般是C:\Users\davidlop\AppData\Roaming\npm）有没有在输出里。如果没有，手动添加：

   export PATH="$PATH:/c/Users/davidlop/AppData/Roaming/npm"
   

   之后再试试node-gyp命令，应该就能找到了。

解决「Cannot find module ... node-gyp.js」的错误 #

这个错误说明Git Bash在错误的路径（Git安装目录）里找node-gyp，这是路径优先级混乱导致的：

1. 清理Git目录下的错误node-gyp
   打开Git Bash，执行以下命令卸载Git安装目录下的node-gyp：

   cd "/c/Program Files/Git"
   npm uninstall node-gyp
   

   这样就能清除掉错误位置的残留文件。

2. 调整系统PATH的优先级
   打开Windows的「环境变量」设置，找到系统PATH，把C:\Users\davidlop\AppData\Roaming\npm移到C:\Program Files\Git\bin的前面。这样系统会优先找全局npm的命令，而不是Git目录下的。

3. 换用PowerShell执行重建命令
   Git Bash的路径解析偶尔会抽风，换成Windows原生的PowerShell，运行你的重建命令：

   node-gyp rebuild --GTK_Root=C:\Users\davidlop\Documents\Software\GTK
   

   注意路径用Windows原生的反斜杠，不要改成Git Bash的斜杠格式。

额外的排查小技巧 #

• 确认Python配置正确：运行npm config get python，输出应该是Python2.7的完整路径（比如C:\Python27\python.exe）。如果不是，执行npm config set python C:\Python27\python.exe来修正。
• 检查GTK路径有效性：确保--GTK_Root指向的目录下有bin、lib等子目录，里面包含GTK的核心库文件（比如gtk-3-vs14.dll），路径错了后续编译也会失败。
• 清理npm缓存：有时候缓存会导致奇怪的问题，执行npm cache clean --force，然后重新尝试安装node-canvas或者运行node-gyp rebuild。

如果这些步骤都试过还是有问题，等你拿到日志文件后，可以重点看看是不是缺少Visual Studio的编译组件——虽然你按指南走了，但有时候需要手动勾选“Desktop development with C++” workload才能满足编译需求。

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