yii2 gridview 不支持 excel 导出，需用 phpspreadsheet 实现独立导出 action；须绕过分页查全量数据、手动格式化字段、设置正确响应头，避免乱码与内存溢出。
Yii2 的 GridView 本身不支持 Excel 导出，必须自己加逻辑；PHPExcel 已废弃，现在该用 PhpSpreadsheet —— 强行用 PHPExcel 会遇到 Composer 冲突、PHP 8+ 不兼容、导出乱码等问题。
为什么不能直接在 GridView 里加 export 按钮就完事
GridView 只负责渲染 HTML 表格，export 功能不在它的职责范围内。你看到的“导出按钮”只是个链接或表单提交，背后得有独立 action 处理数据查询、格式组装和响应输出。
- GridView 的
dataProvider是为分页渲染准备的，导出通常要全量数据，得绕过分页重新查一次 - 导出字段顺序、别名、格式化（如日期转字符串、布尔转“是/否”）和 HTML 渲染逻辑不一致，不能直接复用
columns配置 - 响应头、文件名、MIME 类型都得手动设，漏掉
Content-Disposition就会直接在浏览器里打开乱码内容
用 PhpSpreadsheet 替代 PHPExcel 的关键改动
PHPExcel 在 2019 年已归档，新项目必须用 phpoffice/phpspreadsheet。两者 API 相似但不兼容，硬切容易报 Class 'PHPExcel_IOFactory' not found 这类错误。
- 安装命令是
composer require phpoffice/phpspreadsheet，不是phpexcel - 命名空间从
PHPExcel_*全部变成PhpOffice\PhpSpreadsheet\*，比如PhpOffice\PhpSpreadsheet\IOFactory -
getActiveSheet()返回的是Worksheet对象，写单元格用setCellValue('A1', 'xxx')没变，但设置样式要用getStyle('A1')->getFont()->setBold(true)这种链式调用 - 导出 Excel 2007（.xlsx）用
Xlsxwriter；要兼容老 Excel（.xls），得额外装phpoffice/phpspreadsheet的mdanter/ecc依赖并用Xlswriter —— 一般没必要，直接用Xlsx
导出 action 里怎么安全取数据并写入表格
别把 GridView 的 dataProvider->models 直接扔给 PhpSpreadsheet —— 分页后只有一屏数据，而且没经过 format 处理（比如 'format' => 'datetime' 在导出时不会自动转）。
- 重新查一遍：用
$query = $model::find()->where(...);构建原始 query，再调$query->all()或$query->asArray()->all() - 字段映射单独定义数组，比如
['created_at' => '创建时间', 'status' => '状态']，避免和 GridView 的attribute别名耦合 - 写入前对每行做格式化：日期用
date('Y-m-d H:i', $row['created_at'])，状态用$row['status'] ? '启用' : '禁用' - 用
ob_end_clean()清掉可能的输出缓冲，否则会导出空白或报Cannot modify header information - 响应头示例：
header('Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet');+header('Content-Disposition: attachment;filename="data.xlsx"');
中文乱码和内存溢出怎么快速定位
乱码基本是编码或 writer 类型错；内存溢出多因一次性 load 全量大数据（比如 10 万行）进内存再写。
- 确保 PHP 文件本身是 UTF-8 无 BOM 编码，模板和数据源也统一 UTF-8 ——
mb_internal_encoding('UTF-8')不解决根本问题 - 不用
setCellValueByColumnAndRow()手动算列号，用setCellValue('B2', ...)更稳；列字母超过 Z 后是 AA、AB，手算易错 - 超 5000 行建议用
fromArray()批量写入，比循环setCellValue快 3–5 倍；再大就得分 chunk，每次查 5000 条，save()前清空 worksheet（$spreadsheet->removeSheetByIndex(0)） - 导出失败时先关掉 Yii2 的调试工具栏（
'yii\debug\Module'），它会往输出里塞 HTML，污染 Excel 二进制流
真正麻烦的不是写几行 PhpSpreadsheet 代码，而是把 GridView 的语义（排序、筛选、格式化）翻译成导出时的数据逻辑——这两套逻辑长得像，但动起手来完全是两件事。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
