记录在【Windows】下安装【node-canvas】遇到的各种问题(无法安装canvas,安装canvas包报错error...)
好久没更新博客了,因为工作越来越忙,没什么时间去记录一些问题,最近闲下来一点,由于某些原因不得不暂时在Windows下做开发,项目用到了node-canvas处理图片什么的,在安装的时候各种报错,确实让人很抓狂,这里简单记录下:
首先说明下,node-canvas的
官方git仓库 https://github.com/Automattic/node-canvas,
在没有安装前置依赖之前,直接npm install canvas是一定装不上的,其实网上有很多关于win安装canvas的文章,报错的时候搜了很多,不过最官方的方法在这:
Installation: Windows · Automattic/node-canvas Wiki (github.com)
官方给出了两种安装依赖的方法,一种是一个一个纯手动安装(不建议,比较麻烦),一种是下载Chocolatey然后一键安装,我的建议是使用Chocolatey 更方便一些
下面给出使用Chocolatey方法安装node-canvas的步骤
一、安装Chocolatey
1)打开终端管理员powershell,运行
Get-ExecutionPolicy
如果显示 Restricted ,那么要执行
Set-ExecutionPolicy AllSigned
2)复制如下命令到shell,回车执行
Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))
等待一会儿,如果没有报错error的信息,执行下 choco,出现版本信息,那么就应该安装成功了
二、安装canvas前置依赖
在shell中执行
choco install -y python2 gtk-runtime microsoft-build-tools libjpeg-turbo
这个过程看网络情况,我这边是会等几分钟
一般情况应该只有一个包 libjpeg-turbo 显示安装错误,其他都是安装成功的,不过没关系,打开C盘看下如果 C:\libjpeg-turbo64 文件夹下是这样的,那么就代表成功了(博主在win10、win11装过都是这样滴)
三、下载GTK-2
首先下载安装包,下载完成后,解压到 C:\GTK
四、安装canvas
1)在项目根目录下创建 .npmrc 文件(如果已存在就把代码加在下面即可),内容如下
canvas_binary_host_mirror=https://registry.npmmirror.com/-/binary/canvas
这一步非常的重要,就是给npm安装canvas时换个镜像,博主就是在这步卡了很久,最后发现是默认GitHub的源太慢了,导致总是安装失败,法克鱿!
2)ok到这一步终于可以安装canvas了!
npm install canvas
没什么问题的话就可以很快安装成功了,good
ps:在换源之前我这边是这么报错的,有时候还不一样
> npm install canvas > canvas@2.11.2 install C:\Users\LijiaHou\Desktop\ReactAndVue\koaDemo\node_modules\canvas > node-pre-gyp install --fallback-to-build --update-binary node-pre-gyp ERR! install request to https://github.com/Automattic/node-canvas/releases/download/v2.11.2/canvas-v2.11.2-node-v83-win32-unknown-x64.tar.gz failed, reason: connect ETIMEDOUT 20.205.243.166:443 node-pre-gyp WARN Pre-built binaries not installable for canvas@2.11.2 and node@14.19.1 (node-v83 ABI, unknown) (falling back to source compile with node-gyp) node-pre-gyp WARN Hit error request to https://github.com/Automattic/node-canvas/releases/download/v2.11.2/canvas-v2.11.2-node-v83-win32-unknown-x64.tar.gz failed, reason: connect ETIMEDOUT 20.205.243.166:443 gyp ERR! find VS gyp ERR! find VS msvs_version was set from command line or npm config
应该没有遗漏什么步骤吧,最后希望能帮到朋友们√