Composer全局换源需同时满足三条件：键名必须为repo.packagist、值必须含composer类型标识及HTTPS末尾斜杠；配置仅对当前用户生效，宝塔/Docker/CI需为对应用户单独配置或改用项目级配置。
composer config -g repo.packagist 为什么总不生效
不是网络问题，也不是镜像源坏了，而是这条命令对写法极其敏感——漏掉任意一个要素，Composer 都会静默忽略，不报错也不提示。
必须同时满足三个条件：
-
repo.packagist是唯一合法键名，写成repos.packagist、repositories.packagist或packagist.org全部无效 - 命令末尾必须显式带上
composer类型标识，即composer https://mirrors.aliyun.com/composer/；省略composer就 fallback 到官方源 -
URL必须是 HTTPS 协议，且末尾带斜杠/，例如https://mirrors.aliyun.com/composer/；少这个/，Composer 会拼出/composerpackages.json导致 404
验证是否真生效，只看这一条命令输出：composer config -g repo.packagist。正确结果应为类似 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} 或纯 URL 字符串；返回空、null、https://packagist.org 或报错，说明没写对。
宝塔/Docker/CI 中全局配置经常“失灵”
你在终端里执行成功了，但宝塔后台点「一键部署」、Docker 容器里跑 composer install 还是慢如蜗牛——根本原因是用户权限链断了。
Composer 全局配置默认写在当前用户的 ~/.composer/config.json（比如 /root/.composer/config.json），而宝塔以 www 用户运行，Docker 默认用 root 或非交互用户，CI 流水线常用 runner 用户，它们都读不到你的配置。
解决方法只有两个：
- 给目标用户单独配：先
sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 更推荐：放弃全局，改用项目级配置——进项目根目录，执行
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（注意去掉-g）
项目级配置会写入 composer.json 的 repositories 字段，Git 可追踪、CI 可复现、新人拉代码即生效，且优先级高于全局配置。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
换源后仍卡在 Resolving dependencies
镜像源只加速包文件下载（.zip/.tar），不参与依赖解析。如果你发现 composer update 卡在 Resolving dependencies 几十秒甚至几分钟，和镜像完全无关。
真实诱因通常藏在 composer.json 或本地环境里：
-
"php": "^7.4 || ^8.0"这类宽泛约束，让 Composer 在大量版本间反复试探 -
require-dev里塞了太多未锁定版本的工具链，比如phpunit:^10、infection/infection:dev-main - 用了
minimum-stability: dev，触发全量元数据拉取 - PHP CLI 版本与
composer.json声明不匹配，导致解析器反复回溯
这类问题换任何镜像都无效，得收紧版本约束、删掉冗余 dev 包、或确认实际运行的 PHP 路径（用 which php 和 php --ini 查）。
换源后 composer install 还走 packagist.org？
日志里偶尔出现 packagist.org 并不代表镜像没生效——Composer 2.2+ 默认开启 fallback：当镜像返回 404 或 503 时，会自动切回官方源查一次。
真正要盯的是这两处：
-
composer config -g repo.packagist输出是否合规（见第一条） -
composer install -vvv最后几行是否出现类似Reading packages.json from cache at /https---mirrors-aliyun-com-composer/；如果还看到packagist.org/packages.json，说明被项目级repositories字段覆盖了，或者该字段里写了"packagist.org": false
另外，composer.lock 里记录的是原始 dist URL，换源后首次安装建议加 --no-cache 或先 composer clear-cache，否则旧路径仍会尝试直连。
