composer 安装 phpspreadsheet 报“phpoffice/phpspreadsheet 找不到”是因为 php 版本低于 7.4（v1.29+ 需 ≥8.0）、composer 1.x 未升级、命令漏掉 phpoffice/ 前缀、minimum-stability 配置或缓存异常所致。
Composer 安装 PHPSpreadsheet 时为什么报 phpoffice/phpspreadsheet 找不到？
常见原因是 PHP 版本或 Composer 配置不匹配。PHPSpreadsheet 要求 PHP ≥ 7.4（v1.29+ 要求 ≥ 8.0），而旧版 Composer（如 1.x）默认禁用对高版本包的支持。
- 先运行
php -v确认 PHP 版本，再执行composer --version；若 Composer 是 1.x，升级到 2.x：composer self-update - 安装命令必须带完整命名空间：
composer require phpoffice/phpspreadsheet，漏掉phpoffice/前缀会失败 - 如果项目启用了
minimum-stability为stable，但本地 Composer 缓存损坏，可加--ignore-platform-reqs临时绕过 PHP 版本检查（仅调试用）
读取 Excel 文件时 IOFactory::load() 报 Could not find a reader for the given format
这个错误不是格式不支持，而是文件扩展名与实际内容不一致，或者没启用对应 Reader 的依赖扩展。
-
IOFactory::load()依赖文件后缀判断格式，确保传入的是真实路径（如/path/to/file.xlsx），而非 URL 或未上传完成的临时文件 - XLSX 需要
zip扩展启用；CSV 需要mbstring；ODS 需要xml和zip—— 运行php -m | grep -E "zip|mbstring|xml"检查 - 若读取非标准后缀文件（如无后缀或 .txt 冒充 .xlsx），显式指定 Reader：
IOFactory::createReader('Xlsx')->load($filename)
导出大 Excel 文件时内存溢出或响应超时
PHPSpreadsheet 默认将整个表格加载进内存，10MB 以上文件极易触发 Allowed memory size exhausted 或 Nginx/Apache 超时。
- 用
setCellCacheType()切换缓存策略：优先选PhpOffice\PhpSpreadsheet\Cell\Cell::CACHE_TO_PHP_TEMP，避免全量驻留内存 - 写入前关闭计算引擎：
$spreadsheet->getCalculationEngine()->disable()（除非真要用公式） - 导出 CSV 替代 XLSX：用
PhpOffice\PhpSpreadsheet\Writer\Csv，速度快、内存低，且兼容性更好 - Web 环境下别用
ob_end_clean()后直接header()，应配合flush()分块输出，否则 Apache 可能缓冲整个文件
中文乱码或样式丢失的典型原因
不是编码问题，而是 PHPSpreadsheet 对字符集和样式处理有隐含约定。
- 读取 CSV 时必须显式设置输入编码：
$reader->setInputEncoding('UTF-8')；XLSX 本身是 Unicode，无需设，但源文件若用 GBK 保存，需先转码 - 单元格字体默认为 Calibri，不支持中文显示 —— 必须手动设置：
$cell->getStyle()->getFont()->setName('Microsoft YaHei') - 合并单元格后写入内容，务必在合并前设置值，否则值只出现在左上角单元格，其余为空 —— 顺序不能错
- 使用
setCellValueByColumnAndRow()时列号从 1 开始（A=1），但getActiveSheet()->getCell('A1')是字符串定位，混用易错
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
