先清缓存再验证镜像同步：执行composer clear-cache清除本地缓存，用composer show -p确认包是否在缓存列表，再通过packagist官网与镜像api（如https://mirrors.aliyun.com/composer/p2/xxx.json）比对版本是否存在；若镜像返回404或缺失目标版本，说明尚未同步，可临时切回官方源验证。
Composer install 报错 Could not find package xxx？先别急着换源
这问题八成不是镜像挂了，而是你本地 Composer 的包索引没更新，或者镜像本身还没同步到新版本。国内镜像（比如阿里云、腾讯云、华为云）通常有 1–6 小时的同步延迟，尤其对刚发布在 Packagist 上的包或 dev 分支。
实操建议：
- 用
composer show -p | head -n 5看当前已缓存的包列表，确认目标包是否在列 - 执行
composer clear-cache清掉本地缓存，再试一次composer require xxx - 别直接改
composer.json里的minimum-stability或加@dev——这容易引发依赖冲突，先确认是不是真没同步
怎么查某个包在镜像里有没有？用 Packagist + 镜像站 API 直接比对
Packagist 是权威源，但国内镜像不会实时转发所有请求。想验证是否“真缺失”，得手动比对。
操作步骤：
- 访问
https://packagist.org/packages/xxx（把xxx换成实际包名），看最新版本号和发布时间 - 访问对应镜像 API，例如阿里云：
https://mirrors.aliyun.com/composer/p2/xxx.json（注意路径是p2/，不是packages/） - 如果镜像返回
404或 JSON 中versions为空/缺少你想要的版本，说明还没同步过来
常见坑：有些镜像不支持 dev- 前缀分支（如 dev-main），即使 Packagist 上存在，镜像也可能跳过同步——这时只能等，或临时切回官方源（composer config repo.packagist composer https://packagist.org）
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
composer require 加了版本却还是找不到？检查约束写法和稳定性标记
版本约束写错是高频原因。Composer 默认只装 stable 版本，而你写的 ^2.0.0 可能匹配不到任何已发布的 stable 版本，尤其当作者只发了 2.0.0-beta1 时。
关键点：
-
composer require vendor/name:2.0.0和composer require vendor/name:^2.0行为不同：前者强制精确匹配，后者允许 minor 更新，但都受minimum-stability限制 - 若包只有预发布版本，必须显式加稳定性标记，比如
composer require vendor/name:2.0.0@beta或composer require vendor/name:@dev -
require-dev里的包不会影响require的解析逻辑，别误以为 dev 包能“带进来”主依赖
镜像配置正确但依然失败？检查 composer.lock 锁定版本与当前源是否兼容
如果你是从别人项目里 git clone 下来的，composer.lock 文件里记录的是原始源（比如 packagist.org）下载的 URL 和 SHA256 校验值。切换镜像后，Composer 仍会尝试从 lock 文件指定的 URL 下载——而镜像 URL 不同，校验失败就报“找不到”。
解决办法很直接：
- 删掉
composer.lock和vendor/目录，再跑composer install - 或者用
composer update --lock重生成 lock 文件（但注意这会更新所有依赖，慎用于生产环境） - 确认当前镜像配置生效：运行
composer config repo.packagist，输出应为类似{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}
真正麻烦的是私有包 + 镜像混用场景：一旦镜像不代理私有仓库，composer.lock 里混着两类源地址，就很容易卡在“部分包找不到”。这种情况下，要么全走私有源，要么给镜像配 upstream 规则——但多数国内镜像不开放该配置。
