Composer安装的是phpoffice/phpword库而非Word软件，用于PHP操作DOCX文件；执行composer require phpoffice/phpword即可自动下载、写入依赖并生成autoload；需注意PHP版本兼容性及命名空间完整性。
Composer 本身不安装 PhpOffice Word 文档——它安装的是 phpoffice/phpword 这个 PHP 库，用来生成、读取、修改 .docx 文件。 直接搜“安装 Word 文档”容易误解为装了个能打开 DOCX 的图形工具，其实只是加了一套纯 PHP 的文档操作能力。
用 Composer 安装 phpword 的标准命令
确保你已全局安装 Composer 并在终端中可用（运行 composer --version 能输出版本号）。进入你的项目根目录（含 composer.json 或准备初始化的空目录），执行：
composer require phpoffice/phpword
这会自动完成三件事：下载最新稳定版 phpoffice/phpword、写入 composer.json 的 require 区块、生成或更新 vendor/autoload.php。不需要手动下载 ZIP 或改 require_path。
常见报错：Could not find package phpoffice/phpword
这个错误基本只出现在两种情况：
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
立即学习“PHP免费学习笔记（深入）”；
- 拼写错误：比如写成
phpoffice/word、phpword（缺 vendor 名）或phpoffice/php-word（用了短横线） - PHP 版本不兼容：当前
phpoffice/phpword ^1.0要求 PHP >= 8.0；如果你用 PHP 7.4，得显式指定旧版本：composer require phpoffice/phpword:^0.18.3
（^0.18.3是最后一个支持 PHP 7.4 的版本）
安装后怎么用？最小可运行示例
别急着写复杂模板，先验证是否真能跑起来。新建一个 test.php，内容如下：
<?php
require_once 'vendor/autoload.php';
$phpWord = new \PhpOffice\PhpWord\PhpWord();
$section = $phpWord->addSection();
$section->addText('Hello World');
$objWriter = \PhpOffice\PhpWord\IOFactory::createWriter($phpWord, 'Word2007');
$objWriter->save('hello.docx');
echo "文件已生成：hello.docx\n";
?>
运行 php test.php，如果当前目录出现 hello.docx 且能用 Word 或 LibreOffice 打开，说明安装和基础调用完全 OK。注意：\PhpOffice\PhpWord\IOFactory 必须用完整命名空间，漏掉 \PhpOffice\ 前缀会报类找不到。
真正容易卡住的地方不是安装命令，而是后续读写 DOCX 时对临时目录、ZIP 扩展、内存限制的依赖——这些不会在 composer require 阶段报错，但一调用 save() 就失败。先跑通上面那个三行文本的例子，再逐步加样式、表格、图片。
