直接装完就能用的关键是两步：下载时跳过验证（仅可信环境），装完立即切换国内镜像；Windows用Composer-Setup.exe并手动指定php.exe路径，Linux/macOS需加--install-dir参数安装，再执行composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/生效。
直接装完就能用，不用等超时重试，关键在两步：下载脚本时加 curl 或 php 验证环节跳过（只对可信环境），装完立刻切国内镜像。
Windows 上用安装程序最快，但要注意 PHP 路径识别失败
官网下载 Composer-Setup.exe 是最省事的路径，但它会扫描系统 PATH 里的 php.exe。常见问题不是“没装 PHP”，而是：
-
php.exe在子目录里（比如D:\php\php8.2\php.exe），安装程序只认顶层目录 -
php.ini里extension_dir没开，或php_openssl.dll、php_mbstring.dll缺失 - PATH 中有多个 PHP 版本，安装程序随机选了一个不带扩展的
解决办法：运行安装程序时手动点 “Browse”，精准指定 php.exe 路径；装完后在 CMD 执行 composer --version，如果报错 “Class not found” 或 “SSL certificate problem”，就说明扩展没加载全，得回头检查 php.ini。
Linux/macOS 用一行命令装，但别漏掉 --install-dir 参数
官方推荐的 curl -sS https://getcomposer.org/installer | php 只生成 composer.phar，它不能直接当命令用。必须加参数指定安装位置：
curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer
漏掉 --install-dir 或 --filename，就会卡在当前目录，每次都要 php composer.phar xxx，效率断崖式下降。装完验证用 composer --version，不是 php composer.phar --version。
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
镜像源必须装完立刻切，否则第一次 composer install 就会卡死
默认源 https://packagist.org 对国内用户基本不可用，首次运行任何依赖操作（比如 composer init 后的自动包检测）都会尝试连它。切换镜像不是“锦上添花”，是“保命操作”：
- 阿里云源（推荐）：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 中科大源（稳定性略高）：
composer config -g repo.packagist composer https://mirrors.ustc.edu.cn/composer/ - 切回官方源：
composer config -g --unset repos.packagist
注意：config -g 是全局设置，影响所有项目；如果只想改当前项目，去掉 -g，并在项目根目录下执行（会写入当前项目的 composer.json 的 repositories 字段）。
composer.lock 文件生成前，镜像设置可能不生效
有些用户反馈：“明明切了镜像，为什么 composer install 还是慢？”——因为 composer.lock 里记录的是包的原始下载地址（如 https://api.github.com/...），镜像只影响元数据（composer.json 解析和包索引查询），不影响 lock 文件里已固定的 dist URL。所以：
- 新项目：先切镜像，再
composer init→composer require xxx，全程走镜像 - 已有项目：删掉
composer.lock和vendor/，再composer install，镜像才真正生效 - CI/CD 环境：确保构建机也执行了镜像配置，不能只在本地设
镜像不是万能加速器，它只加速索引和元数据拉取；真正耗时的 zip 包下载，取决于你用的 dist URL 是否被镜像代理——而这个取决于 packagist 维护者是否接入了对应镜像节点。
