การติดตั้ง

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 repository ได้

ปัญหาเฉพาะแพลตฟอร์ม

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