Instalação

Sharp é uma biblioteca de processamento de imagem de alto desempenho para Node.js, suportando vários formatos de imagem e operações.

Requisitos do Sistema

• Node.js: Versão 18.0.0 ou superior
• Plataforma: Windows, macOS, Linux
• Arquitetura: x64, ARM64

Métodos de Instalação

Usando npm

npm install sharp

Usando pnpm

pnpm add sharp

Usando yarn

yarn add sharp

Binários Pré-compilados

Sharp baixará automaticamente binários pré-compilados adequados para sua plataforma. Se a instalação falhar ao baixar, você pode escolher alterar o site de espelho que contém os binários sharp e libvips:

Configurar Fonte de Espelho

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

# Ou usar espelho GitHub
npm config set sharp_binary_host "https://github.com/lovell/sharp/releases/download"

Instalação Manual

Se a instalação automática falhar, você pode instalar manualmente:

# Limpar cache
npm cache clean --force

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

Verificar Instalação

Crie um arquivo de teste para verificar a instalação:

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

console.log('Versão Sharp:', sharp.versions.sharp);
console.log('Versão libvips:', sharp.versions.vips);

// Testar função básica
sharp('test.jpg')
  .resize(100, 100)
  .toBuffer()
  .then(() => {
    console.log('Sharp instalado com sucesso!');
  })
  .catch((err) => {
    console.error('Instalação Sharp falhou:', err);
  });

Problemas Comuns

Falha na Instalação

Se encontrar problemas de instalação, tente:

1. Atualizar Node.js: Certifique-se de usar a versão mais recente
2. Limpar cache: npm cache clean --force
3. Excluir node_modules: Excluir e reinstalar
4. Verificar rede: Certifique-se de poder acessar o repositório npm

Problemas Específicos da Plataforma

Windows

• Certifique-se de ter instalado Visual Studio Build Tools
• Se usar WSL, certifique-se de instalar no ambiente Linux

macOS

• Certifique-se de ter instalado Xcode Command Line Tools
• Se usar chip M1/M2, certifique-se de usar versão ARM64

Linux

• Instalar ferramentas de desenvolvimento necessárias: sudo apt-get install build-essential
• Para Alpine Linux: apk add --no-cache vips-dev

Ambiente de Desenvolvimento

Suporte TypeScript

Sharp inclui definições TypeScript completas:

npm install --save-dev @types/node

Ferramentas de Desenvolvimento

Recomenda-se usar as seguintes ferramentas para desenvolvimento:

• VS Code: Excelente suporte TypeScript
• ESLint: Verificação de qualidade de código
• Prettier: Formatação de código

Próximos Passos

Após a instalação, consulte o Guia de Início Rápido para aprender como usar Sharp.