答案：Composer报“Package not found”但包确在Packagist上，大概率是镜像源同步滞后或漏同步。需运行composer config -g repo.packagist确认当前镜像，手动访问镜像域名查包，临时切官方源验证（composer config repo.packagist '{"type":"composer","url":"https://packagist.org"}'），成功则锁定镜像问题。
Composer 报错提示 Package not found 或 Could not find package xxx，但该包明明在 packagist.org 上存在 —— 大概率是镜像源同步滞后或漏同步，不是你本地配置或代码的问题。
怎么确认当前用的是哪个镜像源
运行 composer config -g repo.packagist，如果返回类似 {"type": "composer", "url": "https://packagist.phpcomposer.com"} 或其他非 https://packagist.org 的地址，说明正在使用第三方镜像。国内常见镜像（如腾讯、阿里、华为）虽快，但同步策略各异，部分小众包或新版本常延迟数小时甚至跳过同步。
更直接的验证方式：打开浏览器访问你当前镜像的包搜索页（比如把 https://packagist.org/packages/monolog/monolog 中的域名换成你的镜像域名），手动查那个报错的包是否存在。
临时切回官方源验证是否是镜像问题
不用改全局配置，只对当前项目生效即可：
- 执行
composer config repo.packagist '{"type": "composer", "url": "https://packagist.org"}'（注意双引号需转义，Windows 命令行建议用单引号包裹整个 JSON） - 再运行
composer update --dry-run或composer require xxx，看是否还报错 - 如果成功，基本锁定是镜像源问题；失败则需排查网络、TLS 证书或包名拼写
恢复镜像只需运行 composer config --unset repo.packagist（前提是没设过全局镜像），或删掉 composer.json 里的 repositories 段。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
永久切换为更稳定的镜像或官方源
官方源最全最及时，但国内直连可能慢或偶发超时；若坚持用镜像，优先选同步机制透明、有公开同步日志的源（如华为云镜像已明确声明“每 5 分钟同步一次”，比某些“每日同步”的更可靠）。
推荐操作：
- 全局切官方源：
composer config -g repo.packagist '{"type": "composer", "url": "https://packagist.org"}' - 全局切华为镜像（较稳）：
composer config -g repo.packagist '{"type": "composer", "url": "https://mirrors.huaweicloud.com/repository/php"}' - 禁用所有镜像（包括插件自动加的）：
composer config -g --unset repos.packagist，再删掉~/.composer/auth.json里可能存在的镜像相关配置
注意：repo.packagist 是覆盖默认源的写法，而 repos.packagist（带 s）是旧版写法，两者共存时行为未定义，建议统一用前者。
为什么有些镜像会漏包
镜像不是简单 rsync，而是通过 Packagist 的 API 拉取元数据，再按规则过滤同步。常见漏包原因：
- 镜像服务主动忽略 dev 分支、
dev-前缀包或低下载量包（如日均下载 - 同步脚本出错后未告警，导致某批次中断且未重试
- 镜像未及时适配 Packagist 新增的字段（如
type: metapackage），直接跳过整条记录 - 你用的 Composer 版本较老（如
2.0.0之前），与某些镜像的 API 响应格式不兼容
遇到冷门包报错，别急着换源，先用 composer show -p | grep xxx 确认是否真被索引；如果官方源能 show 出来，那基本就是镜像的事——这时候切源比调依赖树更省时间。
