composer clear-cache 不生效是因为它只清理 files/ 和 vcs/ 目录，不删除决定依赖解析的元数据文件（如 packages.json 和 provider-*.json），这些文件位于 ~/.composer/cache/repo/https---packagist.org/，必须手动清除该目录，并同步删除 vendor/composer/installed.json 和 composer.lock 才能强制刷新元数据、触发新版本解析。
Composer 依赖更新卡住，大概率不是网络或配置问题，而是 metadata 缓存没清干净——composer clear-cache 单独执行基本无效。
为什么 composer clear-cache 总是不生效？
它只删 ~/.composer/cache/files 和 vcs 目录，但真正卡住 update 的元数据（packages.json、provider-*）全在 ~/.composer/cache/repo/https---packagist.org/ 里。这个目录里的文件不会被 clear-cache 触及，下次 update 仍会复用旧快照，导致新版本根本不出现在解析范围里。
常见错误现象：
- 私有包发布后
composer update仍拉不到，--dry-run -v显示请求的还是老packages.json时间戳 - 明明 Packagist 上已标记 v3.0.0 为 stable，本地却始终停在 v2.9.1
- 切换镜像源后第一次 update 很慢，之后又变快——说明元数据缓存没刷新，还在用旧索引
必须手动清理的三个关键位置
只删对地方，比反复跑 clear-cache 省三分钟。顺序不能错，否则 update 会重建部分缓存，白清。
-
rm -rf ~/.composer/cache/repo/https---packagist.org/—— 元数据源头，删完才真正“重读仓库” -
rm -f vendor/composer/installed.json—— 这个文件是当前安装状态快照，影响composer show和后续解析逻辑 -
rm -f composer.lock—— 它不是缓存，但会硬锁定旧版本；不清掉，update只做最小变更，不会升主版本
执行完再跑 composer update --dry-run -v，看输出里是否出现 Downloading https://packagist.org/packages.json 和新时间戳，确认元数据已刷新。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
清理后还要注意 repositories 配置陷阱
如果你项目里写了自定义 repositories（比如 Satis 或私有 Packagist），clear-cache 和删 repo 目录都只作用于默认源。私有源的元数据缓存在：~/.composer/cache/repo/https---your-private-repo.com/，得按同样逻辑手动删。
另外两个容易忽略的点：
- 如果
composer.json里设了"minimum-stability": "stable"，即使远程已有v4.0.0-rc，也不会触发升级——得临时改成"minimum-stability": "dev"再 update -
composer update vendor/package这种指定包更新，会跳过部分元数据刷新逻辑，建议先全量清再针对性操作
长期缓存管理：别等卡住才动手
频繁手动删目录不是办法。推荐在全局配置里加两行：
composer config --global cache-files-ttl 2592000 composer config --global cache-files-maxsize "500MiB"
前者把压缩包缓存有效期从默认 6 个月缩到 30 天，后者防止单一缓存目录无限膨胀。配合定期跑 composer clear-cache --gc（只收过期/超限文件），能避免大部分“突然卡住”场景。
真正麻烦的从来不是删缓存，而是删完发现 composer.lock 里还锁着半年前的 dev 分支提交哈希——那种时候，你就知道为什么得把 rm -f composer.lock 刻进肌肉记忆了。
