必须严格写为composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，三要素缺一不可：键名repo.packagist（单数）、type值composer、URL以https://开头且末尾带/；否则静默回退官方源。
composer config -g repo.packagist 命令到底怎么写才生效
这条命令写错一个字符，镜像就完全不生效，而且不报错、不提示——它会静默 fallback 到 https://packagist.org，你根本意识不到配置失败。
必须同时满足三个硬条件：
-
repo.packagist不能写成repos.packagist（多一个s就被 Composer 忽略） - 第二个参数必须是
composer（这是仓库类型声明，漏掉就会走默认源） - URL 必须是 HTTPS + 末尾带斜杠：
https://mirrors.aliyun.com/composer/✅；https://mirrors.aliyun.com/composer❌（少斜杠会 404）
验证是否成功：运行 composer config -g repo.packagist，输出必须是类似 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} 的完整 JSON 对象。如果为空、null 或仍是 https://packagist.org，说明没写进去。
换源后 composer install 还卡在 Resolving dependencies
这个阶段完全不走网络，是 Composer 在本地穷举满足所有约束的版本组合——跟镜像无关，但比下载还容易卡死。
常见真实原因：
- 写了
"*"或"^1.0 || ^2.0"这类宽泛约束，求解器会指数级爆炸 -
"minimum-stability": "dev"开启后，Composer 要检查成百上千个 dev 分支兼容性 -
"php": ">=7.4"比"php": "^8.1"多查几百个包的元数据 - 没提交
composer.lock，CI 或部署时被迫执行composer update而非install
临时缓解：删掉 minimum-stability、收紧 PHP 版本、用 COMPOSER_MEMORY_LIMIT=-1 避免内存不足中断。
缓存路径放错位置会让 install 慢 2–5 倍
默认缓存路径 ~/.composer/cache 如果落在机械盘、WSL2 挂载的 Windows 目录、加密卷或 NFS 上，解压 ZIP 包时 I/O 就成瓶颈。
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
查当前路径：composer config --global cache-dir
迁移到 SSD：composer config -g cache-dir /mnt/ssd/composer-cache
临时测试：COMPOSER_CACHE_DIR=/tmp/composer-cache composer install --dry-run，再看 /tmp/composer-cache 下有没有新文件生成。
注意：缓存目录必须可写，且别挂到低速卷上；CI、宝塔、systemd 服务常以 www 或 git 用户运行，它们读的是各自家目录下的 ~/.composer/config.json，不是 root 的配置。
CI/容器环境里最常漏掉的四件事
容器或 CI 中 Composer 安装慢，95% 是这四点没处理：
- 没在构建阶段固化镜像配置：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - DNS 缓存异常导致解析卡住（尤其 Alpine 镜像），可加
--dns=8.8.8.8或改用debian:slim - 缓存目录未挂载，每次构建都从零缓存
-
vendor/写入被 SELinux、只读文件系统或 volume 权限拦截
CI 推荐组合参数：composer install --no-dev --prefer-dist --no-autoloader --no-scripts；容器中还要禁用 autoload 生成，避免首次启动扫描整个 vendor 目录。
真正卡点往往不在网络，而在缓存路径、用户权限、依赖约束和 autoload 模式这些细节上——配完镜像只是起点，不是终点。
