composer clear-cache必须在换镜像前执行，因其仅清除全局缓存目录中files/、repo/、vcs/子目录，而repo/内残留的旧源元数据（如packagist.org/packages.json）会导致composer仍按旧规则解析，即使镜像配置正确也会404或拉错源；清空后下次update才从新镜像获取元数据。
老项目更新依赖包频繁报错，大概率不是依赖冲突或 PHP 版本问题，而是缓存污染或镜像源未生效——先清缓存、再切镜像，90% 的“Could not find package”“has no versions matching”“corrupted zip”都能立刻缓解。
composer clear-cache 为什么必须在换镜像前执行
Composer 把远程源的元数据（比如包列表、版本映射）缓存在 ~/.composer/cache/repo/ 下。哪怕你已用 composer config -g repo.packagist https://mirrors.aliyun.com/composer/ 改了配置，旧 repo/ 里的 packagist.org 快照还在，它会继续按老规则解析，甚至返回 404。这不是配置失败，是缓存没刷新。
- 执行
composer clear-cache后，repo/目录被清空，下次composer update才会真正从新镜像拉取元数据 - Windows 用户注意：缓存路径是
%APPDATA%\Composer\Cache，别去删C:\Users\XXX\AppData\Roaming\Composer\Cache外的其他位置 - 如果执行后提示
Cache directory does not exist，先运行composer config --global cache-dir确认真实路径，再检查权限（尤其之前用过sudo composer install）
换镜像后仍走 packagist.org？检查配置是否全局生效
很多老项目是在不同用户或不同 PHP CLI 环境下跑过的，composer config 默认只改当前用户的全局配置。如果你用宝塔面板或 Docker，很可能实际执行的是另一个用户的 Composer 配置。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 确认生效范围：运行
composer config -g repo.packagist，输出必须是镜像 URL（如https://mirrors.aliyun.com/composer/），不是{"type": "composer", "url": "..."}这种 JSON 格式（那是项目级配置，不覆盖全局） - 若输出仍是
packagist.org，补上强制覆盖参数：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 宝塔用户务必用网站绑定的 PHP CLI 执行命令，例如：
/www/server/php/81/bin/php /usr/local/bin/composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
清完缓存还是装不到新版？别怪命令，看 composer.lock
composer clear-cache 不改变任何依赖版本锁定逻辑。它只管本地缓存文件，不管 composer.lock 里写死的 hash 和版本号。所以即使缓存干净，composer install 依然只会复现 lock 文件记录的状态。
- 想升级到最新兼容版：运行
composer update（全量）或composer update vendor/package-name（单个） - 想强制重装全部依赖（排除 vendor 残留干扰）：删掉
vendor/和composer.lock，再跑composer install - 怀疑
composer.lock被意外损坏：运行composer validate检查语法和结构合法性
只清某类缓存？手动删比等新命令更可靠
composer clear-cache 是全量操作，没有内置开关。但你往往只需要清理特定部分：
- 解决 “Failed to extract xxx: unable to decompress archive”：进
~/.composer/cache/files/，删对应包名子目录，比如rm -rf ~/.composer/cache/files/monolog/monolog - 解决“明明镜像已切，却还拉不到新版”：只清元数据缓存，
rm -rf ~/.composer/cache/repo/ - 释放磁盘空间为主：重点清
files/，它占缓存体积 80% 以上；vcs/可留着（Git 克隆缓存，重装时能省时间）
缓存本身不是敌人，坏掉的缓存才是。真正该警惕的，是把 clear-cache 当万能键——它修不了拼错的包名、不匹配的 minimum-stability、PHP 版本限制，也救不了语法错误的 composer.json。
