インストール

Sharp は高性能な Node.js 画像処理ライブラリで、多くの画像形式と操作をサポートします。

システム要件

• Node.js: バージョン 18.0.0 以上
• プラットフォーム: Windows, macOS, Linux
• アーキテクチャ: x64, ARM64

インストール方法

npm を使用

npm install sharp

pnpm を使用

pnpm add sharp

yarn を使用

yarn add sharp

プリビルドバイナリ

Sharp は自動的にプラットフォームに適したプリビルドバイナリをダウンロードします。インストールのダウンロードが失敗した場合、sharp と libvips バイナリを含むミラーサイトを変更できます：

ミラー設定

# 淘宝ミラーを使用

#pnpm
pnpm config set sharp_binary_host "https://npmmirror.com/mirrors/sharp"
pnpm config set sharp_libvips_binary_host "https://npmmirror.com/mirrors/sharp-libvips"

#npm
npm config set sharp_binary_host "https://npmmirror.com/mirrors/sharp"
npm config set sharp_libvips_binary_host "https://npmmirror.com/mirrors/sharp-libvips"

# または GitHub ミラーを使用
npm config set sharp_binary_host "https://github.com/lovell/sharp/releases/download"

手動インストール

自動インストールが失敗した場合、手動でインストールできます：

# キャッシュをクリア
npm cache clean --force

# 再インストール
npm install sharp --ignore-scripts=false

インストールの検証

インストールを検証するテストファイルを作成：

// test-sharp.js
import sharp from 'sharp';

console.log('Sharp バージョン:', sharp.versions.sharp);
console.log('libvips バージョン:', sharp.versions.vips);

// 基本機能をテスト
sharp('test.jpg')
  .resize(100, 100)
  .toBuffer()
  .then(() => {
    console.log('Sharp インストール成功！');
  })
  .catch((err) => {
    console.error('Sharp インストール失敗:', err);
  });

よくある問題

インストール失敗

インストールの問題が発生した場合、以下を試してください：

1. Node.js を更新: 最新バージョンを使用していることを確認
2. キャッシュをクリア: npm cache clean --force
3. node_modules を削除: 削除して再インストール
4. ネットワークを確認: npm リポジトリにアクセスできることを確認

プラットフォーム固有の問題

Windows

• Visual Studio Build Tools がインストールされていることを確認
• WSL を使用する場合、Linux 環境でインストールすることを確認

macOS

• Xcode Command Line Tools がインストールされていることを確認
• M1/M2 チップを使用する場合、ARM64 バージョンを使用することを確認

Linux

• 必要な開発ツールをインストール：sudo apt-get install build-essential
• Alpine Linux の場合：apk add --no-cache vips-dev

開発環境

TypeScript サポート

Sharp には完全な TypeScript 定義が含まれています：

npm install --save-dev @types/node

開発ツール

開発には以下のツールを推奨します：

• VS Code: 優れた TypeScript サポート
• ESLint: コード品質チェック
• Prettier: コードフォーマット

次のステップ

インストールが完了したら、クイックスタートガイド を確認して Sharp の使い方を学んでください。