详解Composer install命令对根目录下vendor文件的清理规则-composer-PHP中文网

composer install 不会主动清理 vendor 目录，仅按 composer.lock 增量同步：已存在且哈希匹配的文件（如手动添加的 .git、tests/）原样保留；仅当包源变更（如 source 切 dist 或 commit 更新）时才覆盖重建；真正清理需配合 --no-dev --prefer-dist --remove-vcs、archive.excludes 或 find -exec rm 等显式操作，并同步执行 dump-autoload --classmap-authoritative 和 opcache_reset()。

详解composer install命令对根目录下vendor文件的清理规则

composer install 不会主动清理 vendor 目录里的任何文件——它只按 composer.lock 增量同步，残留的 .git、tests/、docs/ 等全留着。

为什么 install 不删旧文件？

Composer 的 install 本质是“还原锁文件状态”，不是“重装干净系统”。它只会：

下载缺失的包（根据 composer.lock 中的 dist/source 信息）
解压/clone 到 vendor/ 对应路径
跳过已存在且哈希匹配的包（哪怕里面多出一个 .git 或 tests/）

也就是说：你上次手动往 vendor/monolog/monolog/.git 里塞了个钩子，只要 lock 文件没变，install 就当它不存在，也不管它是否冗余或危险。

哪些残留会被覆盖？哪些会原地保留？

覆盖只发生在“同名包路径被重新写入”时，比如：

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

如果 composer.lock 里 monolog 的 source.reference 换了 commit，install 会 git reset --hard → 原 .git 被重置，但目录结构不变
如果从 source 切到 dist（或反之），整个 vendor/monolog/monolog/ 被删后重建 → 原 .git 彻底消失
如果只是版本微调（如 2.10.0 → 2.10.1），且用的是 dist 包 → install 只替换 src/ 和 composer.json，tests/ 和 .git 若曾被手动放进去，就一直卡在那儿

想让 install “真正干净”，必须提前干预

靠 install 自己做不到，得配合配置或后续动作：

在 composer.json 的 config 段加 "discard-changes": true → 下次 install 会跳过 git checkout，直接删掉已有 .git 目录（仅对 source 模式生效）
全局设 composer config --global prefer-dist true → 减少 source 模式触发概率，从源头避开 .git
执行 composer install --no-dev --optimize-autoloader --classmap-authoritative 后，再跑 find vendor -name ".git" -type d -exec rm -rf {} + → 手动清，但必须紧接着 composer dump-autoload --optimize --classmap-authoritative，否则 autoload 映射可能还指向已删路径

注意：install 本身不执行 dump-autoload，也不刷 OPcache/APCu，这些全得你显式补上。

误删 vendor 后只 run install，会出什么问题？

常见但容易忽略的坑：

删了 vendor/ 但没删 composer.lock → install 没问题，但若你本地改过某包源码又没提交，这次会彻底覆盖掉
删了 vendor/ 也删了 composer.lock → install 会生成新 lock，但可能拉到新版（比如 laravel/framework 从 10.45.0 升到 10.46.0），而你没测过兼容性
删了 vendor/ 但没清 Composer 缓存 → install 可能复用损坏的 dist 包缓存，解压失败或缺文件

最稳妥的做法是：删 vendor/ + composer clear-cache + composer install --no-dev --no-cache，尤其在 CI/CD 或中文镜像环境下。