Laravel Excel导出出现额外表头行：顶部行显示0,1,2,3,4问题求助

Hey there! Let's break down why those unexpected 0,1,2,3,4 are popping up at the top of your Excel export—this is a super common gotcha with Laravel Excel, so we'll fix it in no time.

最常见的原因：索引数组被自动识别为表头 #

Laravel Excel会把数组的数字索引（比如0、1、2...）自动当作列表头，如果你传递的是纯数字索引数组，而非带命名键的关联数组/集合，就会出现这个问题。

举个例子，如果你的导出类是这样写的：

use Maatwebsite\Excel\Concerns\FromArray;

class UsersExport implements FromArray
{
    public function array(): array
    {
        return [
            ['John Doe', 'john@example.com'],
            ['Jane Smith', 'jane@example.com'],
        ];
    }
}

导出文件的顶部就会显示0和1作为表头，因为数组没有提供可作为标签的命名键。

快速解决方法 #

有两个简单的修复方案：

1. 使用带命名键的关联数组

修改你的数据结构，给数组添加列名作为键，这样Laravel Excel就会用这些键作为表头：

public function array(): array
{
    return [
        ['Name' => 'John Doe', 'Email' => 'john@example.com'],
        ['Name' => 'Jane Smith', 'Email' => 'jane@example.com'],
    ];
}

2. 显式定义headings()方法

如果你想继续使用索引数组，只需在导出类中添加headings()方法，手动指定表头即可：

use Maatwebsite\Excel\Concerns\FromArray;
use Maatwebsite\Excel\Concerns\WithHeadings;

class UsersExport implements FromArray, WithHeadings
{
    public function array(): array
    {
        return [
            ['John Doe', 'john@example.com'],
            ['Jane Smith', 'jane@example.com'],
        ];
    }

    public function headings(): array
    {
        return ['Name', 'Email']; // 这里填写你的自定义表头
    }
}

其他可能的原因 #

• 导出类实现错误：如果你用的是FromCollection，要确保集合里的元素是对象或关联数组，而不是纯索引数组。比如User::all()返回的是User对象集合，会自动用模型属性名作为表头，这没问题；但如果错误地把它转成纯索引数组，就会触发同样的问题。
• 分块数据结构问题：如果你用了WithChunkReading，要检查每一块数据是否保持了正确的关联结构，而非索引数组。

排查小技巧 #

快速定位问题的方法是：在collection()或array()方法里打印返回的数据（比如加dd($data)）。如果看到的是带数字键的数组列表，那就是我们刚才说的问题啦。

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