composer 没有“刷新镜像”操作，本质是强制重新下载元数据（packages.json），而非同步镜像站；clear-cache 不清元数据缓存，故无法解决拉不到新版本问题；推荐用 composer update --refresh（≥2.5）或手动删除 repo/ 下对应镜像子目录。
Composer 没有“刷新镜像”这个操作，所谓“刷新”，本质是强制重新下载镜像源的元数据（packages.json），而不是让镜像站本身同步——那是服务端的事，客户端无权触发。
为什么 composer clear-cache 不能解决“拉不到新版本”
它清的是 ~/.composer/cache/files/ 和 archives/，但关键的元数据快照（如 repo/https---mirrors-aliyun-com-composer/packages.json）仍被复用。只要这个文件存在且未过期（默认 15 分钟），composer update 就不会发起远程请求，哪怕镜像站上已有 v3.6.0，你本地也只看到 v3.5.0。
- 现象：终端输出
Nothing to install or update，但composer show vendor/package明显落后于镜像站页面 - 验证方法：运行
ls -l $(composer config --global cache-dir)/repo/，看对应镜像子目录下packages.json的修改时间是否陈旧 - 误操作风险：盲目删整个
cache/会连已下载的 ZIP 包一起清掉，下次安装变慢，得不偿失
composer update --refresh 是什么、怎么用、谁支持
这是 Composer ≥ 2.5 引入的专用开关，只动元数据层：删除所有 repo/ 下的 packages.json 和 provider-*.json，然后从当前生效镜像源重新拉取最新索引，不碰 ZIP 缓存、不改 vendor/、不重写 composer.lock。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 必须先确认 Composer 版本：
composer --version，低于 2.5 会报错Unrecognized option: --refresh - 确保镜像已真正生效：
composer config -g repo.packagist.url输出必须是 HTTPS 地址（如https://mirrors.aliyun.com/composer/），HTTP 会被静默拦截 - 执行后立刻验证：
composer update vendor/package-name -v，日志中应出现Downloading https://mirrors.aliyun.com/composer/p/vendor/package-name.json - 项目级
repositories配置会覆盖全局设置，运行composer config --list | grep repositories确认没被误覆盖
老版本 Composer（≤ 2.4）只能手动删缓存子目录
没有 --refresh 参数，就得精准定位并删除对应镜像的元数据缓存路径，否则 Composer 仍会复用旧快照。
- 获取缓存根目录：
composer config --global cache-dir（Linux/macOS 通常是~/.composer/cache，Windows 是%APPDATA%\Composer\Cache） - 进入
repo/子目录，找与你镜像 URL 对应的文件夹，例如https---mirrors-tencent-com-composer（注意协议、域名、斜杠全部转义为-） - 删掉整个子目录：
rm -rf $(composer config --global cache-dir)/repo/https---mirrors-aliyun-com-composer（Windows 用rd /s /q "%APPDATA%\Composer\Cache\repo\https---mirrors-aliyun-com-composer"） - 之后再跑
composer update vendor/package-name，就会重建该镜像的元数据快照
私有包或自定义仓库必须显式指定 --repository-url
Composer 默认仍查 packagist.org，不自动识别你在 composer.json 里配的私有源。不加干预时，composer update --dry-run foo/private 会失败或查错源。
- 先配置好仓库：
composer config repositories.myrepo composer https://my-repo.example.com - 刷新时必须带完整 URL：
composer update --dry-run --repository-url=https://my-repo.example.com foo/private（注意结尾斜杠、协议必须完全一致） - 若响应慢或失败，加
-vvv查看实际请求地址和 HTTP 状态码，避免误判为“包不存在” - 别依赖
composer clear-cache解决私有源问题——它不清理repo/下的私有源快照，除非你手动删
最易被忽略的一点：元数据刷新 ≠ 包重装。即使 packages.json 已更新，composer update vendor/package 仍可能复用缓存里的 ZIP 包。要彻底重下，得额外加 --no-cache；而如果只是想修复“找不到新版本”，--refresh 或手动删 repo/ 子目录就足够了。
