项目级配置命令应写为composer config repo.packagist composer https://mirrors.aliyun.com/composer/，需确保无-g参数、键名为repo.packagist、url以https://开头且结尾带/，否则静默失败。
项目级配置命令怎么写
进项目根目录后，直接运行：composer config repo.packagist composer https://mirrors.aliyun.com/composer/。这条命令会安全地向 composer.json 的顶层 repositories 字段写入结构，不覆盖已有内容（前提是原 repositories 是对象而非数组）。
注意三点：去掉 -g 参数、repo.packagist 不能多写一个 s、URL 必须以 https:// 开头且末尾带 /。写错任意一项都会静默失败，后续 composer install 仍走官方源。
-
repo.packagist是固定键名，不是repos.packagist或packagist.org -
composer是必须显式的type值，不能省略 - 如果项目已有
"repositories": []（数组格式），该命令会报错或清空整个数组——此时应先手动改成"repositories": {}再执行
为什么项目级比全局更可靠
全局配置（composer config -g）对所有项目生效，但 CI 环境（如 GitHub Actions）、宝塔面板、Docker 容器里运行的用户常与你本地终端用户不同，导致配置不被读取。项目级配置写进 composer.json，拉代码即生效，团队成员行为一致。
尤其当你用 composer create-project 拉别人维护的模板时，对方 composer.json 可能已禁用默认源（"packagist.org": false），这时全局镜像会被忽略，只有项目级配置能覆盖。
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 项目级配置优先级高于全局，一旦写入，
composer install和composer update都强制走该镜像 - 多人协作时，避免因某人本地配了腾讯云、另一人配了阿里云，导致依赖解析结果不一致
- CI 脚本开头加一句
composer config repo.packagist composer https://mirrors.tuna.tsinghua.edu.cn/composer/就能统一环境
验证是否真的生效了
别只信命令回显“success”，必须验证输出。运行：composer config repo.packagist（不带 -g），正确返回应为：{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。
如果返回空、null 或报错，说明没写进去。常见原因：当前不在项目根目录、composer.json 无写权限、或之前手动改过 repositories 结构导致命令无法合并。
- 再补一招确认：运行
composer diagnose，看Repo.packagist.org行是否显示你的镜像地址 - 执行一次
composer install --no-cache，观察终端日志里是否出现mirrors.aliyun.com或对应域名的请求 - 若首次安装报
hash does not match，删掉vendor和composer.lock重来即可
删掉项目级镜像怎么操作
不想用了？别手动编辑 composer.json，容易误删其他字段。直接在项目根目录运行：composer config --unset repositories.packagist。
注意：是 repositories.packagist，不是 repo.packagist——config --unset 操作的是 composer.json 中的实际路径，而 config repo.packagist 是 Composer 的快捷写法，两者字段名不一致。
- 执行后检查
composer.json，repositories对象里应不再有packagist子项 - 如果
repositories变成空对象{}，可手动删掉整行"repositories": {},保持文件简洁 - 删完后运行
composer config repo.packagist应返回空，表示已清除
repositories 的数据类型（对象 vs 数组）、以及 --unset 和 config 的路径差异上。这些地方一错，就变成“命令跑完了，但啥也没变”。
