唯一正统方案是安装phpoffice/phpspreadsheet，需替换所有PHPExcel_*类名为PhpOffice\PhpSpreadsheet*，读写时注意扩展名匹配、编码设置、公式启用及日期格式化。
直接装 phpoffice/phpspreadsheet 就行，别碰 phpexcel
旧项目还在用 PHPExcel？它已停止维护，PHP 7.2+ 会报错甚至崩溃。现在唯一正统方案就是装 phpoffice/phpspreadsheet，Composer 会自动处理依赖和自动加载，不用手动 require 或复制文件。
常见错误现象：Class 'PHPExcel' not found、Call to undefined method PHPExcel_IOFactory::load()——这说明你混用了旧类名，新库完全不兼容。
- 执行
composer require phpoffice/phpspreadsheet（推荐加--with-all-dependencies避免版本冲突） - 代码里所有
PHPExcel_*类名必须替换成PhpOffice\PhpSpreadsheet\*，比如PHPExcel_IOFactory→PhpOffice\PhpSpreadsheet\IOFactory - 如果用 Laravel，别再往
config/app.php里注册服务提供者——它不提供 Laravel 专用封装，纯原生调用即可
IOFactory::load() 读 Excel 时路径和扩展名必须匹配
传错路径或扩展名不一致，IOFactory::load() 会直接抛出 InvalidArgumentException，不是文件不存在那种提示，而是“没有为该扩展名注册读取器”。
使用场景：用户上传了 .xlsx，但你用 IOFactory::load('file.xls') 去读；或者路径是相对路径却没在当前工作目录下。
立即学习“PHP免费学习笔记（深入）”；
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 确保文件真实存在且 PHP 有读权限，用
file_exists()和is_readable()先检查 - 扩展名必须和实际内容一致：.xlsx 用
Xlsxreader，.xls 用Xls，.csv 用Csv——IOFactory::load()依赖后缀判断，不解析文件头 - 避免用
$_FILES['file']['tmp_name']直接传入，先move_uploaded_file()到安全目录再读，否则可能因临时文件被清理而失败
写大文件时别用 setCellValue() 循环填值
逐单元格调用 setCellValue() 写 10 万行，内存暴涨、耗时翻倍，不是慢一点，是可能 OOM 或超时。Spreadsheet 对象本身带缓冲机制，但默认不启用批量写入。
性能影响：单次 setCellValue('A1', 'x') 触发样式、公式、行列元数据重建；批量写能跳过中间状态。
- 改用
fromArray()一次性写入二维数组：$sheet->fromArray($data, null, 'A1') - 写超大数据集（如导出日志），考虑用
PhpOffice\PhpSpreadsheet\Writer\Xlsx的save()+ 流式写入（需配合ob_flush()和分块逻辑），但注意：原生不支持真正流式，得自己切片 + 多个Spreadsheet实例轮换 - 记得关掉调试模式：
\PhpOffice\PhpSpreadsheet\Settings::setZipArchiveClass(\PhpOffice\PhpSpreadsheet\Settings::ZIPARCHIVE);可提升 .xlsx 写入速度
中文乱码、公式不计算、日期变数字？检查编码和计算引擎
读出来全是问号、SUM() 显示 0、2024-03-15 变成 45366——这些不是 Bug，是默认配置没对齐实际环境。
原因：PhpSpreadsheet 默认按 UTF-8 解析 CSV，但 Excel 文件本身可能含 BOM 或用 GBK；公式引擎默认禁用；日期本质是 Excel 序列号（1900 年起的天数）。
- CSV 读取乱码：显式指定编码：
(new \PhpOffice\PhpSpreadsheet\Reader\Csv())->setInputEncoding('GBK') - 公式不生效：加载后手动触发计算：
$spreadsheet->getActiveSheet()->calculateColumnWidths();或更彻底地$spreadsheet->getCalculationEngine()->enableRethrowExceptions(true);查具体公式错误 - 日期显示为数字：用
getStyle('A1')->getNumberFormat()->setFormatCode(\PhpOffice\PhpSpreadsheet\Style\NumberFormat::FORMAT_DATE_YYYYMMDD2);设置格式，而不是试图转字符串
最常被忽略的是：读取后没调用 getActiveSheet() 就直接操作，结果改的是空 sheet；还有把 load() 返回的 Spreadsheet 对象当成 Worksheet 用，导致方法调用失败。
