Composer镜像配置必须一步到位，否则install必卡；命令composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/需严格满足键名、type值、末尾斜杠三要素，缺一即静默回退官方源。
配镜像不是“试试看”，而是必须一步到位，否则 composer install 卡在 Loading composer repositories 或 Downloading 就是常态——这不是你网络差，是默认源根本连不上。
composer config -g repo.packagist 命令必须写全三要素
这条命令静默失败率极高，错一个就 fallback 回 packagist.org，且不报错、不提示。
-
repo.packagist是固定键名，写成repos.packagist（多 s）或packagist.org都无效 - 中间的
composer是type值，不是可选参数，也不能替换成域名或省略 - URL 必须是 HTTPS + 末尾带斜杠：
https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌（少斜杠会拼出/composerpackages.json导致 404）
验证是否真生效，别只看命令有没有报错
执行完配置命令后，必须手动验证，因为 Composer 不会告诉你“写进去了”还是“被忽略”。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 运行
composer config -g repo.packagist，输出必须是完整 JSON：{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} - 输出为空、
null、No repositories configured或仍是https://packagist.org，说明没写进去 - 加
-vvv运行composer install，日志里要出现mirrors.aliyun.com或对应镜像域名，才算真正走镜像
多用户环境（宝塔 / CI / Docker）下，-g 配的是当前用户，不是服务用户
你在终端用 root 配了全局镜像，但宝塔用 www 用户跑 PHP，CI 流水线用 runner 用户执行命令——它们都读不到你的配置。
- 先确认实际运行用户：
whoami或查宝塔面板「PHP 运行用户」 - 切到对应用户重配：
sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - CI 脚本中更推荐临时指定：
composer install --repository-url=https://mirrors.aliyun.com/composer/，避免依赖用户配置
换源后仍卡在 downloading，大概率是 composer.lock 没刷新
镜像只改元数据拉取地址，但 composer.lock 里存着旧包的 dist.url，Composer 会优先尝试那个地址，失败才 fallback——而 fallback 不一定成功。
- 已有项目：执行
composer clear-cache→ 删除vendor/和composer.lock→ 再composer install - 或直接强制重写 lock 文件：
composer update --lock（注意：这会重新解析依赖，慎用于生产环境） - 新项目创建时，建议加参数直连镜像：
composer create-project hyperf/hyperf-skeleton --repository-url=https://mirrors.aliyun.com/composer/
最易被忽略的一点：镜像只加速下载，不加速依赖解析。如果 composer update 卡在 Loading package information 或反复回溯版本，问题不在镜像，而在 require 版本约束太宽或存在冲突——这时候换源没用，得调 composer.json 的版本号。
