Next.js项目中用ExcelJs添加行时如何保留Excel模板格式？

用ExcelJS的手动修复方案 #

ExcelJS的spliceRows和addRow默认不会继承模板行的格式，也不会自动调整图片的锚点位置，导致格式混乱、图片丢失。你可以通过以下步骤手动处理：

1. 提前保存列宽配置
   先把模板的列宽存下来，避免插入行后列宽被篡改：

   const originalColumnWidths = worksheet.columns.map(col => col.width);
   

2. 插入行并复制模板格式
   假设模板行是第3行，要在其下方插入新行：

   const templateRow = worksheet.getRow(3);
   const insertIndex = 4;
   // 插入空白行
   worksheet.spliceRows(insertIndex, 0, []);
   const newRow = worksheet.getRow(insertIndex);
   
   // 复制整行基础样式
   newRow.style = {...templateRow.style};
   newRow.height = templateRow.height;
   
   // 逐个单元格复制详细格式（数字格式、边框、对齐方式等）
   for (let col = 1; col <= worksheet.columnCount; col++) {
     const templateCell = templateRow.getCell(col);
     const newCell = newRow.getCell(col);
     newCell.style = {...templateCell.style};
     newCell.numFmt = templateCell.numFmt;
     newCell.alignment = {...templateCell.alignment};
     newCell.border = {...templateCell.border};
     newCell.fill = {...templateCell.fill};
   }
   

3. 恢复列宽
   插入行后把列宽还原：

   worksheet.columns.forEach((col, idx) => {
     col.width = originalColumnWidths[idx];
   });
   

4. 调整图片位置
   Excel中的图片绑定单元格位置，插入行后需要手动下移下方的图片：

   const insertedRowCount = 1;
   const images = worksheet.getImages();
   images.forEach(img => {
     if (img.start.row >= insertIndex) {
       img.start.row += insertedRowCount;
       img.end.row += insertedRowCount;
     }
   });
   

更省心的替代库：xlsx-populate #

如果不想手动处理格式和图片，推荐使用xlsx-populate——这个库专门针对Excel模板填充场景，插入行时会自动继承上方行的格式，图片位置也会自动调整，完全不需要手动处理格式问题。

示例代码（Next.js服务端）：

const XlsxPopulate = require('xlsx-populate');

// 加载模板文件
XlsxPopulate.fromFileAsync('./template.xlsx').then(workbook => {
  const worksheet = workbook.sheet('Sheet1');
  // 在第3行下方插入1行，自动继承模板格式
  worksheet.row(3).insertBelow(1);
  // 给新行填充数据
  worksheet.cell('A4').value('新数据内容');
  // 保存结果文件
  return workbook.toFileAsync('./output.xlsx');
});

无库实现的可行性 #

不推荐无库实现，因为Excel文件本质是压缩的XML结构，格式、图片的存储逻辑非常复杂，手动解析和修改需要处理大量细节，耗时且容易出错。

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