使用npm XLSX包在Angular+TypeScript中实现Excel单元格文本换行

我之前在Angular+TypeScript项目里用xlsx包生成Excel时也遇到过完全一样的需求，根本不用额外引入xlsx-style，原生xlsx就可以搞定！下面是具体的实现步骤和代码示例：

核心思路 #

xlsx包本身支持配置单元格样式，只需要给目标单元格开启alignment.wrapText: true属性，就能实现文本自动换行效果。

具体实现步骤 #

1. 导入xlsx模块 #

先确保你已经安装了xlsx包，然后在组件中导入：

import * as XLSX from 'xlsx';

2. 定义自动换行样式 #

创建一个样式对象，配置自动换行规则，还可以顺便设置垂直对齐方式优化显示：

// 配置自动换行的单元格样式
const wrapTextCellStyle = {
  alignment: {
    wrapText: true,
    vertical: 'top' // 可选，让文本从单元格顶部开始显示
  }
};

3. 构建工作表并给B4单元格设置样式 #

假设你已经有了要导出的数组数据，先转换成工作表，再给目标单元格（B4）单独应用样式：

// 示例导出数据，第四行第二列对应Excel中的B4单元格（数组索引从0开始）
const exportData = [
  ['列1标题', '列2标题'],
  ['行1列1', '行1列2'],
  ['行2列1', '行2列2'],
  ['行3列1', '这是一段需要自动换行的长文本，测试内容测试内容测试内容测试内容测试内容']
];

// 将数组转换为工作表对象
const worksheet = XLSX.utils.aoa_to_sheet(exportData);

// 给B4单元格（地址为'B4'）应用自动换行样式
// 保留原有单元格的值，添加样式属性
worksheet['B4'] = {
  v: worksheet['B4'].v,
  s: wrapTextCellStyle
};

4. 生成工作簿并导出文件 #

最后把工作表添加到工作簿，导出为xlsx文件：

// 创建空白工作簿
const workbook = XLSX.utils.book_new();
// 将工作表添加到工作簿并命名
XLSX.utils.book_append_sheet(workbook, worksheet, '我的工作表');
// 导出为本地文件
XLSX.writeFile(workbook, '带自动换行的表格.xlsx');

注意事项 #

• 自动换行生效需要满足两个条件之一：要么单元格内容包含\n换行符，要么内容长度超过Excel单元格的默认宽度。如果是纯长文本没有换行符，可以手动插入\n分隔，或者后续调整Excel列宽。
• 如果需要给多个单元格批量设置自动换行，可以遍历worksheet对象中的所有单元格，判断地址后统一添加样式。

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