Installazione

Sharp è una libreria ad alte prestazioni per l'elaborazione di immagini per Node.js, che supporta vari formati e operazioni su immagini.

Requisiti sistema

• Node.js: Versione 18.0.0 o superiore
• Piattaforma: Windows, macOS, Linux
• Architettura: x64, ARM64

Metodi installazione

Usare npm

npm install sharp

Usare pnpm

pnpm add sharp

Usare yarn

yarn add sharp

File binari precompilati

Sharp scarica automaticamente i file binari precompilati adatti alla tua piattaforma. Se il download dell'installazione fallisce, puoi scegliere di cambiare il sito mirror che contiene i file binari di sharp e libvips:

Configurare mirror

# Usare mirror Taobao

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

# Oppure usare mirror GitHub
npm config set sharp_binary_host "https://github.com/lovell/sharp/releases/download"

Installazione manuale

Se l'installazione automatica fallisce, puoi installare manualmente:

# Pulire cache
npm cache clean --force

# Reinstallare
npm install sharp --ignore-scripts=false

Verifica installazione

Crea un file di test per verificare l'installazione:

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

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

// Test funzionalità base
sharp('test.jpg')
  .resize(100, 100)
  .toBuffer()
  .then(() => {
    console.log('Sharp installato con successo!');
  })
  .catch((err) => {
    console.error('Installazione Sharp fallita:', err);
  });

Problemi comuni

Installazione fallita

Se riscontri problemi di installazione, prova:

1. Aggiornare Node.js: Assicurati di usare l'ultima versione
2. Pulire cache: npm cache clean --force
3. Eliminare node_modules: Elimina e reinstalla
4. Verificare rete: Assicurati di poter accedere al repository npm

Problemi specifici piattaforma

Windows

• Assicurati di aver installato Visual Studio Build Tools
• Se usi WSL, assicurati di installare nell'ambiente Linux

macOS

• Assicurati di aver installato Xcode Command Line Tools
• Se usi chip M1/M2, assicurati di usare la versione ARM64

Linux

• Installa strumenti di sviluppo necessari: sudo apt-get install build-essential
• Per Alpine Linux: apk add --no-cache vips-dev

Ambiente sviluppo

Supporto TypeScript

Sharp include definizioni TypeScript complete:

npm install --save-dev @types/node

Strumenti sviluppo

Si consiglia di usare i seguenti strumenti per lo sviluppo:

• VS Code: Eccellente supporto TypeScript
• ESLint: Controllo qualità codice
• Prettier: Formattazione codice

Prossimi passi

Dopo l'installazione, consulta la Guida Rapida per imparare come usare Sharp.