composer config -g repo.packagist 总不生效是因为三个硬性条件缺一不可：键名必须为单数 repo.packagist（非 repos.packagist）、type 值必须显式写 composer、URL 必须 HTTPS 且末尾带 /；任一错误即静默回退官方源，且不报错。
composer config -g repo.packagist 命令为什么总不生效
它不是“执行了就完事”，而是三个硬性条件缺一不可，漏一个就静默回退到 packagist.org，且完全不报错。
常见失效原因：
-
repo.packagist写成repos.packagist（多一个 s）——键名错误，Composer 直接忽略整条配置 - 中间的
composer被省略或替换成https、packagist等——这是 type 值，必须显式写composer -
https://mirrors.aliyun.com/composer/少了末尾斜杠 / ——请求会拼成/composerpackages.json，返回 404 或空响应 - 漏掉
-g参数——只改当前目录下的composer.json，换个项目就失效
验证是否真写进去了，只看这一行输出：composer config -g repo.packagist。正确结果必须是类似 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} 的完整 JSON，空、null、或仍显示 https://packagist.org 都说明没成功。
项目级配置比全局更可靠，尤其在团队和 CI 场景
全局配置只对当前 shell 用户生效，在宝塔、GitHub Actions、Docker 容器里基本无效——因为那些环境用的是 www、runner 或其他用户身份运行命令，压根读不到你的 ~/.composer/config.json。
推荐做法：进项目根目录（确保有 composer.json），执行：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/
这条命令会自动往 composer.json 的 repositories 字段里安全写入，key 固定为 "packagist"，不会覆盖已有的私有源。
注意两个前提：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 如果项目
composer.json里"repositories"是数组格式（[]），命令会报错；需先手动改成对象格式："repositories": {} - 改完必须删掉
vendor/和composer.lock，再跑composer install（不是update），否则旧 lock 文件里的哈希仍指向官方源
换源后还卡在 “Resolving dependencies” 或 “Loading composer repositories”
镜像只加速下载阶段，对依赖解析过程完全无影响。卡在这两步，90% 不是镜像问题，而是缓存或配置残留。
必须做三件事：
- 运行
composer clear-cache清掉本地元数据缓存 - 删掉项目下的
vendor/和composer.lock - 用
-vvv观察真实请求路径：composer install -vvv 2>&1 | grep "Downloading"，确认日志里出现的是mirrors.aliyun.com而不是packagist.org
如果仍卡在 Resolving dependencies，问题出在 composer.json 本身：比如 PHP 版本约束太宽（"php": "^7.4 || ^8.0"）、require-dev 里塞了太多未锁定的 dev 分支依赖——这些跟镜像无关，得收紧版本、精简依赖。
多用户或容器环境怎么配才不踩坑
全局配置在非交互式环境里极易失效，关键在于用户隔离。
例如宝塔面板，默认用 www 用户执行命令。你在终端用普通用户配了 composer config -g，宝塔根本读不到。
解决方式分场景：
- 宝塔：先确认用户身份，
sudo -u www whoami，再用对应用户重配：sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - Docker / GitHub Actions：别依赖全局配置，CI 脚本中直接加参数更可控：
composer install --repository-url=https://mirrors.aliyun.com/composer/ - 临时调试：用
--repository-url绕过所有配置，验证镜像是否可用，比如composer update --repository-url=https://mirrors.aliyun.com/composer/
最常被忽略的一点：哪怕你把所有配置都写对了，只要 composer.json 里存在 "repositories" 字段（哪怕只是空数组 []），全局配置就会被彻底跳过——Composer 的优先级是硬编码的：项目级 > 全局 > 默认源。
