composer在windows上安装失败的根本原因是php cli环境未就绪：php -v需返回版本、php -m | findstr openssl需显示openssl、path必须包含php.exe所在目录；三者缺一不可，否则所有安装操作均无效。
装不上不是 Composer 本身有问题，而是 Windows 下的 PHP CLI 环境没真正就绪——php -v 能出版本、php -m | findstr openssl 能打出 openssl、PATH 里有 php.exe 所在目录，这三件事必须同时成立，否则所有后续操作都是白忙。
php.exe 找不到？先别碰 Composer 安装器
这是最常卡住的第一步。双击 Composer-Setup.exe 报 “PHP is not recognized” 或安装时提示 “PHP executable not found”，根本原因不是 Composer，是 Windows 根本调不到 php.exe。
- 打开 CMD 或 PowerShell，直接输
php -v—— 必须返回类似PHP 8.3.5 (cli)的输出；如果报“不是内部或外部命令”，说明 PATH 没配对 - 去你的 PHP 安装目录（比如
C:\xampp\php、C:\php、C:\wamp64\bin\php\php8.3.0）确认是否存在php.exe - 右键“此电脑”→“属性”→“高级系统设置”→“环境变量”，在“系统变量”中编辑
Path，新增一行，只填目录路径（例如C:\xampp\php），**不要带php.exe** - 关掉所有已打开的终端，重新开一个再试
php -v
安装器选错 php.exe 或 PATH 没生效
官方安装器的“Auto-detected”基本不可信。它会扫描注册表或常见路径，但多 PHP 版本共存时（比如 XAMPP 带 8.1，你又手动装了 8.3），大概率选错，或者压根没扫到。
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 运行
Composer-Setup.exe后，看到 PHP 路径输入框，**一定点 Browse 手动选** —— 指向你实际想用的php.exe（如D:\php\php.exe） - 安装完若
composer --version报错，但php -v正常，说明安装器写 PATH 失败了（杀毒软件/组策略常拦截） - 手动把
C:\ProgramData\ComposerSetup\bin加进系统Path变量（同样只到bin目录，不含文件名） - 改完必须新开终端，旧窗口不会刷新 PATH
装上了却连不上 Packagist？换源不是可选项，是必做动作
composer install 卡在 “Loading composer repositories…” 不是网速问题，是默认源 packagist.org 在 Windows 上 HTTPS 握手 + DNS 解析极易超时，尤其国内网络环境。
- 立即执行：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 注意：如果项目根目录已有
composer.json且含repositories字段，全局配置会被无视——得删掉或改成同个阿里云地址 - 换源后首次运行仍可能慢（要缓存元数据），但后续就快了；不用反复重试
- 中科大镜像（
https://mirrors.ustc.edu.cn/composer/）也可用，但阿里云目前更稳
为什么 openssl 和 zip 扩展总被忽略？
这两个扩展不是“建议启用”，是 Composer 运行的硬依赖。Windows 下 PHP 默认关闭它们，而错误信息往往不直说缺哪个模块。
- 运行
php --ini查Loaded Configuration File路径，用记事本打开对应php.ini - 搜索
;extension=openssl和;extension=zip，删掉前面的分号（注意不是php_openssl.dll，PHP 7.4+ 统一用短名） - 保存后，重启终端，分别运行
php -m | findstr openssl和php -m | findstr zip确认输出存在 - 如果仍报错，临时降级：
composer self-update --1（Composer 1.x 不强制依赖ext-zip）
最易被跳过的其实是「重启终端」和「检查 php.ini 是否真被 CLI 加载」——很多人改了 php.ini 却用的是 Apache 绑定的配置，或者改完没关旧窗口，以为 PATH 或扩展已生效。这些点不验证清楚，装十遍 Composer 都一样卡住。
