配了 composer config -g repo.packagist 却没生效，根本原因是键名拼错（必须单数repo）、漏写type值（必须显式传入composer）、URL缺末尾斜杠（否则404），且未执行composer clear-cache，导致静默回退官方源。
配了 composer config -g repo.packagist 却没生效？不是网络问题，是命令写错、版本不匹配或缓存没清——这三处任一出错，Composer 都会静默 fallback 到官方源，且完全不报错。
为什么 composer config -g repo.packagist 总是无效
根本原因就三个：键名拼错、type 值漏写、URL 缺末尾斜杠。Composer 2.2+ 对键名更敏感，旧写法在部分环境会被忽略；而 Windows 下若用 Git Bash，COMPOSER_HOME 可能指向 %APPDATA%\Composer\config.json，但命令却写入了 ~/.composer/config.json，导致“写了等于没写”。
-
repo.packagist必须是单数，写成repos.packagist或repositories.packagist.org（新版推荐）以外的变体，一律静默失败 -
composer是必须显式传入的type参数，不是可选注释——省略它，命令看似成功，实际只存了个空对象 -
https://mirrors.aliyun.com/composer/末尾的/缺不得，否则请求路径变成/composerpackages.json，直接 404 - 改完不运行
composer clear-cache，本地元数据缓存仍指向旧地址，install/update 看似卡住，实则根本没发请求到新源
验证是否真生效，只看这三处输出
别信命令回显“success”，得交叉比对：
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 运行
composer config -g repo.packagist—— 正确输出应为{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}；若为空、null或报错，说明配置没落盘 - 运行
composer diagnose—— 找到 “Repo:” 行，域名必须是mirrors.aliyun.com，不是packagist.org - 加详细日志跑一次
composer update -vvv—— 日志里所有Downloading行的 URL 必须含你配的镜像域名，且不能出现packagist.org
项目级配置比全局更可控
全局配置看着方便，但一旦团队协作或 CI 流水线介入，就容易出问题：项目里写了 "repositories": {"packagist.org": false}，全局设置直接被覆盖；composer.lock 的 hash 会因源不同而变化，引发部署不一致。
- 进项目根目录，执行
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（注意不带-g） - 它会自动在
composer.json顶层写入"repositories"字段，key 固定为"packagist"，不会覆盖已有私有源（前提是原repositories是对象而非数组） - 改完立刻
composer clear-cache，再composer install，避免缓存干扰
阿里云镜像是目前唯一稳定可用的国内源
截至 2026 年 5 月，腾讯云镜像偶发同步延迟（如 Laravel v11.0.0 晚几小时上线），Laravel China 和 phpcomposer.com 已停服，华为云地址已变更为 https://mirrors.huaweicloud.com/repository/phpcomposer/（注意末尾路径），SJTUG 镜像需教育网环境。
- 坚持用
https://mirrors.aliyun.com/composer/（末尾斜杠不能少） - 别用
http://地址——Composer 2.x 默认禁用非 HTTPS 源，会报Invalid repository type, expected 'composer' - 阿里云不支持上传私有包，但如果你只是下载公共包，它就是当前最稳的选择
最容易被忽略的是缓存和路径不一致：改完配置不 clear-cache，等于白配；在宝塔或 Windows + Git Bash 环境下，composer config -g 写的配置可能根本没被读到。
