因为composer clear-cache只清缓存文件但不刷新元数据快照，而packages.json等元数据默认15分钟不过期，导致仍读取过期索引；需配合--refresh、--no-cache或--dry-run强制重拉远程元数据。
为什么 composer clear-cache 有时不够用
执行 composer clear-cache 确实会清空整个本地缓存（包括 ~/.composer/cache/ 下的 repo/、files/、archives/），但它不解决“已缓存但过期的包元数据仍被复用”的问题。Composer 在安装或更新时，会优先读取 repo/ 中的 packages.json 快照（尤其是 Packagist 镜像或自建仓库），而这些快照可能几天没更新，导致 composer require foo/bar 仍拉到旧版本，甚至报 Could not find package foo/bar —— 实际上包早已发布，只是本地缓存的元数据没刷新。
用 composer update --dry-run + --prefer-dist 触发元数据重载
Composer 没有直接“刷新某包元数据”的命令，但可通过强制触发远程元数据拉取来间接实现。关键在于绕过本地缓存的 packages.json，让 Composer 重新向源（如 packagist.org）发起 HTTP 请求：
- 运行
composer update --dry-run --prefer-dist foo/bar（把foo/bar换成你要刷新的包名） - 它不会修改
composer.lock或安装代码，但会：尝试解析该包的最新可用版本 → 发起对https://packagist.org/p2/foo/bar.json的请求 → 成功后将新元数据写入~/.composer/cache/repo/https---packagist.org/packages.json（注意：不是单独文件，是合并进主快照） - 若遇到 404 或包不存在，说明名称拼错，或该包在当前仓库中不可见（比如私有包未配置仓库）
- 此方法比
clear-cache更精准：不删其他包缓存，也不清空下载好的 ZIP 归档，只更新元数据层
对私有包或自定义仓库必须指定 --repository-url
如果你用的是私有 Packagist、Satis 或 Artifactory，Composer 默认仍查 packagist.org。不加干预的话，update --dry-run foo/private 会失败或查错源：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 确认该包所在仓库已添加：
composer config repositories.myprivaterepo composer https://my-repo.example.com - 刷新元数据时显式指定：
composer update --dry-run --repository-url=https://my-repo.example.com foo/private - 注意：此处
--repository-url必须和repositories配置中的 URL 完全一致（含协议、尾部斜杠），否则 Composer 会忽略并 fallback 到默认源 - 私有仓库响应慢时，可加
-vvv查看实际请求地址和返回状态码，避免误判为“包不存在”
缓存路径与手动清理的边界情况
当上述方法仍无效（例如元数据更新了但 Composer 还是读旧版），可能是缓存文件权限异常或损坏。此时需定位并清理对应缓存项：
- 查缓存根目录：
composer config cache-dir（通常是~/.composer/cache） - 元数据缓存在：
<code>repo/https---packagist.org/子目录下，文件名类似packages.json和provider-*.json - 不要手动删整个
repo/目录——这等于退回到clear-cache；只需删packages.json和所有provider-*.json，再跑一次composer update --dry-run foo/bar即可重建 - Windows 用户注意：
cache-dir路径含空格或特殊字符时，部分 shell 会解析失败，建议用 PowerShell 或 Git Bash 执行
真正卡住的点往往不在命令本身，而在仓库配置是否生效、网络能否直连目标源、以及缓存文件是否被其他进程锁住——这些比“怎么敲命令”更常耽误时间。
