composer clear-cache 只清除 Composer 本地包缓存（如 dist 包、metadata、shallow git 克隆），不删除 vendor/、composer.lock 或已安装依赖；缓存路径因系统而异，需检查权限与网络环境。
composer clear-cache 命令到底清什么
它只清 Composer 自己维护的本地包缓存（~/.composer/cache），不碰 vendor/、不删 composer.lock、也不影响已安装的依赖。很多人误以为执行后会重装包，其实只是下次 composer install 或 composer update 时重新下载 zip/tar 包，而不是从缓存解压。
- 缓存位置因系统而异：
~/.composer/cache（Linux/macOS）、%APPDATA%\Composer\Cache（Windows） - 缓存内容包括：dist 包（zip/tar）、metadata（packagist.org 的 JSON 响应）、git clone 的 shallow 克隆副本
- 不会清 Git 全量克隆历史，也不会清
vendor/下的源码 —— 那是composer install --no-cache或手动删vendor/的事
什么时候必须用 clear-cache
不是日常操作，只有在明确怀疑缓存损坏或过期时才需要。典型场景是：执行 composer update 报错，但错误信息里反复出现 file could not be downloaded、Invalid zip file、Corrupted cache file，或者换网络后始终拉不到某包的最新 dist。
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 常见错误现象：
Failed to decode zlib stream、ZipArchive::extractTo(): Invalid or uninitialized Zip object、file_put_contents(…/cache/vcs/…): failed to open stream: No such file or directory - 别在 CI 环境里无脑加
composer clear-cache—— 它会让构建变慢，且多数 CI 已用干净容器，根本没缓存可清 - 如果只是想跳过缓存直接下载，用
composer install --no-cache更轻量，不扰动全局状态
clear-cache 的替代方案和副作用
它本身很快，但副作用容易被忽略：清完之后首次 composer update 会明显变慢，尤其在国内网络下，因为所有 dist 包都要重下，且无法并行复用旧缓存片段。
- 更精准的做法：只清特定包缓存，比如
composer clear-cache vendor/package-name（Composer 2.2+ 支持） - 想彻底重置又不想等下载？可以删缓存目录后，加
--prefer-dist强制走压缩包，避免触发 git clone - Windows 用户注意：
composer clear-cache在 PowerShell 里可能卡住，建议用 CMD 或 Git Bash 执行 - 权限问题常见于 macOS/Linux：如果提示
Permission denied清不了，别用sudo，改用chown -R $USER ~/.composer/cache修归属
验证缓存是否真清掉了
别光看命令返回 “Cache cleared successfully”，得确认目录实际为空，否则可能是权限或路径错位导致假成功。
- 检查命令输出的缓存路径是否和
composer config --global cache-dir一致 - 手动进目录看：
ls -la $(composer config --global cache-dir)，应该只剩空子目录（如files/、vcs/），里面不应有大量.zip或.json文件 - 执行一次
composer require monolog/monolog后再查，能看到新缓存文件生成，说明机制正常
