npm ERR! code 1：canvas模块安装失败求助（网络异常）

问题核心 #

安装canvas@2.9.3适配Node.js 18.10.0时，因网络问题无法解析github.com域名，导致预编译二进制文件下载失败；回退源码编译时，同样因网络无法获取Node.js头文件，最终触发npm ERR! code 1错误，日志路径：C:\Users\user\AppData\Local\npm-cache\_logs\2022-09-30T11_42_19_512Z-debug-0.log

解决步骤 #

• 检查网络与代理配置

  1. 先验证网络连通性：执行ping github.com，或用浏览器打开github.com确认能否正常访问
  2. 查看当前npm代理设置：执行npm config get proxy和npm config get https-proxy，如果存在无效代理，执行命令清空：

     npm config delete proxy
     npm config delete https-proxy
     

  3. 若需使用代理，确保代理地址正确，执行：

     npm config set proxy http://你的代理地址:端口
     npm config set https-proxy http://你的代理地址:端口
     

• 切换国内npm镜像源
  国内镜像可规避海外网络访问问题，提升下载速度：

  1. 临时用国内源安装canvas：

     npm install canvas@2.9.3 --registry=https://registry.npmmirror.com
     

  2. 全局设置国内源（后续所有npm操作通用）：

     npm config set registry https://registry.npmmirror.com
     # 同步设置Node.js头文件下载源，解决node-gyp编译的资源获取问题
     npm config set disturl https://npmmirror.com/mirrors/node/
     

• 手动指定预编译二进制文件

  1. 找到canvas@2.9.3对应Node.js 18.10.0、你的系统（如Windows x64）的预编译二进制包
  2. 设置环境变量CANVAS_BINARY_PATH指向该文件的本地路径，再执行npm install

• 修复node-gyp源码编译依赖
  若必须从源码编译，需确保本地环境满足编译条件：

  1. 安装Python 3.x和Windows构建工具（Windows系统），然后全局安装node-gyp：

     npm install -g node-gyp
     

  2. 设置node-gyp的国内镜像源：

     npm config set node_gyp https://npmmirror.com/mirrors/node-gyp/
     

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