composer config -g repo.packagist 配置失效因三个硬性条件缺一不可：键名必须为 repo.packagist（非 repos.packagist）、type 值必须显式设为 composer、URL 必须以 https:// 开头且结尾带 /；否则静默回退官方源。
composer config -g repo.packagist 命令为什么没生效
不是镜像地址失效，而是三个硬性条件漏掉任意一个就静默回退官方源：键名写成 repos.packagist（多一个 s）、漏掉 composer 这个 type 值、URL 末尾没加 /。新版 Composer 2.x 不报错也不提示，只默默走 https://packagist.org。
验证是否成功，必须运行：composer config -g repo.packagist
输出必须是完整 JSON，例如：{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。返回空、null、报错或只有 URL 字符串，都说明配置失败。
-
repo.packagist是固定键名，不能写成packagist.org或repositories.packagist -
composer是必须显式的 type 值，不是可选参数 - URL 必须以
https://开头，且结尾带/，例如https://mirrors.cloud.tencent.com/composer/✅
CI/CD 或宝塔环境里全局配置为啥不生效
全局配置写在 ~/.composer/config.json，但「谁在跑命令」决定读哪个文件。你在终端用 root 执行了 composer config -g，而宝塔「一键部署」或 CI 脚本实际是以 www 或 runner 用户运行的，它根本读不到 root 的配置。
解决方法很直接：先确认执行用户（比如 whoami 或查构建日志 UID），再针对性配置：
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 给
www用户配：sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - CI 容器中推荐改用环境变量：
COMPOSER_REPO_PACKAGIST=https://mirrors.cloud.tencent.com/composer/ - Windows 下配置文件路径是
%USERPROFILE%\AppData\Roaming\Composer\config.json，别手写，始终用composer config -g写入
部署脚本里必须加 --no-interaction 和 --prefer-dist
composer install 在无交互环境中卡住，90% 是因为没加 --no-interaction；没加 --prefer-dist 则可能 fallback 到耗时更长的 --prefer-source，尤其当镜像未缓存对应 dist 包时。
标准部署命令应为：
composer install --no-interaction --prefer-dist --optimize-autoloader
-
--no-interaction：避免因缺少 TTY 卡在 prompt 上 -
--prefer-dist：强制下载 zip 包而非 clone Git 仓库，快 3–5 倍 -
--optimize-autoloader：生成 classmap，提升运行时性能，且不影响安装速度 - 绝对不要在生产环境跑
composer update，它会重新解析依赖树，触发大量网络请求
项目级配置比全局更可靠，但要注意 repositories 结构
进项目根目录执行：composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不加 -g），它会自动安全合并到 composer.json 的 repositories 字段里，不覆盖已有私有源。
但前提是原有结构得对：
- 如果
"repositories": {}（空对象），命令会正确追加"packagist"子项 - 如果
"repositories": []（数组），命令会报错，需先手动改成对象格式 - 千万别写
"packagist.org": false，这会彻底关掉基础包校验，导致php或ext-json约束失败 - 改完记得删掉
vendor/和composer.lock，再重装，否则旧 lock 文件里的 hash 可能和镜像元数据不匹配
Resolving dependencies 卡住几十秒，基本是 PHP 版本约束太宽、require-dev 里塞了太多 dev 包，换任何镜像都没用。 
