Laravel中使用Maatwebsite导出CSV如何添加表头并格式化数据

嘿，我看你导出CSV时遇到了「只有原始数据、没有对应表头且数据展示混乱」的问题，我之前用Maatwebsite Excel包时也碰到过类似情况，给你整理了具体的解决办法：

问题分析 #

你当前代码里的$items=array($items)是个小坑——这会把查询得到的集合整个包裹在一个一维数组里，导致fromArray处理时无法正确识别每条记录的结构，自然就没法分开展示，更别说表头了。

修复后的代码 #

直接修改你的导出方法，添加表头并调整数据结构：

public function export() {
    // 查询数据并转成二维数组（集合转数组后，每条记录是一个子数组）
    $items = DB::table('userinformations')
        ->join('users', 'userinformations.user_id', '=', 'users.id')
        ->select('userinformations.fname','userinformations.lname','users.email')
        ->where('userinformations.payment_status',1)
        ->get()
        ->toArray();

    // 定义对应字段的表头，按查询字段顺序排列
    $headers = ['First Name', 'Last Name', 'Email'];

    Excel::create('items', function($excel) use($items, $headers) {
        $excel->sheet('ExportFile', function($sheet) use($items, $headers) {
            // 1. 先设置第一行为表头
            $sheet->row(1, $headers);
            // 2. 从第二行开始插入数据，避免覆盖表头
            $sheet->fromArray($items, null, 'A2', false, false);

            // 可选：给表头添加加粗样式，更易区分
            $sheet->cells('A1:C1', function($cells) {
                $cells->setFontWeight('bold');
            });
        });
    })->export('csv');
}

关键说明 #

• 用->toArray()把Laravel集合转成二维数组，确保每条用户数据都是独立的子数组，这样fromArray能正确解析成每行数据。
• 通过$sheet->row(1, $headers)手动设置第一行作为表头，再从A2单元格开始插入数据，避免表头被覆盖。
• 如果你觉得手动设置表头麻烦，也可以直接用fromArray的第二个参数传入表头（不过手动设置更灵活，方便后续加样式）：

  $sheet->fromArray($items, $headers);
  

效果验证 #

修改后导出的CSV会第一行显示你定义的表头，后续每行对应一条用户的fname、lname和email数据，不会再出现原始数据挤在一起的情况。

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