真正生效只需执行composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，该命令自动处理路径、json格式与权限，避免手写错误；其他操作如手动改config.json、加斜杠或清缓存均非必需。
全局镜像设置真正生效，只靠 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 这一条命令就够了；其他所有手动改文件、拼 JSON、加斜杠或删缓存的操作，不是多余就是错位。
为什么 composer config -g 是唯一推荐方式
Composer 的全局配置逻辑很明确：它读取 COMPOSER_HOME/config.json（Linux/macOS 是 ~/.composer/config.json，Windows 是 %APPDATA%\Composer\config.json），而 composer config -g 会自动识别路径、校验 JSON 格式、安全写入，并保留已有字段（比如 auth tokens）。手写配置文件极易因逗号遗漏、缩进错乱或路径错误导致后续所有 composer 命令直接报 file_get_contents(): Failed to open stream。
常见错误现象：
- 执行了
composer config repo.packagist ...却没加-g或--global→ 写进当前项目，对其他项目完全无效 - 用
sudo composer config -g（Linux/macOS）→ 配置写进了 root 用户的/root/.composer/config.json，普通用户运行时根本读不到 - 字段名写成
repos.packagist或repositories.packagist.org→ Composer 不识别，静默忽略
如何验证镜像是否真正在用
别只看 composer config -g repo.packagist 的输出，那只是“你写了什么”；要看 Composer 实际请求了哪个域名。最可靠的方法是加 -vvv 跑一次真实操作：
composer clear-cache && composer require monolog/monolog -vvv
在日志里搜索 Downloading，确认出现的是：
Downloading https://mirrors.aliyun.com/composer/packages.json
而不是 https://packagist.org/packages.json 或 https://repo.packagist.org/packages.json。如果看到后者，说明全局配置被项目级 repositories 覆盖了——此时要检查当前目录下 composer.json 是否有 "repositories" 字段。
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
项目级配置覆盖全局时怎么处理
只要项目根目录存在 composer.json 且里面定义了 "repositories"，Composer 就会完全忽略全局的 repo.packagist 设置。这不是 bug，是设计行为。
解决方式取决于场景：
- 想统一团队行为 → 直接删掉项目
composer.json里的"repositories"字段，让全局镜像接管 - 项目必须用私有源（如 GitLab 私库）→ 全局镜像仍生效，因为私有源是
vcs类型，和 Packagist 镜像不冲突；只有"type": "composer"的源才会被全局repo.packagist覆盖 - CI/CD 构建中不稳定 → 在构建脚本里显式执行
RUN composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，避免依赖宿主环境的配置
Docker 和 CI 环境下的坑
Docker 容器默认没有持久化的用户家目录，composer config -g 写入的配置在容器退出后就丢了。所以不能只在本地配好就以为万事大吉。
构建阶段必须显式写入：
RUN composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
放在 composer install 之前。更稳妥的做法是把这行加进 CI 脚本开头，或在 GitHub Actions 中缓存 ~/.composer 目录——否则每次拉取都可能走默认慢源。
另一个容易被忽略的点：某些 CI 平台（如 GitLab CI）默认以 root 用户运行，而你的本地开发用的是普通用户。这时全局配置必须在 CI 环境中单独执行，不能指望“本地配一次，全环境通用”。
