如何使用ExcelJS自动调整行高以适配单元格内容？

核心认知前提 #

很多人开发时会找有没有autoHeight的一键配置项，实际上ExcelJS根本没有提供这个专属属性，行高自动适配的实现完全依托XLSX本身的格式规范，搭配合理的兜底逻辑才能保证不同查看端的显示效果一致。

基础实现逻辑（依托桌面端Excel自动计算） #

这种方式的核心是给Excel传递“当前行没有被设置固定行高，需要打开文件时自动适配内容”的标记：

• 对目标行对象，不要赋值固定的像素行高

• 将行的 customHeight 属性设置为 false，这个标记是XLSX格式中区分“固定行高”和“自动适配行高”的核心字段，一旦设为true，Excel打开时会直接跳过自动行高的计算流程

  示例代码：

  // 遍历工作表中所有需要自动适配行高的行，比如从第2行开始的内容行
  worksheet.eachRow((row, rowNumber) => {
    if (rowNumber >= 2) {
      row.height = undefined; // 清除所有固定行高值
      row.customHeight = false; // 标记为非自定义固定行高，触发Excel自动计算逻辑
      // 注意：要配合单元格的自动换行样式才能实现长文本适配
      row.eachCell((cell) => {
        cell.alignment = {
          wrapText: true, // 开启单元格内容自动换行
          vertical: 'top' // 垂直靠上对齐，让自动撑高的显示效果更符合使用习惯
        }
      })
    }
  })
  

常见不生效原因与兜底方案 #

很多人按照上面的代码配置后，会发现在网页端Excel预览、旧版WPS/Office环境下，行高没有自动适配，内容被截断——这是因为这类查看端不会主动触发“打开时自动计算行高”的逻辑，只会读取文件中已经写入的行高值。
这种场景下需要加一层客户端侧的行高计算兜底：

• 提前根据单元格内容、列宽、字体大小计算实际需要的行高值

• 将计算得到的行高值赋值给 row.height，同时保持 customHeight = true，让不同查看端都能直接读取到适配后的行高

  行高计算的简化参考逻辑：

  • 单段文字的总宽度 = 文字长度 × 字体单字符宽度（比如11号微软雅黑单字符宽度约1.2px）
  • 单元格可容纳的单行文字宽度 = 列宽 × 列宽换算系数（Excel列宽1单位约等于8.43px）
  • 需要的换行行数 = 向上取整（文字总宽度 / 单元格可容纳的单行文字宽度）
  • 最终行高 = 单行行高 × 换行行数 + 上下边距值

避坑要点 #

• 不要开启单元格自动换行后，再手动给行设置固定行高，固定值会直接覆盖自动适配的逻辑
• 跨列合并的单元格做行高计算时，要按合并后的总宽度计算可容纳的文字长度，不要按单个子单元格的列宽计算，否则会出现行高不足、内容截断的问题
• 如果导出的文件主要在老旧版本的Office中打开，建议优先用兜底计算的方式写入实际行高，不要完全依赖打开端的自动计算，避免出现兼容性问题

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