🐕

Node 20アップデート後のnode-canvasインストールエラーを簡単解決！

2023/12/08に公開

はじめに

最近、OS Xを使用している環境でNodeのバージョンアップを行った際に、node-canvasのインストールでエラーが発生しました。このブログでは、その問題の解決方法を共有します。

私のプロジェクトでは、OS X上でNode 14を使用していましたが、最新のNode 20にアップデートすることにしました。しかし、アップデート後にnode-canvasをnpm installしようとしたところ、エラーが発生してしまいました。

OS X環境での問題解決には、以下のコマンドを実行することで解決しました。この手順は、node-canvasの公式GitHubリポジトリに基づいています。

brew install pkg-config cairo pango libpng jpeg giflib librsvg pixman

このコマンドによって、OS X上で必要な依存関係がインストールされ、node-canvasのインストールが無事に完了しました。

自力で解決策を見つけるのは時間がかかることがあります。特に、エラーメッセージを見て一つずつパッケージをインストールするのは地道な作業です。そのため、このような場合は公式ドキュメントを参照するのが最も効率的な方法です。