先确认PHP≥7.4且启用xml、zip、mbstring扩展，再执行composer require phpoffice/phpspreadsheet，最后用test.php验证类加载成功。
Composer 安装 phpspreadsheet 很简单，但容易因 PHP 版本、扩展缺失或权限问题失败——核心是先确认环境兼容性，再执行标准命令。
确认 PHP 版本和必需扩展
phpspreadsheet 8.x 要求 PHP ≥ 7.4（最新版已要求 ≥ 8.0），且必须启用 xml、zip、mbstring 扩展。缺任一都会在 composer install 后运行时报错，比如 Class 'ZipArchive' not found 或 Call to undefined function mb_convert_encoding()。
- 运行
php -v检查版本 - 运行
php -m | grep -E "zip|xml|mbstring"确认扩展已加载 - Windows 用户若用 XAMPP/WAMP，请在
php.ini中取消对应扩展前的分号（如;extension=zip→extension=zip） - Linux/macOS 用户可用
sudo phpenmod zip mbstring xml（Debian/Ubuntu）或重装带扩展的 PHP 包
使用 Composer 命令安装 phpspreadsheet
在项目根目录下执行标准命令即可，无需全局安装或额外配置。不建议加 --global，否则会污染全局环境且 autoload 不生效。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 安装最新稳定版：
composer require phpoffice/phpspreadsheet - 指定版本（例如锁定 1.29.0）：
composer require phpoffice/phpspreadsheet:^1.29 - 如果提示
Package phpoffice/phpspreadsheet has a PHP requirement incompatible with your PHP version，说明版本不匹配，改用composer require phpoffice/phpspreadsheet --with-all-dependencies强制忽略（仅调试用，生产环境应升级 PHP）
验证安装是否成功
安装后不能只看 vendor/ 目录是否存在，要实际加载类并触发最小初始化，否则可能 autoload 失败但无报错。
立即学习“PHP免费学习笔记（深入）”；
- 新建测试文件
test.php，内容为：
<?php require __DIR__ . '/vendor/autoload.php'; $spreadsheet = new \PhpOffice\PhpSpreadsheet\Spreadsheet(); echo "OK\n";
- 执行
php test.php，输出OK才算真正可用 - 若报
Class 'PhpOffice\PhpSpreadsheet\Spreadsheet' not found，检查是否漏了require 'vendor/autoload.php'，或vendor/路径不对（常见于子目录中执行） - 某些 IDE（如 PhpStorm）需右键
vendor/→ “Mark as Sources Root” 才能正确识别命名空间
最常被跳过的一步是验证扩展是否真在 CLI 模式下启用——Web 服务器用的 php.ini 和终端 php 命令可能不是同一个配置文件，php -i | grep 'Loaded Configuration File' 可确认。
