composer 优先走缓存需确保：使用 --prefer-dist、不误删缓存目录、验证日志显示“loading from cache”、私有包正确定义仓库、镜像源配置正确且元数据完整、避免 source 类型干扰。
怎么让 Composer 优先走缓存而不是重下
Composer 默认会检查本地缓存是否已有对应版本的 dist 包，但前提是它能确认该包的 dist.url 有效且未被篡改。一旦缓存失效或路径不匹配，就会退回到网络下载。
确保缓存命中的关键操作：
- 始终使用
--prefer-dist（默认行为，但显式加上更稳妥），避免触发source克隆逻辑 - 不要手动删掉
COMPOSER_HOME/cache/下的archival/或repo/子目录——它们各自承担不同职责，误删会导致“缓存存在却不用”的现象 - 运行
composer install -v观察日志：看到Loading from cache才算真正命中；若出现Downloading ...，说明缓存没起作用 - 私有包必须提前在
composer.json的repositories中正确定义，否则 Composer 根本不会把它的 dist 包存进缓存
如何强制所有依赖都用 zip 包安装（跳过 git clone）
有些包在 composer.lock 里记录的是 source 类型（比如你本地开发时用了 --prefer-source，或包本身没提供 dist），这会导致离线或 CI 环境下因缺 Git 而失败。
解决方法不是改 lock 文件，而是从源头控制安装方式：
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 执行
composer install --prefer-dist --no-dev --optimize-autoloader，三者缺一不可：--prefer-dist强制走归档包，--no-dev减少非必需包干扰，--optimize-autoloader附带验证 autoload 是否可用 - 检查单个包类型：运行
composer show vendor/package，看输出中type是library还是project，再确认dist段是否存在且url非空 - 若某包只有
source，需联系维护者补全dist发布，或在自己 fork 的composer.json中手动补上dist字段（含url和shasum）
镜像源配置错误导致下载策略失效
你以为切了阿里云镜像就万事大吉？不一定。Composer 的下载策略高度依赖镜像源返回的元数据完整性。如果镜像同步延迟或丢包，dist.url 可能指向 404，结果就是 fallback 到 source 或直接报错。
排查和修复步骤：
- 运行
composer config -g repo.packagist确认当前全局源地址，注意末尾不能有多余斜杠（https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer//❌） - 临时切回官方源测试：
composer config -g repo.packagist https://packagist.org，如果这时能下，说明镜像有问题 - 某些企业内网镜像不支持
dist重写，需额外配置composer config -g repos.packagist.type composer显式声明类型 - 遇到
Failed to decode response: zlib_decode(): data error，大概率是镜像返回了压缩损坏的 JSON，换源或加--no-cache跳过本地解压缓存
自定义 downloader 插件为什么没生效
你写了插件、注册了 ZipDownloader、也调用了 $dm->setDownloader('zip', $yourDownloader)，但日志里完全没你的 log 输出——最可能的原因不是代码错，而是匹配逻辑断在了前面。
真实生效链条比想象中更脆弱：
- 插件类必须实现
Composer\Plugin\PluginInterface，且composer.json中type必须为composer-plugin，否则根本不会加载 -
dist.type值必须和你注册的 key 完全一致（如zip、tar），大小写敏感；若包是dist.type: "zip"，但你注册的是'ZIP'，就不会命中 - 如果包没有
dist段（即$package->getDistUrl()返回 null），Downloader 根本不会被调用，此时要干预的是InstallerInterface - 调试时别只打 log，加一句
file_put_contents('/tmp/downloader-hit', print_r($package->getName(), true), FILE_APPEND);，确认是不是连包名都没进来
dist.url 的协议头（http → https），也可能导致缓存失效或校验失败。
