Installation

Sharp ist eine hochperformante Bildverarbeitungsbibliothek für Node.js, die verschiedene Bildformate und Operationen unterstützt.

Systemanforderungen

• Node.js: Version 18.0.0 oder höher
• Plattform: Windows, macOS, Linux
• Architektur: x64, ARM64

Installationsmethoden

Mit npm

npm install sharp

Mit pnpm

pnpm add sharp

Mit yarn

yarn add sharp

Vorkompilierte Binärdateien

Sharp lädt automatisch vorkompilierte Binärdateien für Ihre Plattform herunter. Wenn der Download fehlschlägt, können Sie den Spiegelserver ändern, der die Sharp- und libvips-Binärdateien enthält:

Spiegelserver einrichten

# Taobao-Spiegel verwenden

#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"

# Oder GitHub-Spiegel verwenden
npm config set sharp_binary_host "https://github.com/lovell/sharp/releases/download"

Manuelle Installation

Wenn die automatische Installation fehlschlägt, können Sie manuell installieren:

# Cache löschen
npm cache clean --force

# Neu installieren
npm install sharp --ignore-scripts=false

Installation überprüfen

Erstellen Sie eine Testdatei, um die Installation zu überprüfen:

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

console.log('Sharp-Version:', sharp.versions.sharp);
console.log('libvips-Version:', sharp.versions.vips);

// Grundfunktionen testen
sharp('test.jpg')
  .resize(100, 100)
  .toBuffer()
  .then(() => {
    console.log('Sharp erfolgreich installiert!');
  })
  .catch((err) => {
    console.error('Sharp-Installation fehlgeschlagen:', err);
  });

Häufige Probleme

Installationsfehler

Wenn Sie Installationsprobleme haben, versuchen Sie:

1. Node.js aktualisieren: Stellen Sie sicher, dass Sie die neueste Version verwenden
2. Cache löschen: npm cache clean --force
3. node_modules löschen: Löschen und neu installieren
4. Netzwerk prüfen: Stellen Sie sicher, dass Sie auf das npm-Repository zugreifen können

Plattformspezifische Probleme

Windows

• Stellen Sie sicher, dass Visual Studio Build Tools installiert ist
• Wenn Sie WSL verwenden, stellen Sie sicher, dass Sie in der Linux-Umgebung installieren

macOS

• Stellen Sie sicher, dass Xcode Command Line Tools installiert ist
• Wenn Sie M1/M2-Chips verwenden, stellen Sie sicher, dass Sie die ARM64-Version verwenden

Linux

• Installieren Sie die erforderlichen Entwicklungstools: sudo apt-get install build-essential
• Für Alpine Linux: apk add --no-cache vips-dev

Entwicklungsumgebung

TypeScript-Unterstützung

Sharp enthält vollständige TypeScript-Definitionen:

npm install --save-dev @types/node

Entwicklungstools

Die folgenden Tools werden für die Entwicklung empfohlen:

• VS Code: Ausgezeichnete TypeScript-Unterstützung
• ESLint: Codequalitätsprüfung
• Prettier: Codeformatierung

Nächste Schritte

Nach der Installation schauen Sie sich den Schnellstart-Leitfaden an, um zu erfahren, wie Sie Sharp verwenden können.