本文详解 xlsxwriter 正确写入多个数组行的方法：需调用 writesheetheader() 初始化表头，再通过循环调用 writesheetrow() 逐行追加数据，避免仅写入最后一组数组的常见错误。
本文详解 xlsxwriter 正确写入多个数组行的方法：需调用 writesheetheader() 初始化表头，再通过循环调用 writesheetrow() 逐行追加数据，避免仅写入最后一组数组的常见错误。
在使用 XLSXWriter 库向 Excel 文件写入数据时，一个典型误区是直接将整个二维数组传给 writeSheet() 方法——该方法虽支持批量写入，但要求输入数据结构严格对齐（即每行字段数必须与表头定义完全一致），且不适用于动态长度的行（如示例中 [0, 'color']、[0, 3, 4]、['color', 'size'] 长度不一）。若强行传入不规则数组，库可能静默截断或仅保留最后一次写入，导致仅最后一行生效。
正确做法是分步控制写入过程：先用 writeSheetHeader() 定义工作表结构，再对每一行数据单独调用 writeSheetRow()。这种方式灵活、可控，天然支持变长行（自动以空值补位），并确保所有数据完整落盘。
以下为完整可运行示例：
<?php require_once 'vendor/autoload.php'; // 确保已引入 XLSXWriter
$header = [
'1' => 'string',
'2' => 'string',
'3' => 'string',
'4' => 'string'
];
// 原始不规则数组数据（每行字段数可不同）
$data = [
['0', 'color'], // → 写入第1行：A1="0", B1="color", C1="", D1=""
['0', '3', '4'], // → 写入第2行：A2="0", B2="3", C2="4", D2=""
['color', 'size'] // → 写入第3行：A3="color", B3="size", C3="", D3=""
];
$writer = new XLSXWriter();
$writer->setAuthor('AUTHOR');
// ✅ 关键步骤1：初始化工作表并声明表头结构
$writer->writeSheetHeader('SHEET1', $header);
// ✅ 关键步骤2：遍历每一行，逐行写入（自动对齐列，缺省列填空）
foreach ($data as $row) {
$writer->writeSheetRow('SHEET1', $row);
}
// ✅ 生成文件
$filePath = "/mnt/excel/file.xlsx";
$writer->writeToFile($filePath);
echo "✅ Excel 文件已成功生成：{$filePath}\n";
?>
? 注意事项与最佳实践：
- writeSheetHeader() 中的 $header 键名（如 '1', '2'）对应 Excel 列索引（1-based），值（如 'string'）指定该列数据类型，支持 'string'、'integer'、'date'、'number' 等；
- writeSheetRow() 会自动将输入数组按顺序映射到列 A、B、C…，超出表头定义的列将被忽略，不足则补空（空字符串或 null）；
- 若需严格校验行长度，可在循环中添加 count($row) > count($header) 警告逻辑；
- 避免重复调用 writeSheet() —— 它会覆盖已有工作表内容，仅适合一次性全量写入规则二维数组；
- 大数据量场景下，writeSheetRow() 比 writeSheet() 更省内存，因无需预加载全部数据到内存。
掌握这一模式后，无论是日志聚合、API 响应导出，还是动态报表生成，你都能稳健、高效地将 PHP 数组转化为结构清晰的 Excel 文件。
