95%的“找不到”问题源于本地元数据缓存未刷新、项目级repositories覆盖全局配置或镜像url缺结尾斜杠；需用composer config -g repo.packagist验证生效状态，curl检查镜像同步情况，composer update --refresh清理元数据缓存，并注意dev版本、私有包及composer.lock的影响。
不是镜像挂了，也不是包没了——95% 的“找不到”问题，根源在本地元数据缓存没刷新、项目级 repositories 静默覆盖全局配置，或镜像 URL 缺结尾斜杠导致重定向失败。
验证当前生效的镜像源是否真实可用
很多人以为配过镜像就一定走镜像，其实 Composer 会因配置细节失效而悄悄回退到官方源，甚至不报错。必须用命令确认：
- 运行
composer config -g repo.packagist—— 输出为空？说明根本没走镜像，正在直连https://packagist.org/ - 输出类似
{"type":"composer","url":"https://mirrors.aliyun.com/composer/"}才算生效；注意末尾必须有/，缺它会导致所有p/vendor/name.json请求 404 - 若项目根目录存在
composer.json且含repositories字段（哪怕只写[]），全局镜像立即失效；查它用composer config repos.packagist.url
确认包是否真在镜像中同步到位
composer show vendor/name 返回空，不代表包不存在，只代表本地缓存里的索引没更新。真实状态得靠网络验证：
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 用
curl -I https://mirrors.aliyun.com/composer/p/vendor/name.json查响应头：Last-Modified时间差超过 30 分钟，或返回404，说明镜像尚未同步该包 - 对比官方源：
curl -s https://packagist.org/p2/vendor/name.json | jq -r '.packages."vendor/name" | keys[]' | sort，再对镜像源跑同样命令，看版本列表是否一致 - 别信网页截图或 GitHub tag 页面——
composer show -a vendor/name输出的versions行，才是 Composer 当前“真看到”的全部版本
精准清理元数据缓存，而非盲目 clear-cache
composer clear-cache 只删 ZIP 包和部分 dist 缓存，对 packages.json 和 provider-*.json 完全无效。真正卡住你的，是这些 provider 元数据：
- Composer ≥ 2.5：直接运行
composer update --refresh，它只丢弃元数据缓存，保留已下载包，最快最安全 - Composer ≤ 2.4：手动删对应目录，路径按镜像 URL 转义，例如
rm -rf ~/.composer/cache/repo/https---mirrors.aliyun.com-composer（Windows 是%APPDATA%\Composer\cache\repo\https---mirrors.aliyun.com-composer） - 删完立刻执行
composer show -a vendor/name --no-cache验证；若此时能查到，说明旧缓存就是元凶
处理 dev 分支、beta 版本或私有包的典型陷阱
镜像默认只同步 stable tag（如 v3.0.0），dev-main、@beta 这类版本常被跳过；私有包则完全不会进镜像，必须显式声明源：
- 要装
dev-main，别改minimum-stability，临时加参数：composer require vendor/name:@dev --stability=dev - 私有 Git 包必须在
composer.json的repositories里写明"type": "vcs"和完整 URL，且远程仓库根目录要有合法composer.json，其中name字段必须与require时一致 - 若用了私有源又想保留 Packagist，
repositories数组第一项必须是{"packagist.org": false}，再加一条 type=composer 的官方镜像条目，顺序不能错
最常被忽略的是 composer.lock 文件——它硬编码了旧 provider 地址，不清掉它，换镜像也白搭。删 lock 文件再重试，比反复 clear-cache 有效得多。
