如何用ExcelJS的addImage方法将图片居中放置在Excel单元格中

AI 小北

2026-6-25

解决ExcelJS添加图片在单元格居中的问题

要让图片在单元格内居中，核心是计算单元格与图片的尺寸差，调整图片左上角（tl）的偏移位置——因为你用了editAs:'absolute'绝对定位，需要手动计算偏移量来让图片居中。

具体步骤和代码修改：

先明确单元格和图片的尺寸参数，计算偏移比例：
- Excel默认列宽1单位≈8.43像素（对应10号Calibri字体，通用场景下适用）
- 通过单元格与图片的宽高差，算出水平/垂直方向需要偏移的比例，加到tl的col和row上（支持小数，代表在列/行内的相对位置）

修改后的代码：

// 定义尺寸参数，方便后续调整
const targetCol = 1; // 目标列的0-based索引（对应你代码里的getColumn(2)）
const targetRowIndex = rowCount - 1; // 目标行的0-based索引
const cellWidth = 14; // 列宽（1-based列的设置值）
const cellHeight = 70; // 行高
const imgWidth = 78;
const imgHeight = 59;

// 计算水平偏移：单元格像素宽度 - 图片宽度，取一半后转成列内比例
const cellPixelWidth = cellWidth * 8.43;
const horizontalOffsetRatio = ((cellPixelWidth - imgWidth) / 2) / cellPixelWidth;

// 计算垂直偏移：单元格高度 - 图片高度，取一半后转成行内比例
const verticalOffsetRatio = ((cellHeight - imgHeight) / 2) / cellHeight;

// 添加图片，调整左上角位置实现居中
worksheet.addImage(child_imgId, {
  tl: {
    col: targetCol + horizontalOffsetRatio,
    row: targetRowIndex + verticalOffsetRatio
  },
  ext: { width: imgWidth, height: imgHeight },
  editAs: 'absolute'
});

// 保持原有的行高列宽设置
worksheet.getRow(rowCount).height = cellHeight;
worksheet.getColumn(2).width = cellWidth;