ExcelJS：调整列宽后图片错位，如何实现精准图片定位？

我用ExcelJS结合TypeScript生成Excel文件，在指定位置插入图片时遇到了问题：预先调整列宽后，根据列宽动态计算的图片位置总是和预期有偏移——哪怕在addImage里设置了精确的tl（左上角）坐标，图片还是不对齐，看起来addImage计算位置时用的是调整前的旧列宽值。

相关代码 #

// 动态设置列宽
sheet.getColumn(1).width = 20;
sheet.getColumn(2).width = 30;

// 添加图片
const imageId = workbook.addImage({
  base64: this._rawImage,
  extension: 'png',
});

const topLeft = { col: offsetCol, row: 0 }; // offsetCol是根据列宽计算的，比如1.8、2.764这类小数
sheet.addImage(imageId, {
  tl: topLeft,
  ext: { width: this._dimensionImage[0] / 3, height: this._dimensionImage[1] / 3 },
});

已尝试的方案 #

• 验证过offsetCol是基于调整后的列宽正确计算的；
• 添加延迟等待列宽调整完成后再调用addImage，问题依旧。

（图片预期：左上角应位于B1单元格的中间位置）

解决方法 #

1. 用单元格锚点+偏移替代动态列坐标计算 #

直接把图片锚定到目标单元格，再通过像素偏移实现居中，比计算col的小数更可靠：

sheet.getColumn(1).width = 20;
sheet.getColumn(2).width = 30;

// 先获取目标列的实际像素宽度
const targetColWidth = sheet.getColumn(2).actualWidth;
const imageWidth = this._dimensionImage[0] / 3;

const imageId = workbook.addImage({
  base64: this._rawImage,
  extension: 'png',
});

// 锚定到B1单元格（col=1，row=0），再设置水平偏移实现居中
sheet.addImage(imageId, {
  tl: { col: 1, row: 0 },
  ext: { width: imageWidth, height: this._dimensionImage[1] / 3 },
  editAs: 'absolute',
  offset: {
    x: (targetColWidth - imageWidth) / 2, // 水平居中偏移
    y: 0
  }
});

2. 强制触发列宽布局更新 #

如果坚持用动态col坐标计算，设置列宽后先访问actualWidth属性，强制ExcelJS更新内部布局缓存，再计算offsetCol：

sheet.getColumn(1).width = 20;
sheet.getColumn(2).width = 30;

// 触发布局更新，确保获取到最新的列宽值
const col1Actual = sheet.getColumn(1).actualWidth;
const col2Actual = sheet.getColumn(2).actualWidth;

// 基于更新后的实际宽度计算offsetCol（示例：B1单元格中间）
const offsetCol = 1 + (col2Actual / 2) / col2Actual; 

3. 升级ExcelJS版本 #

旧版本的ExcelJS存在列宽更新后布局缓存未同步的bug，尝试升级到最新稳定版：

npm install exceljs@latest

内容的提问来源于stack exchange，提问作者Antoine Le Bescond