唯一靠谱解法是用Composer安装PhpSpreadsheet并启用zip、xml、mbstring、gd扩展；需require autoload.php；读取大文件要setReadDataOnly(true)和IReadFilter过滤。
别用PHPExcel，也别手写fgetcsv解析.xlsx——它根本不是CSV。当前唯一靠谱的解法是用Composer装PhpSpreadsheet，并配好基础环境。
安装失败或require报错：先查Composer和PHP扩展
常见现象：Class 'PhpOffice\PhpSpreadsheet\IOFactory' not found、ZipArchive not available、CLI能跑但Web访问白屏。
- 确认 Composer 已全局安装并可用：
composer --version有输出才算到位 - 必须启用 PHP 扩展：
zip（读.xlsx必需）、xml（解析结构）、mbstring（处理多字节字符）、gd（部分样式操作需要） - Linux下执行：
sudo apt install php-zip php-xml php-mbstring php-gd；macOS用 Homebrew 装对应扩展；Windows 检查php.ini中是否取消了extension=zip等行的注释 - 项目根目录运行：
composer require phpoffice/phpspreadsheet，别手动下载 ZIP 或 git clone - PHP脚本开头必须写：
require 'vendor/autoload.php';，路径不对就报错——用__DIR__ . '/vendor/autoload.php'更稳
读出来全是空值或乱码：不是编码问题，是调用方式错了
典型表现：$cell->getValue() 返回 44562 而不是 2022-01-01；中文列名变问号；空单元格判不全。
- 日期不是“乱码”，是 Excel 底层序列号——改用
$cell->getFormattedValue()获取显示值 - 公式内容（如
=SUM(A1:A10)）默认不计算，要显式调用$cell->getCalculatedValue() - 中文内容本身不会乱码（Excel原生UTF-16），乱码大概率出在后续输出或入库环节：确保数据库连接 charset 是
utf8mb4，HTTP响应头设了Content-Type: text/html; charset=utf-8 - 空单元格返回
null，但模板里可能填了空格或''，统一判空建议：trim((string) $cell->getValue()) === ''
大文件（>5MB）直接崩溃：内存爆了，得跳过非数据内容
错误信息通常是：Fatal error: Allowed memory size of XXX bytes exhausted。一个 10MB 的 .xlsx 默认加载可能吃掉 500MB 内存。
立即学习“PHP免费学习笔记（深入）”；
- 关键动作：
$reader->setReadDataOnly(true)，它跳过所有样式、字体、边框、公式定义，只留数值、字符串、日期 - 配合
setLoadSheetsOnly(['Sheet1'])限定工作表，避免多页全载 - 更激进的方案：自定义
IReadFilter实现行列范围过滤，比如只读前1000行、前50列（见知识库中MyExcelReadFilter示例） - 上传路径必须可信：
is_uploaded_file($_FILES['file']['tmp_name'])校验后，再move_uploaded_file()到项目内安全路径，别直接传$_FILES['file']['tmp_name']给IOFactory::load()
读不到.xls文件或报错：旧格式需额外处理，但建议前端统一转.xlsx
现象：Could not read the file、Unsupported file format，尤其对 Excel 97–2003 的 .xls 文件。
- PhpSpreadsheet 默认支持 .xlsx，.xls 需要依赖
markbaker/complex和markbaker/matrix，安装命令：composer require markbaker/complex markbaker/matrix - 但更推荐让前端导出时强制选“Excel Workbook (.xlsx)”——.xls 兼容性差、易损坏、无官方维护保障
- 如果必须读 .xls，且仍失败，先用 LibreOffice 或 Excel 打开该文件，另存为“Excel Workbook (.xlsx)”再试
-
IOFactory::load()能自动识别格式，不用手动指定Xlsx或Xls，传错类名反而绕过自动检测
最常被忽略的一点：错误捕获必须用完整命名空间的异常类——\PhpOffice\PhpSpreadsheet\Reader\Exception，漏写任何一段都会让异常静默吞掉，debug时一头雾水。
