部署必须用composer install --no-dev --optimize-autoloader，二者缺一不可：--no-dev确保仅安装生产依赖并排除dev类进classmap，--optimize-autoloader将其转为静态映射；单独使用任一参数均无法兼顾安全与性能。
部署时必须用 composer install --no-dev --optimize-autoloader
不加这两个参数就上线，等于主动放弃性能和安全底线。只用 --no-dev 会跳过 dev 包，但 autoload 还是走 PSR-4 实时扫描；只用 --optimize-autoloader（或 -o）则会把 dev 包也塞进 classmap，徒增体积、拖慢加载、还可能引入冲突。
二者必须同时出现才真正生效——--no-dev 确保 classmap 只收录生产类，--optimize-autoloader 才能把这批类转成静态映射。CI/CD 脚本里漏掉任一参数，都可能导致首屏延迟高、CLI 命令启动慢、甚至 Class not found 报错。
composer dump-autoload -o 在部署中基本无效
这是最常被误用的命令。它不会重建 vendor/composer/autoload_classmap.php，除非你项目里明确定义了 "classmap" 配置项，或者加了 --classmap-authoritative。默认 PSR-4 项目下，dump-autoload -o 只是重写 autoload_static.php，对 classmap 文件毫无影响。
常见翻车现场：dump-autoload -o 后发现 autoload_classmap.php 文件压根没更新，甚至根本不存在。原因很简单：Composer 只在 install 或 update 阶段扫描 vendor 目录并生成 classmap，dump-autoload 默认不触发这一步。
验证优化是否真生效，别只看命令有没有跑
光执行命令不验证，等于没做。必须确认三件事：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
vendor/composer/autoload_classmap.php文件存在且非空（至少几百行） -
vendor/composer/autoload_real.php中调用了$loader->addClassMap(...) - 部署后首次请求不再反复
stat()类文件（可用strace -e trace=stat php index.php 2>&1 | grep .php快速验证）
如果 autoload_classmap.php 是空的，大概率是 composer.json 里 autoload 配置路径写错了（比如缺末尾反斜杠 "App\": "app/" 写成 "App": "app/"），或新增类没声明在 PSR-4 规则内。
别忘了 PHP 层的配套配置，否则 Composer 优化白做
即使 classmap 生成成功，若 PHP 的 opcache 没启用或配置不当，vendor/autoload.php 和 autoload_classmap.php 仍会被反复编译。典型表现是压测前 10 次响应明显慢，后续才稳定。
必须检查：
-
opcache.enable=1（FPM）且opcache.enable_cli=1（CLI 场景如 artisan、phpunit） -
opcache.memory_consumption≥ 128M（大项目 autoload_classmap.php 可达几 MB） -
opcache.validate_timestamps=0（生产环境禁用时间戳校验）
这些不是可选项，是 --optimize-autoloader 发挥作用的前提。没有它们，classmap 的 O(1) 查找优势会被反复解析 PHP 文件抵消掉。
