Composer update读不到新版本，因项目级repositories字段覆盖全局镜像且元数据缓存15分钟不过期；≥2.5用--refresh强制重拉，≤2.4需手动删除cache-dir/repo/下的packages.json目录。
composer update 读不到新版本？先查实际生效的镜像源
Composer 不是“没更新”，而是根本没去拉新元数据——它复用了本地缓存的 packages.json，而这个缓存默认 15 分钟不过期。更隐蔽的是：项目级 repositories 字段会直接屏蔽全局镜像配置，哪怕你用 composer config -g 设了阿里云，只要 composer.json 里有 "repositories" 这个 key，就全作废。
验证方式很直接：
- 运行
composer config repo.packagist（不加-g），看输出是不是你想要的镜像地址 - 再跑一次
composer require monolog/monolog --no-install -vvv，滚动日志里找Downloading https://...那行，确认域名是否匹配预期源 - 检查环境变量：
env | grep COMPOSER_REPO_PACKAGIST（Linux/macOS）或echo %COMPOSER_REPO_PACKAGIST%（Windows），有值就优先级最高
metadata 缓存不刷新，clear-cache 没用
composer clear-cache 只清 files/（ZIP 包）和 repo/https---packagist.org/provider-*.json（包提供者映射），但不会动 repo/https---packagist.org/packages.json 这个核心元数据文件。所以即使清了缓存，composer update 仍可能显示 “nothing to install or update”。
必须手动删掉整个元数据目录：
- Linux/macOS：
rm -rf $(composer config --global cache-dir)/repo/https---packagist.org - Windows PowerShell：
Remove-Item "$env:APPDATA\Composer\Cache\Repo\https---packagist.org" -Recurse -Force - 删完后务必同步清理
vendor/composer/installed.json和composer.lock，否则新旧哈希对不上，install会静默失败
Composer ≥2.5 用 --refresh，别手删
如果你用的是 Composer 2.5 或更高版本，composer update --refresh 就能一步到位：丢弃所有元数据缓存、强制从当前生效镜像重拉 packages.json 和 provider 映射。它比手删更安全，不会误删 vcs/ 或 repo/ 下其他源的缓存。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
但注意两个前提：
- 确保
composer config repo.packagist输出是你想用的镜像地址（比如https://mirrors.aliyun.com/composer/），否则--refresh拉的还是错的源 - 如果项目
composer.json里写了"repositories"，--refresh同样无效——得先删掉那段配置
删了缓存还报 Extracting 失败？定位损坏 ZIP
有时候 composer update 卡在 Extracting vendor/symfony/console 并报 Corrupted zip file，不是网络问题，而是 ~/.composer/cache/files/ 下某个 ZIP 文件本身损坏（比如下载中断、磁盘写异常）。clear-cache 会清空整个 files/，但 Composer 在重装时可能跳过校验直接复用已损坏副本——它只比对哈希，不验证 ZIP 结构。
精准处理步骤：
- 盯住
composer install -v输出末尾，提取出失败包名，如symfony/console - 进缓存
files/目录，模糊搜索：ls -l *symfony*console*.zip（Linux/macOS）或Get-ChildItem "$env:APPDATA\Composer\Cache\Files" -Recurse -Filter "*console*.zip"（PowerShell） - 只删匹配的 ZIP 文件，别碰
repo/和vcs/子目录——它们不参与解压 - 删 ZIP 后若仍报错，说明
composer.lock里硬编码的dist.sha256值与新下载内容不匹配，必须连vendor/和composer.lock一起删掉重来
最常被忽略的点：缓存目录权限异常时，clear-cache 表面成功，实则根本没删掉任何东西；而 --refresh 在低版本 Composer 上不存在，盲目套用只会浪费时间。动手前，先用 composer config repo.packagist 和 -vvv 日志确认真实瓶颈在哪。
