composer检测不到新版本主因是镜像源同步滞后与本地元数据缓存未刷新；需用composer config --list | grep repositories确认生效源，执行composer show -a --no-cache验证是否为缓存问题，composer≥2.5用--refresh强制重载元数据，≤2.4需手动删除对应缓存路径。

Composer 检测不到新版本，大概率不是包没发布，也不是你网络断了，而是它正拿着一份过期的元数据在查——镜像源同步滞后 + 本地缓存没刷新，双重卡住。

composer show -a 返回的版本列表不准？先确认它读的是哪份元数据

别信 Packagist 网页、别猜 ^ 和 ~ 的区别，composer show -a vendor/package 输出的 versions 行才是当前 Composer 实际“看到”的全部 tag 和分支。但它看到的，取决于三件事：

• 当前生效的镜像源（项目级 repositories > 全局 repos.packagist > 默认源）
• 本地缓存里是否还存着旧的 packages.json 和 provider-*.json
• 该镜像源本身是否已同步到你要的版本（比如刚发布的 v3.6.0，阿里云镜像可能要等 10–30 分钟）

运行 composer config --list | grep repositories，看 repositories.packagist.url 是否为你预期的镜像地址；再执行 composer show -a vendor/package --no-cache，强制跳过本地缓存走网络请求——如果这时能列出新版本，就坐实是缓存问题。

clear-cache 为什么经常无效？它根本没删对地方

composer clear-cache 只清 ~/.composer/cache/ 下的 ZIP 包和部分 JSON，但最关键的元数据文件（packages.json、provider-*.json）默认有 15 分钟 TTL，清完立刻重跑 update 还会复用旧快照。

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

• Composer ≥ 2.5：直接用 composer update --refresh，只丢弃 provider 相关 JSON，不碰 ZIP，快且准
• Composer ≤ 2.4：手动删对应路径，例如阿里云镜像对应 rm -rf $(composer config --global cache-dir)/repo/https---mirrors.aliyun.com-composer
• 别只清缓存还留着 vendor/ 和 composer.lock——它们会让 install 完全无视新版本

dev-main 或 @beta 版本死活找不到？镜像源默认不索引开发分支

国内主流镜像（阿里云、腾讯云）默认只同步 stable tag（如 1.2.3），dev-main、dev-develop、v3.0.0-beta1 这类通常被跳过。即使包存在，镜像也不会拉取其完整 composer.json。

• 临时解决：composer require vendor/package:dev-main --prefer-source，绕过镜像元数据，直接克隆 Git
• 更稳妥：composer config --unset repositories 切回官方源，再试 require
• 检查包在 Packagist 页面是否标记为 Public，且作者没设 private
• --prefer-source 会显著拖慢安装速度，仅用于验证，别长期开着

换镜像源后还是卡旧版？项目级 repositories 静默覆盖全局配置

很多人执行了 composer config -g repos.packagist composer https://mirrors.aliyun.com/composer/，结果发现 composer install 还是慢、还是装旧版——因为项目根目录 composer.json 里写了 "repositories" 字段，它会**完全屏蔽**全局设置。

• 检查：cat composer.json | grep -A5 repositories，若存在且 URL 是过期地址（如 https://packagist.phpcomposer.com），必须删掉或更新
• 验证：composer config repo.packagist（不加 -g）输出非空，说明项目级配置生效了
• 临时禁用：composer config --unset repositories，再跑 update 看是否恢复正常
• 别忘了 curl 镜像地址测试连通性：curl -I https://mirrors.aliyun.com/composer/packages.json，HTTP 200 才算真通

最常被忽略的点：镜像源不同步是服务端行为，客户端没有“刷新镜像”命令；所谓刷新，本质是让 Composer 丢掉旧元数据、重拉一份新的——而这个动作，必须明确触发，不能靠等或猜。