答案是运行composer diagnose查“repo packagist.org:”行确认实际生效源，再结合curl -i验证镜像同步状态、删除元数据缓存目录，并确保项目无覆盖性repositories配置。
Composer 找不到包，90% 不是包不存在，而是你当前配置的源没生效、缓存没清干净，或者镜像还没同步到那个版本——直接换阿里云镜像 + 清元数据缓存 + 验证日志，三步就能解决。
怎么确认当前用的是哪个镜像源？
别只看 composer config -g repo.packagist 输出，它只告诉你“写了什么”，不等于“正在用什么”。真正起作用的有三层优先级：
- 项目级
composer.json里的repositories字段（最高优先级，写了就屏蔽全局） - 全局配置
~/.composer/config.json中的repo.packagist（需带type: "composer"和结尾/） - 默认
https://packagist.org/（兜底，但会拖慢甚至失败）
验证方式：运行 composer diagnose，找到 Repo packagist.org: 这一行，后面跟的 URL 必须是你设的镜像地址（比如 https://mirrors.aliyun.com/composer/），且结尾有斜杠；如果还是 https://packagist.org/，说明配置没生效或被项目 repositories 覆盖了。
为什么换了镜像还是报 “Could not find package xxx”？
不是镜像失效，而是元数据同步延迟或本地缓存残留。国内镜像（如阿里云）通常有 5–30 分钟同步延迟，新发布的包不会立刻出现在镜像中。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 先执行
composer clear-cache（注意不是cache-clear，后者已废弃） - 再删掉元数据缓存目录：
rm -rf ~/.composer/cache/repo/https---mirrors-aliyun-com-composer（路径按你实际镜像 URL 转义） - 用
curl -I https://mirrors.aliyun.com/composer/p/vendor/name.json直接测镜像是否已同步（HTTP 200 +Last-Modified接近当前时间才算） - 如果仍失败，临时加
--no-cache跑composer show vendor/name -vvv，看日志里请求的是哪个域名
怎么永久配置推荐镜像（阿里云 / 腾讯云 / 华为云）？
推荐用全局配置，但必须写对键名和格式，否则静默 fallback 到官方源：
- 阿里云：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 腾讯云：
composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/ - 华为云：
composer config -g repo.packagist composer https://repo.huaweicloud.com/repository/php/
关键点：
- 键名必须是
repo.packagist（不是repos.packagist或repos） -
type值必须显式为"composer"（命令自动补全） - URL 必须以
https://开头、以/结尾，缺一不可 - 旧版本 Composer（1.x）可能不支持 HTTPS 镜像，升级到
composer self-update至 2.5+ 更稳妥
项目里写了 repositories 就一定走镜像吗？
不一定。项目级 repositories 一旦存在，全局镜像立即失效，而且不会 fallback。常见坑：
- 项目
composer.json里写了"repositories": [{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}]—— 这样写没问题，但必须确保该数组里没有其他无效源（比如已停服的旧镜像） - 如果想保留私有源又用国内镜像，正确做法是把 packagist 主源单独声明并置顶：
{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}，再在末尾加{"packagist.org": false} - 千万别在
repositories里写"packagist": false或"packagist.com": false，这些会被静默忽略
最保险的验证方式，永远是跑一次 composer install -vvv，盯着最后几行日志里出现的 Reading packages.json from cache at ... 路径，看域名是不是你配的那个镜像地址——这才是唯一真相。
