使用ExcelJS.WorkbookWriter插入图片报错：sheet.addImage不是函数

问题原因 #

ExcelJS.stream.xlsx.WorkbookWriter 创建的工作表（StreamWorksheet）不支持 addImage 方法——这是流式API的设计限制：它专为大数据量逐行写入场景优化，省略了图片这类需要全局文档定位的非行内元素的处理能力；而常规 ExcelJS.Workbook 是在内存中构建完整工作簿结构，因此支持所有完整API（包括图片插入）。

解决方案 #

方案1：用常规Workbook + 流式输出（推荐） #

如果你的需求是最终输出流式文件，但数据量没有大到必须逐行写入内存，可以先用常规 Workbook 完成所有操作（包括插入图片），再通过 writeStream 方法流式输出：

const ExcelJS = require('exceljs');
const axios = require('axios');
const fs = require('fs');

const inchesToPixels = 96; // 1英寸=96像素，可按需调整

async function generateExcel() {
  // 使用常规Workbook实例
  const workbook = new ExcelJS.Workbook();
  const sheet = workbook.addWorksheet('Sheet1');

  // 下载并处理图片
  const barCodeLink = 'https://imagizer.imageshack.com/img922/7971/R0aEUe.jpg';
  const barCodeResponse = await axios.get(barCodeLink, { responseType: 'arraybuffer' });
  const base64BarCodeImage = Buffer.from(barCodeResponse.data, 'binary').toString('base64');
  
  const barCodeId = workbook.addImage({
    base64: base64BarCodeImage,
    extension: 'jpg'
  });

  // 设置图片尺寸和位置
  const barCodeDimensions = {
    width: 1.51 * inchesToPixels,
    height: 0.32 * inchesToPixels
  };
  const topRightCell = sheet.getCell('Q4');
  topRightCell.alignment = { horizontal: 'right', vertical: 'top' };

  sheet.addImage(barCodeId, {
    tl: { col: topRightCell.col, row: topRightCell.row },
    ext: { width: barCodeDimensions.width, height: barCodeDimensions.height }
  });

  // 流式写入到文件
  const outputStream = fs.createWriteStream('output.xlsx');
  const stream = workbook.xlsx.writeStream();
  
  stream.pipe(outputStream);
  
  await new Promise((resolve, reject) => {
    stream.on('finish', resolve);
    stream.on('error', reject);
  });
}

generateExcel().catch(console.error);

方案2：大数据量场景下的替代方案 #

如果数据量极大，必须用 WorkbookWriter 逐行写入，可以：

• 先通过 WorkbookWriter 完成数据写入，保存为临时文件
• 再使用其他支持修改现有Excel并插入图片的库（如 xlsx-populate），打开临时文件添加图片
• 最后生成最终文件

这种方式会增加复杂度，但能兼顾大数据流式写入和图片插入需求。

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