composer clear-cache后无需重新install，它仅清除~/.composer/cache中的ZIP包和元数据，不影响vendor目录和项目运行；但若已手动删除vendor，则需执行composer install --no-cache确保从源重新下载并刷新autoload。
composer clear-cache 后必须重新 install，不能只删 vendor
清缓存只是删掉 ~/.composer/cache/ 里的 ZIP 和元数据，vendor 目录不受影响。但如果你已经手动删过 vendor，或者想确保环境干净，下一步不是直接跑 composer install 就完事——它可能复用旧的 composer.lock 或残留 autoload 映射，导致类加载失败或版本不一致。
正确顺序是：
- 确认
composer.lock存在且内容合理（尤其检查content-hash是否与当前composer.json匹配） - 若刚清过缓存又删了
vendor，优先运行composer install --no-cache，强制跳过所有本地缓存，从源重新下载 - 如果项目启用了
optimize-autoloader，安装后立刻补一句composer dump-autoload -o，否则新包的类可能无法被找到 - 避免在没删
composer.lock的情况下执行composer update：这会触发依赖重解析，可能升级到非预期版本
为什么 vendor 重建后还报 Class not found？
常见原因是自动加载映射没刷新，或残留了旧包的 autoload 配置。Composer 的 remove 或 install 虽然会更新 vendor/composer/autoload_*.php，但某些情况会漏掉：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
composer.json中autoload.files或autoload.psr-4里硬编码了已移除包的路径，需人工检查并删除 -
vendor/composer/autoload_static.php或autoload_classmap.php里仍存在旧类名映射（尤其当上次dump-autoload是在包未卸载前执行的） - OPcache 或 APCu 没清，导致 PHP 还在用旧的 opcode 缓存——运行
php -r "opcache_reset();"或重启 fpm - 某些框架（如 Laravel）会在
bootstrap/cache/下生成packages.php，这个文件不随 Composer 清理而更新，需手动删或运行php artisan package:discover --force
CI/CD 或 Docker 构建中 vendor 重建失败的典型原因
在自动化环境中，composer install 看似成功，但实际 vendor 不完整或 autoload 失效，往往不是缓存问题，而是构建阶段权限、路径或时机不对：
-
post-install-cmd脚本在vendor/autoload.php写入完成前就启动，导致php artisan找不到类——应改用post-autoload-dump阶段 - Docker 构建时用
ADD . /app把整个目录复制进去，但composer install在非 root 用户下运行，vendor/目录权限为 755 且属主错误，后续 PHP-FPM 无法读取——加RUN chown -R www-data:www-data vendor - 镜像中
/tmp分区只有 100MB，而某个包解压需 800MB 临时空间，composer install在解压阶段静默失败——提前设置TMPDIR=/var/tmp并挂载足够空间的 volume - 使用
--no-dev安装后，phpunit等工具不在vendor/bin/，但脚本里仍调用vendor/bin/phpunit—— 应在 CI 配置中区分 dev/prod 安装策略
清缓存 + 重装后仍拉不到新版包？查 metadata 三处残留
composer clear-cache 不等于“重连 Packagist”，metadata 缓存分散在三个位置，漏一个就可能卡在旧版本：
-
~/.composer/cache/repo/https---packagist.org/：存放packages.json快照和 provider 列表，必须手动rm -rf -
vendor/composer/installed.json：记录当前已安装包的精确版本，影响composer show输出，删掉它会让composer install重新解析依赖图 -
composer.lock：不是缓存，但它是版本锁定依据；如果不想升级，保留它；如果要拉新版，必须删掉再composer install或composer update
验证是否生效：运行 composer update --dry-run -v，观察日志中是否出现 Downloading https://repo.packagist.org/packages.json —— 没有这条，说明 metadata 还在走本地缓存。
