PhpSpreadsheet只能安装库本身，不能通过Composer安装“教程”；常见安装失败原因包括：未在含composer.json的项目根目录执行、PHP版本低于7.4、国内网络需配置阿里云镜像、缺少gd/xml扩展；require与require-dev区别影响生产环境类加载；输出干扰导致header错误需避免BOM和前置输出；.xls文件需手动注册Xls reader或转为.xlsx。
PhpSpreadsheet 不能通过 Composer “安装教程”，只能安装库本身；所谓“教程”是手动写的文档，不是 Composer 能装的东西。
composer require phpoffice/phpspreadsheet 安装失败的常见原因
多数人卡在这一步，不是命令写错，而是环境或权限问题：
- 当前目录没有
composer.json（比如在桌面或根目录直接运行），composer require必须在项目根目录下执行，且该目录应已初始化过 Composer（即存在composer.json或至少执行过composer init） - PHP 版本低于 7.4 ——
phpoffice/phpspreadsheet1.25+ 已要求 PHP ≥ 7.4，用php -v确认，旧项目升级前先查版本 - 国内网络直连 Packagist 慢或超时，临时加镜像：
composer config -g repo.packagist composer https://packagist.phpcomposer.com（注意：该镜像已停用，推荐改用https://mirrors.aliyun.com/composer/） - 报错含
ext-gd或ext-xmlmissing —— PhpSpreadsheet 依赖这些扩展，需在 php.ini 中启用，Windows 下取消;extension=gd前的分号，Linux 下用sudo phpenmod gd xml
require 和 require-dev 的区别直接影响 Excel 文件生成行为
很多人把 phpoffice/phpspreadsheet 放进 require-dev，结果部署到生产环境时报 Class 'PhpOffice\PhpSpreadsheet\Spreadsheet' not found：
-
require：运行时必需，Web 请求中读写 Excel 必须放这里 -
require-dev：仅开发期用（比如单元测试里构造假数据），composer install --no-dev会跳过它，线上环境默认走这个参数 - 验证是否装对：运行
composer show phpoffice/phpspreadsheet，看输出的 installed version 是否非空；再检查vendor/autoload.php是否被项目正确引入
new Spreadsheet() 后立刻 save() 报错 “Cannot modify header information”
这是典型输出干扰问题，不是 PhpSpreadsheet 本身的 bug：
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
立即学习“PHP免费学习笔记（深入）”；
- PHP 脚本开头有空格、BOM 字符或
echo/var_dump在header()前执行，导致 HTTP 头无法发送 - Excel 输出必须用
header()设置Content-Type和Content-Disposition，任何前置输出都会破坏它 - 解决办法：确保入口脚本（如
export.php）第一行是<?php，前面**不能有任何字符**（包括 UTF-8 BOM）；用编辑器显示隐藏字符功能检查；临时加ob_start()是权宜之计，但掩盖了根本问题 - 示例安全写法：
#!/usr/bin/env php
<?php
require 'vendor/autoload.php';
use PhpOffice\PhpSpreadsheet\Spreadsheet;
use PhpOffice\PhpSpreadsheet\Writer\Xlsx;
$spreadsheet = new Spreadsheet();
$sheet = $spreadsheet->getActiveSheet();
$sheet->setCellValue('A1', 'Hello');
$writer = new Xlsx($spreadsheet);
$writer->save('hello.xlsx'); // 保存为文件，不触发 header
如果要浏览器下载，就别用 save()，改用 writeAllData() 配合 header()，且确保这之前没任何输出。
从 .xls（Excel 2003）读取数据时抛出 ReaderNotFoundException
PhpSpreadsheet 默认不支持旧版 .xls 格式，它只内置了 Xlsx、Csv、Ods 三种 reader：
- 报错
PhpOffice\PhpSpreadsheet\Reader\Exception: No reader found for <filename>，大概率是传了 .xls 文件给IOFactory::load() - 解决方法只有两个：① 把文件另存为 .xlsx（推荐）；② 手动注册
Excel5reader（已废弃，仅兼容）：IOFactory::registerReader('Xls', \PhpOffice\PhpSpreadsheet\Reader\Xls::class) - 注意：
Excel5reader 不支持所有 .xls 功能（如某些公式、图表），且性能差、维护停止；强烈建议前端上传时就限制格式为.xlsx，后端不做兜底
最常被忽略的是：错误地认为 IOFactory::identify() 能自动适配所有 Excel 变体，其实它只识别已注册的格式；而新项目默认不注册 Xls，得自己加。
