Установка

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:

Настройка зеркал

# Использование зеркала 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"

# Или использование зеркала 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.