Composer install 后 vendor/ 存在大量冗余文件，因默认保留所有包完整源码（含测试、文档等），需通过 --no-dev、"optimize-autoloader": true 和 --classmap-authoritative 组合优化裁剪。
为什么 composer install 后 vendor/ 还有那么多没用的文件
因为 Composer 默认保留所有包的完整源码（含测试、文档、示例、.git 目录等），哪怕你只用其中 1 个函数。这些内容对运行时完全无用，但会显著拖慢部署、增加镜像体积、拉长 CI 时间。
常见错误现象：vendor/ 占用 200MB+，但实际 autoload 加载的代码可能不到 5MB；CI 构建卡在 composer install 阶段；Docker 镜像反复因 vendor 膨胀而超限。
- 使用
--no-dev：跳过require-dev中的包（如phpunit、mockery），生产环境必须加 - 启用
"optimize-autoloader": true（推荐写进composer.json的"config"块）：生成扁平化类映射，跳过 PSR-4 文件扫描，同时自动剔除未被 autoload 引用的文件（如tests/、examples/） - 加
--classmap-authoritative：进一步强制只从 classmap 查找类，彻底绕过文件系统遍历——这对容器或只读文件系统很关键
怎么安全删掉 vendor/ 里残留的冗余目录
Composer 不会自动清理历史遗留的“垃圾”，比如旧版本升级后留下的 .git、docs/、benchmarks/，或者某些包自带的 resources/（前端资源）。
直接手动删风险高，容易误伤 autoload 依赖的路径。更稳妥的做法是用 Composer 自带的清理机制：
- 先确保已启用
"optimize-autoloader": true，再跑composer dump-autoload --optimize --classmap-authoritative - 然后执行
composer install --no-dev --optimize-autoloader --classmap-authoritative（不是update）——这会让 Composer 基于当前锁文件重建 vendor，并严格按 autoload 规则裁剪文件 - 若仍发现多余目录（如某包下还有
test/），检查该包的composer.json是否声明了"autoload"或"autoload-dev"，没声明的路径默认不被加载，可放心删
composer create-project 初始化时就控制体积
新建项目时如果直接 composer create-project laravel/laravel，默认会装全量 dev 依赖 + 源码附带文件，后续再删很被动。
实操建议从第一步就收紧：
- 加
--no-dev和--no-interaction：避免交互式提问和装 dev 包 - 加
--remove-vcs：删掉所有.git目录（包括 vendor 内每个包的 .git） - 加
--prefer-dist：优先下载压缩包而非 git clone（dist 包通常已剔除 test/docs 等） - 示例命令：
composer create-project laravel/laravel myapp --no-dev --no-interaction --remove-vcs --prefer-dist
CI/CD 或 Docker 构建中容易漏掉的关键点
很多团队在 Dockerfile 里写 RUN composer install 就完事，结果镜像里塞了一堆调试用的文件。
真正要生效，得把优化参数固化进构建流程：
- 别在
composer.json里只写"optimize-autoloader": true就以为万事大吉——Docker 构建时若没传--optimize-autoloader，这个配置不会触发 classmap 生成 - 多阶段构建时，build 阶段用
--no-dev，但 final 阶段不能简单COPY vendor/，必须重新composer install --no-dev --optimize-autoloader --classmap-authoritative，否则 classmap 是空的 - 注意 PHP 版本一致性：
--classmap-authoritative生成的vendor/composer/autoload_classmap.php在不同 PHP 版本下可能行为不一致，CI 和线上环境 PHP 小版本最好统一
最常被忽略的是：autoload_classmap.php 文件本身很小，但它背后依赖的是「安装时是否开启优化」这个动作。没跑对命令，光删文件或改配置都没用。
