composer update --no-cache是唯一禁用全部缓存的合法方式，它强制跳过files/repo/vcs所有本地缓存，每次重新拉取元数据和ZIP包，但速度慢、耗流量，仅适用于调试。
composer update --no-cache 是唯一禁用缓存的合法方式
想让 composer update 完全不读本地缓存、每次从远程源重新拉取所有元数据和 ZIP 包，必须加 --no-cache 参数。它不是“跳过部分缓存”，而是全程绕过 ~/.composer/cache/ 下的 files/、repo/、vcs/ 全部子目录——包括已下载的 dist ZIP、provider 映射、Git 克隆副本。
常见误操作包括：
- 只运行
composer clear-cache再update：缓存目录虽空，但 Composer 进程内可能仍持有旧元数据引用，尤其在 CI 或 PHP-FPM 复用场景下 - 误以为
COMPOSER_CACHE_DIR=环境变量置空就能禁用：Composer 会 fallback 到默认路径，不生效 - 混用
--refresh和--no-cache：两者互斥，--refresh只刷新元数据（不重下 ZIP），而--no-cache两者都强制重拉
为什么 --no-cache 会变慢且耗流量
--no-cache 不仅跳过本地 ZIP 缓存，还跳过已解析的 packages.json 和 provider-*.json，每次都要重新 GET 所有镜像源索引文件，再逐个校验、下载、解压 dist 包。实际影响包括：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 首次执行比普通
update多出 2–5 倍时间，尤其当项目依赖多、镜像源响应慢时 - 重复下载相同 ZIP（比如多个项目共用同一包 v1.2.3），无法复用已有缓存
- 触发镜像源限流风险：阿里云、腾讯云等国内镜像对高频匿名请求有 QPS 限制
所以它只适合调试场景，比如验证某次更新失败是否由缓存损坏引起，或临时排查私有仓库同步延迟问题。
替代方案：按需清理，而非全局禁用
90% 的“需要禁用缓存”实际是局部问题，直接上 --no-cache 属于过度操作。更精准的做法是：
- 报
Failed to extract或Corrupted zip file？只删~/.composer/cache/files/下对应包名的 ZIP，例如rm -f ~/.composer/cache/files/symfony/console/*.zip -
composer update拉不到新版本？手动删~/.composer/cache/repo/https---packagist.org/，再删vendor/composer/installed.json和composer.lock - 确认镜像源是否生效？运行
composer config --global repo.packagist.org.url，避免配成https://packagist.org却没切到国内镜像
注意 Windows / WSL 权限陷阱
在 Windows 上，--no-cache 并不能绕过 ACL 权限问题；如果 %APPDATA%\Composer\Cache 目录被系统锁定，Composer 仍可能静默失败并回退到部分缓存行为。WSL 用户更要避开 /mnt/c/ 路径——哪怕你用 --no-cache，底层文件系统权限错乱会导致 ZIP 解压失败，错误日志里却只显示模糊的 zlib_decode() error。此时必须把项目移到 ~/projects/ 等原生 Linux 路径下再试。
