如何使用Node.js将HEIC转换为PNG/JPG？

以下是几个无需依赖ImageMagick的可行方案，针对你试过的工具包失败场景逐一排查解决：

1. 修复heic-convert的系统依赖问题 #

heic-convert本身依赖系统级的libheif库，你之前失败大概率是因为系统缺少这个依赖导致包安装或运行异常。

• 先安装系统依赖：
  • Ubuntu/Debian：sudo apt-get install libheif-dev
  • macOS（用Homebrew）：brew install libheif
  • Windows（用Chocolatey）：choco install libheif
• 重新安装heic-convert：

  npm uninstall heic-convert && npm install heic-convert
  

• NestJS中使用示例（处理上传的HEIC文件Buffer）：

  import * as heicConvert from 'heic-convert';
  import { Injectable } from '@nestjs/common';
  
  @Injectable()
  export class ImageConversionService {
    async convertHeicToPng(heicBuffer: Buffer): Promise<Buffer> {
      const pngBuffer = await heicConvert({
        buffer: heicBuffer,
        format: 'PNG', // 可选 'JPEG'
      });
      return pngBuffer;
    }
  }
  

2. 使用纯JS实现的libheif-js #

如果你的环境无法安装系统级依赖，libheif-js是纯JavaScript编译的HEIC处理库，无需额外系统依赖。

• 安装包：

  npm install libheif-js
  

• NestJS中使用示例：

  import { decode } from 'libheif-js';
  import { Injectable } from '@nestjs/common';
  import { createCanvas, Image } from 'canvas'; // 需要额外安装canvas包
  
  @Injectable()
  export class ImageConversionService {
    async convertHeicToJpg(heicBuffer: Buffer): Promise<Buffer> {
      const heifImage = decode(heicBuffer);
      const image = new Image();
      image.src = heifImage.displayImage.toDataURL();
      
      const canvas = createCanvas(image.width, image.height);
      const ctx = canvas.getContext('2d');
      ctx.drawImage(image, 0, 0);
      
      return canvas.toBuffer('image/jpeg', { quality: 0.9 });
    }
  }
  

  注意：需要额外安装canvas包来完成像素绘制和格式转换，安装命令：npm install canvas

3. 重新编译sharp以支持HEIC #

sharp支持HEIC，但默认编译时可能未包含libheif支持，需要重新编译并确保系统依赖存在。

• 安装系统依赖（同方案1的系统依赖安装）
• 重新安装sharp：

  npm uninstall sharp && npm install sharp --build-from-source
  

• NestJS中使用示例：

  import * as sharp from 'sharp';
  import { Injectable } from '@nestjs/common';
  
  @Injectable()
  export class ImageConversionService {
    async convertHeicToPng(heicBuffer: Buffer): Promise<Buffer> {
      return sharp(heicBuffer)
        .png()
        .toBuffer();
    }
  }
  

内容的提问来源于stack exchange，提问作者Hamzeh