使用 Laravel Excel 导出数据时，若在 map() 中通过自增变量控制行号，易因方法多次调用导致序号错乱（如从总行数开始）。推荐在构造阶段预置索引，导出时直接引用，确保行号严格从 1 递增。
使用 laravel excel 导出数据时，若在 `map()` 中通过自增变量控制行号，易因方法多次调用导致序号错乱（如从总行数开始）。推荐在构造阶段预置索引，导出时直接引用，确保行号严格从 1 递增。
在 Laravel Excel 中，map() 方法会被每行数据调用一次，看似适合生成序号，但问题在于：$this->row 可能被意外多次递增——例如同时在 model() 和 map() 中调用 ++$this->row，或因框架内部逻辑（如预览、校验、样式应用等）触发额外调用，最终导致序号跳变、重复甚至从总数起步。
更可靠的做法是将行号作为数据的一部分，在构造器中一次性注入原始数组，避免依赖可变状态。以下是优化后的完整实现：
protected $table_data;
public function __construct(array $table_data)
{
// 将 1-based 索引注入每条记录（而非 0-based 的 $index）
$newTableData = [];
foreach ($table_data as $index => $data) {
$newTableData[] = array_merge(['row' => $index + 1], $data);
}
$this->table_data = $newTableData;
}
public function map($table_data): array
{
$department = empty($table_data['department'])
? 'Cast'
: $table_data['department']['name'];
return [
$table_data['row'], // ✅ 直接使用预置的 1-based 行号
$department,
$table_data['name'],
$table_data['name_eng'],
$table_data['phone_number'],
$table_data['email'],
];
}
// 其他方法（headings、styles、startCell 等）保持不变
public function headings(): array
{
return [
['#', 'Department', 'Position/Role', 'Name', 'Phone', 'Email']
];
}
public function startCell(): string
{
return 'A6';
}
✅ 关键优势：
- 确定性：行号在数据准备阶段固化，不受导出流程中方法调用次数影响；
- 无状态：无需维护 $this->row 实例变量，彻底规避竞态与重置风险；
- 可读性强：逻辑分离清晰，map() 仅负责映射，不承担计数职责。
⚠️ 注意事项：
- 若后续需支持分页导出或动态过滤，应在数据组装前完成筛选，再统一注入行号；
- 避免在 model() 方法中操作行号（除非明确用于导入场景），该方法在导出时可能未被调用或行为不可控；
- startCell() 设置为 'A6' 表示标题占 5 行（A1–A5），因此实际数据从第 6 行开始——此时行号 1 对应 Excel 的第 6 行，符合业务预期。
通过这种「数据驱动序号」的方式，你将获得稳定、可预测且易于维护的导出行号逻辑。
