如何在SheetJS中为除表头外的所有单元格设置文本换行

你的代码存在两个核心问题：

1. 最后一行ws['!cols'] = { alignment: { wrapText: '1' } };直接覆盖了之前设置的列宽数组，既丢失了列宽配置，也没有正确设置自动换行规则。
2. 原生SheetJS（xlsx核心库）不支持单元格样式（包括对齐、自动换行这类格式），必须使用支持样式的分支库才能生效。

下面是具体修复方案：

方案1：使用xlsx-style实现自动换行 #

步骤1：替换依赖 #

卸载原生xlsx，安装支持样式的xlsx-style：

npm uninstall xlsx
npm install xlsx-style --save

导入时切换为xlsx-style：

const XLSX = require('xlsx-style');

步骤2：修改代码配置 #

修复列宽与自动换行绑定

保留列宽计算逻辑，同时给每个列添加自动换行样式，删除错误的覆盖代码：

// Column widths + 自动换行样式
ws['!cols'] = Object.keys(formattedData[0] ?? {}).map(header => {
  const headerLength = header.length;
  let wch = headerLength + WIDTH_MARGIN;
  if (wch < MIN_WIDTH) wch = MIN_WIDTH;
  if (wch > MAX_WIDTH) wch = MAX_WIDTH;
  // 绑定自动换行样式到列配置
  return { 
    wch,
    s: { alignment: { wrapText: true } }
  };
});

// 删除这行错误代码：ws['!cols'] = { alignment: { wrapText: '1' } };

给合并表头添加自动换行样式

手动给通过sheet_add_aoa插入的表头单元格设置样式：

headerGroups.forEach(({ name, start }) => {
  XLSX.utils.sheet_add_aoa(ws, [[name]], { origin: start });
  // 获取表头单元格地址并配置样式
  const cellAddr = XLSX.utils.decode_cell(start);
  const cellKey = XLSX.utils.encode_cell(cellAddr);
  ws[cellKey].s = { 
    alignment: { 
      wrapText: true,
      horizontal: 'center',
      vertical: 'center'
    }
  };
});

启用样式写入

在生成文件时添加cellStyles: true选项，确保样式被写入到Excel文件：

return XLSX.write(wb, {
  type: 'buffer',
  bookType: 'xlsx',
  cellStyles: true // 必须添加此选项才能激活样式写入
});

方案2：原生SheetJS手动插入换行符（无需样式库） #

如果不想依赖第三方样式库，可以在格式化数据时给长文本手动插入换行符\n，配合合适的列宽，Excel打开后会自动识别换行：

// 格式化数据时给长文本字段插入换行（根据实际字段调整）
const formattedData = data.map(item => {
  const formatted = rawToHeaders(item);
  // 示例：按每20个字符拆分插入换行
  Object.keys(formatted).forEach(key => {
    if (typeof formatted[key] === 'string' && formatted[key].length > 20) {
      formatted[key] = formatted[key].replace(/(.{20})/g, '$1\n');
    }
  });
  return formatted;
});

这种方法无需样式配置，但需要手动控制换行位置，且需确保Excel单元格未被设置为“不自动换行”。

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