Cài đặt

Sharp là thư viện xử lý hình ảnh Node.js hiệu suất cao, hỗ trợ nhiều định dạng và thao tác hình ảnh.

Yêu cầu hệ thống

• Node.js: Phiên bản 18.0.0 trở lên
• Nền tảng: Windows, macOS, Linux
• Kiến trúc: x64, ARM64

Phương pháp cài đặt

Sử dụng npm

npm install sharp

Sử dụng pnpm

pnpm add sharp

Sử dụng yarn

yarn add sharp

Tệp nhị phân được biên dịch sẵn

Sharp sẽ tự động tải xuống tệp nhị phân được biên dịch sẵn phù hợp với nền tảng của bạn. Nếu việc tải xuống cài đặt thất bại, bạn có thể chọn thay đổi trang web gương chứa tệp nhị phân sharp và libvips:

Thiết lập nguồn gương

# Sử dụng gương 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"

# Hoặc sử dụng gương GitHub
npm config set sharp_binary_host "https://github.com/lovell/sharp/releases/download"

Cài đặt thủ công

Nếu cài đặt tự động thất bại, bạn có thể cài đặt thủ công:

# Xóa bộ nhớ đệm
npm cache clean --force

# Cài đặt lại
npm install sharp --ignore-scripts=false

Xác minh cài đặt

Tạo một tệp kiểm tra để xác minh cài đặt:

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

console.log('Phiên bản Sharp:', sharp.versions.sharp);
console.log('Phiên bản libvips:', sharp.versions.vips);

// Kiểm tra chức năng cơ bản
sharp('test.jpg')
  .resize(100, 100)
  .toBuffer()
  .then(() => {
    console.log('Cài đặt Sharp thành công!');
  })
  .catch((err) => {
    console.error('Cài đặt Sharp thất bại:', err);
  });

Vấn đề thường gặp

Cài đặt thất bại

Nếu gặp vấn đề cài đặt, hãy thử:

1. Cập nhật Node.js: Đảm bảo sử dụng phiên bản mới nhất
2. Xóa bộ nhớ đệm: npm cache clean --force
3. Xóa node_modules: Xóa và cài đặt lại
4. Kiểm tra mạng: Đảm bảo có thể truy cập kho npm

Vấn đề cụ thể theo nền tảng

Windows

• Đảm bảo đã cài đặt Visual Studio Build Tools
• Nếu sử dụng WSL, đảm bảo cài đặt trong môi trường Linux

macOS

• Đảm bảo đã cài đặt Xcode Command Line Tools
• Nếu sử dụng chip M1/M2, đảm bảo sử dụng phiên bản ARM64

Linux

• Cài đặt các công cụ phát triển cần thiết: sudo apt-get install build-essential
• Đối với Alpine Linux: apk add --no-cache vips-dev

Môi trường phát triển

Hỗ trợ TypeScript

Sharp bao gồm định nghĩa TypeScript đầy đủ:

npm install --save-dev @types/node

Công cụ phát triển

Khuyến nghị sử dụng các công cụ sau để phát triển:

• VS Code: Hỗ trợ TypeScript tuyệt vời
• ESLint: Kiểm tra chất lượng mã
• Prettier: Định dạng mã

Bước tiếp theo

Sau khi cài đặt xong, xem Hướng dẫn bắt đầu nhanh để tìm hiểu cách sử dụng Sharp.