命令总不生效是因为三个硬性条件缺一不可：键名必须是repo.packagist（不能多s或少repo.）、中间的composer是必填type值、url必须以/结尾且加-g；任一出错均静默回退官方源。
composer config -g repo.packagist 命令为什么总不生效
不是网络问题，也不是镜像挂了，90% 是命令写错了三个硬性点，且 Composer 会静默忽略——不报错、不提示、也不写入。
-
repo.packagist必须是这个 exact 字符串：不能多s（repos.packagist无效），不能少repo.（packagist在 2.x+ 被无视） - 中间的
composer是type值，不是注释或可选参数，漏掉就 fallback 到官方源 -
https://mirrors.aliyun.com/composer/必须带末尾斜杠/，少它会导致请求拼成/composerpackages.json→ 404 - 必须加
-g（或--global），否则只改当前项目composer.json，换目录就失效
验证镜像是否真在用，别信“好像快了”
运行 composer config -g repo.packagist 只是看“你写了什么”，不是看“Composer 读了什么”。真正生效要查两处：
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 输出必须是完整 JSON：
{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}；如果返回空、null或报Key "repo.packagist" does not exist，说明根本没写成功 - 跑一次真实操作加
-vvv：比如composer install -vvv，观察日志里实际请求的域名是不是mirrors.aliyun.com—— 这才是铁证 - 注意：进到某个项目后执行
composer config repo.packagist看到的是项目级配置，不代表全局失效；全局和项目级共存时，项目级优先
项目级配置比全局更可靠，尤其适合 CI 和团队协作
全局配置在宝塔、Docker、GitHub Actions 里常失效，因为 ~/.composer/config.json 不一定被读到——CI runner 用户、www 用户、容器内用户，都不是你本机登录的用户。
- 进项目根目录，运行
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（去掉-g） - 它会往
composer.json顶层写"repositories"字段，key 固定为"packagist"，不会覆盖已有私有源——前提是原"repositories"是对象{}，不是数组[] - 如果已有
"repositories": []，先手动改成"repositories": {}再执行命令，否则失败 - 写完建议删掉
vendor/和composer.lock，再composer install，确保依赖真从新源拉取
换镜像后卡在 “Resolving dependencies”？和镜像无关
镜像只加速下载，不解决依赖解析慢的问题。如果你发现 composer update 卡在 Resolving dependencies 几十秒甚至几分钟，基本和镜像配置无关。
- 检查
composer.json里的 PHP 版本约束是否太宽，比如"php": "^7.4 || ^8.0"，会让 Composer 尝试大量组合 - 避免大量未锁定的
dev-包，如"monolog/monolog": "dev-main" -
require-dev里堆太多工具链（phpunit、phpstan、psalm混用）也会显著拖慢解析 - 临时验证：加
--repository-url=https://mirrors.aliyun.com/composer/跑一次composer update -vvv，如果依然卡住，问题就在本地约束或包版本冲突
repo.packagist 的拼写、-g 参数这三点，漏一个就白配——而且你根本不知道它没生效。
