Yii2中需正确配置PhpSpreadsheet自动加载、使用新命名空间类名、显式获取工作表、手动设置响应头、避免内存溢出及错误处理粒度不足等问题。
Yii2里直接require PhpSpreadsheet会报Class not found
因为Yii2默认不自动加载PhpSpreadsheet的命名空间，composer安装后只是把包放进vendor/phpoffice/phpspreadsheet，但没注册自动加载规则到Yii的类加载器里。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 确认已执行
composer require phpoffice/phpspreadsheet（不要用已废弃的PHPExcel） - 检查
vendor/autoload.php是否在web/index.php或console/index.php中被引入——Yii2标准模板默认已包含，但自定义入口文件容易漏掉 - 不用手动
require或include任何.php文件，PhpSpreadsheet依赖PSR-4自动加载，硬引反而破坏命名空间解析
在Controller里创建Spreadsheet对象总提示“Call to undefined method”
常见于误调用旧版PHPExcel写法，比如new PHPExcel()或PHPExcel_IOFactory::load()，这些类和方法在PhpSpreadsheet中已重命名且结构不同。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 用
\PhpOffice\PhpSpreadsheet\Spreadsheet代替PHPExcel - 读取文件改用
\PhpOffice\PhpSpreadsheet\IOFactory::load(<code>$filePath)，注意首字母大写和命名空间完整 - 写入时别再用
getActiveSheet()->setCellValue()这种链式调用前忘了getSheet(0)——新版默认无激活表，必须显式获取：$spreadsheet->getActiveSheet()或$spreadsheet->getSheet(0) - 导出响应头要手动设置，Yii2不会自动处理
Content-Type，漏设会导致浏览器下载乱码或打开失败
导出Excel时内存溢出或生成空白文件
本质是数据量大时未控制内存占用，或输出缓冲/headers顺序错乱。PhpSpreadsheet默认缓存所有单元格在内存，10万行以上极易OOM。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 大数据导出优先用
\PhpOffice\PhpSpreadsheet\Writer\Xlsx的save()写入临时文件，再用Yii::$app->response->sendFile()推送，别用output()直吐浏览器 - 启用单元格缓存：构造
Spreadsheet时传配置['memoryCacheSize' => '512MB']，但更推荐用CellCaching策略，例如'cache' => \PhpOffice\PhpSpreadsheet\Settings::CACHE_TO_PHP_TMP - 避免在循环里反复调用
setCellValue()——改用fromArray()批量写入二维数组，性能差10倍以上 - 导出前务必调用
ob_end_clean()清空输出缓冲，Yii2某些组件（如debug toolbar）可能提前输出空格，导致header发送失败
Yii2扩展方式封装Spreadsheet逻辑容易踩的坑
有人习惯把Spreadsheet封装成Yii2 Component，但直接在init()里实例化Spreadsheet会导致每次请求都新建对象，浪费内存；若用static单例又可能污染状态（比如多个用户并发导出同一实例）。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- Component里只存配置和工厂方法，不存
Spreadsheet实例本身 - 导出动作应放在Action或Service类中，每次请求新建
Spreadsheet，用完即弃 - 别在
config/web.php里用class键直接绑定\PhpOffice\PhpSpreadsheet\Spreadsheet::class——它不是无参可构造的，会报ReflectionException - 如果要用DI容器注入，需定义闭包工厂：
'spreadsheet' => function () { return new \PhpOffice\PhpSpreadsheet\Spreadsheet(); }
PhpSpreadsheet\Exception、Reader\Exception等），但很多人只捕获Exception，结果IO失败时静默吞掉错误，最后只看到空白响应。 
