composer配置镜像必须严格满足三要素：repo.packagist键名、composer类型值、带末尾斜杠的https url，缺一不可；写错则静默回退官方源，需清缓存、删lock文件并重装才能生效。
直接配对就能见效，但错一个字符就等于没配——repo.packagist 键名、composer 类型值、https://mirrors.aliyun.com/composer/（末尾必须带斜杠）这三者缺一不可。
为什么 composer config -g repo.packagist 命令总不生效？
这不是网络问题，是 Composer 2.x 对配置格式极其严格，写错就静默 fallback 到官方源，不报错也不提示。
-
repo.packagist不能写成repos.packagist或packagist.org—— 多一个s或换名字全无效 - 中间的
composer是type值，不是可选参数，漏掉就会走默认源 - URL 必须是 HTTPS，且结尾必须有
/：https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌（会拼成/composerpackages.json导致 404） - Windows 下若提示 “Could not write to …”，加
--no-plugins重试：composer config -g --no-plugins repo.packagist composer https://mirrors.aliyun.com/composer/
怎么确认镜像真在用？别只看 config 输出
composer config -g repo.packagist 显示 URL 不代表请求真打过去了。得看到实际网络请求才作数。
Discussion 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/"}）或至少是那个带斜杠的 URL 字符串；空、null或仍显示https://packagist.org就失败 - 再查真实请求：
composer show monolog/monolog -vvv 2>&1 | findstr "Downloading"（Windows PowerShell/CMD），日志里必须出现mirrors.aliyun.com才算走镜像 - 注意：全局配置只对当前用户生效。宝塔、计划任务常用
www用户执行，得切过去配：sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
项目级配置比全局更稳，尤其团队和 CI 场景
全局配置容易被覆盖或权限干扰，而项目级配置写进 composer.json，拉代码即生效，行为可预期。
- 进项目根目录，运行（不加
-g）：composer config repo.packagist composer https://mirrors.aliyun.com/composer/ - 该命令自动向
composer.json的repositories字段追加packagist条目，不会清空已有私有源 - 如果
composer.json原本是"repositories": {}，它会转成标准数组并插入；如果是"repositories": []，就追加到末尾 - 改完务必运行：
composer update --lock，否则composer.lock还记着旧源地址，后续install可能因哈希不匹配失败
换了镜像还卡在 Resolving dependencies？和镜像无关
镜像只加速下载环节（Downloading、Fetching package），不解决依赖求解本身慢的问题。
- 卡在
Resolving dependencies超过 10 秒，大概率是composer.json里约束太宽：比如 PHP 版本写成"^7.4 || ^8.0"，或require-dev塞了一堆未锁定版本的工具链 - 旧缓存也可能捣乱：镜像元数据已更新，但本地缓存里还存着 packagist.org 的旧记录，Composer 会优先读缓存并尝试从旧地址校验 —— 结果卡在 DNS 或 TLS 握手
- 解决办法：先
composer clear-cache，删掉vendor/和composer.lock，再跑composer install --no-cache
最常被忽略的一点：换源后必须清缓存 + 删 lock 文件再重装，否则 composer.lock 里的哈希和镜像返回的元数据不兼容，必然报 hash does not match。
