生产环境必须用 composer install --no-dev --optimize-autoloader --classmap-authoritative --no-interaction --prefer-dist，缺一不可；否则类加载退化为反复 stat()、启动变慢数倍或报 Class not found。
生产环境必须用 composer install --no-dev --optimize-autoloader --classmap-authoritative --no-interaction --prefer-dist，缺一不可；漏掉任一参数，类加载就可能退化为反复 stat()、启动变慢数倍，甚至报 Class not found。
为什么 composer install --no-dev 单独用等于没做
它只跳过 require-dev 里的顶层包（如 phpunit），但不会清理已写入的 autoload 规则——比如某个包在 autoload-dev 里注册了 "Tests\": "tests/"，--no-dev 后这个映射仍保留在 vendor/composer/autoload_psr4.php 中，导致 autoloader 尝试拼路径、反复 stat() 失败，白占内存还干扰匹配。
-
--no-dev必须搭配--optimize-autoloader：前者删包，后者重生成autoload_classmap.php，二者联动才真正切断 dev 路径 - 不加
--classmap-authoritative，autoloader 仍会 fallback 到目录扫描，--optimize-autoloader几乎无效 -
--no-interaction防插件卡在 prompt（如hirak/prestissimo），CI 流水线直接超时 -
--prefer-dist强制下 zip 包，避免部署机上git clone因网络或权限失败
Class not found 报错不是配置错，是 classmap 漏了类
启用 --classmap-authoritative 后报错，说明 vendor/composer/autoload_classmap.php 里没有该类——不是 autoloader 没生效，而是根本没收录进去。
- 检查你新加的类是否在
composer.json的autoload或autoload-dev里声明；--no-dev后autoload-dev规则全失效 - 常见漏收原因：命名空间末尾少反斜杠，比如
"App": "app/"对，"App": "app"错 -
"files"类型加载（如全局函数文件）不会进 classmap，开了--classmap-authoritative它们仍能工作，但别误以为所有 autoload 都走 classmap - Laravel 中通过
AppServiceProvider::boot()动态绑定的接口实现，不对应真实类文件，自然不在 classmap 里——这跟--classmap-authoritative无关，是设计使然
autoload_classmap.php 越大越慢？先删无用 autoload 配置
autoload_classmap.php 若达数 MB，每次请求全量 require 进内存，反而比 PSR-4 拼路径更耗时——尤其当实际只用到其中不到 5% 的类时。
- 删掉
composer.json里这些无效配置："docs/": ["docs/"]、"tests/": ["tests/"]、"": ["lega"] -
"autoload-dev": {"psr-4": {"Tests\": "tests/"}}这类配置若没配--no-dev，测试类会混进 classmap，白白增大数组体积 -
"optimize-autoloader": true写在composer.json里只是默认开关，不触发实际动作；它不能替代命令行参数 - Composer 2 默认生成的
autoload_static.php已足够轻量高效；盲目加-o不如先清理 autoload 配置
部署脚本里最容易漏掉的三件事
光写对命令不够，CI/CD 或手动部署脚本里常因顺序或上下文出错。
- 必须先
git checkout到目标 tag/branch，再执行composer install——否则composer.lock和代码版本不匹配，线上可能降级关键包 - 不能依赖本地
composer.lock是否存在：有些团队把 lock 文件.gitignore了，结果部署时自动 fallback 到composer update，破坏可重现性 - 别用
composer dump-autoload -o替代install——它不重建autoload_classmap.php，多数情况下生成的文件根本没更新，甚至压根不存在
真正起效的不是参数堆砌，而是确认 vendor/composer/autoload_classmap.php 存在且非空，同时 vendor/autoload.php 里包含 'classmap-authoritative' => true；运行时若有动态拼类名逻辑（如 class_exists('SomeDynamicClass' . $suffix)），必须提前确保它们被收录进 classmap，否则必报错。
