Instalación

Sharp es una biblioteca de procesamiento de imágenes de alto rendimiento para Node.js que soporta múltiples formatos de imagen y operaciones.

Requisitos del Sistema

• Node.js: Versión 18.0.0 o superior
• Plataforma: Windows, macOS, Linux
• Arquitectura: x64, ARM64

Métodos de Instalación

Usar npm

npm install sharp

Usar pnpm

pnpm add sharp

Usar yarn

yarn add sharp

Binarios Precompilados

Sharp descargará automáticamente binarios precompilados adecuados para su plataforma. Si la descarga de instalación falla, puede elegir cambiar el sitio de imagen que contiene los binarios de sharp y libvips:

Configurar Fuente de Imagen

# Usar imagen de 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"

# O usar imagen de GitHub
npm config set sharp_binary_host "https://github.com/lovell/sharp/releases/download"

Instalación Manual

Si la instalación automática falla, puede instalar manualmente:

# Limpiar caché
npm cache clean --force

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

Verificar Instalación

Crea un archivo de prueba para verificar la instalación:

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

console.log('Versión de Sharp:', sharp.versions.sharp);
console.log('Versión de libvips:', sharp.versions.vips);

// Probar función básica
sharp('test.jpg')
  .resize(100, 100)
  .toBuffer()
  .then(() => {
    console.log('¡Instalación de Sharp exitosa!');
  })
  .catch((err) => {
    console.error('Instalación de Sharp fallida:', err);
  });

Problemas Comunes

Fallo de Instalación

Si encuentra problemas de instalación, intente:

1. Actualizar Node.js: Asegúrese de usar la última versión
2. Limpiar caché: npm cache clean --force
3. Eliminar node_modules: Eliminar y reinstalar
4. Verificar red: Asegúrese de poder acceder al repositorio npm

Problemas Específicos de Plataforma

Windows

• Asegúrese de tener instalado Visual Studio Build Tools
• Si usa WSL, asegúrese de instalar en el entorno Linux

macOS

• Asegúrese de tener instalado Xcode Command Line Tools
• Si usa chip M1/M2, asegúrese de usar la versión ARM64

Linux

• Instalar herramientas de desarrollo necesarias: sudo apt-get install build-essential
• Para Alpine Linux: apk add --no-cache vips-dev

Entorno de Desarrollo

Soporte TypeScript

Sharp incluye definiciones completas de TypeScript:

npm install --save-dev @types/node

Herramientas de Desarrollo

Se recomienda usar las siguientes herramientas para desarrollo:

• VS Code: Excelente soporte para TypeScript
• ESLint: Verificación de calidad de código
• Prettier: Formateo de código

Próximos Pasos

Después de la instalación, consulta la Guía de Inicio Rápido para aprender cómo usar Sharp.