生产环境应使用 composer install --no-dev --classmap-authoritative --optimize-autoloader，而非 composer dump-autoload -o；后者在 composer 2.0+ 中仅为别名，易因 classmap 不全导致 class not found 错误。
别在生产环境直接运行 composer dump-autoload -o——它在 Composer 2.0+ 中已失效，且大概率导致 Class not found 错误。
为什么 composer dump-autoload -o 在现代 Composer 中不安全
Composer 2.0 起，-o（即 --optimize）只是 --classmap-authoritative 的别名，行为已彻底改变：它会强制禁用 PSR-4 动态查找，但又不保证 classmap 覆盖全部类。一旦漏掉某个类（比如空目录、条件加载的类、或 files 类型引入的辅助文件里 new 出来的类），就会直接报错。
-
composer dump-autoload --optimize不生成完整 classmap，只做轻量映射合并，无法替代权威模式 - CI/CD 构建时若用了这个命令，本地能跑、线上炸锅是常态
- 检查
vendor/autoload.php，如果里面没写'classmap-authoritative' => true，说明根本没生效
真正该用的命令是 composer install 组合拳
生产部署必须走 composer install，而不是 dump-autoload。后者只是开发期补丁，前者才是构建可信 autoload 的唯一正途。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 运行
composer install --no-dev --classmap-authoritative --optimize-autoloader - 确保
composer.json里有"optimize-autoloader": true，否则下次composer update会丢掉优化 - 加
--no-dev是硬性前提：dev 依赖的类不会进 classmap，残留它们会让 autoloader 回退到慢路径 - 验证是否生效：查看
vendor/composer/autoload_real.php中findFile()方法——如果只剩if ($classMap = $this->classMap)分支，且完全删掉了foreach ($this->prefixesPsr4相关逻辑，才算真正“权威”
容易被忽略的 classmap 实际代价
很多人以为 classmap = 快，其实它在生产环境可能拖慢请求：一个几 MB 的 autoload_classmap.php 每次请求都要全量反序列化（或 require），而实际单次请求用到的类通常不到总量的 5%。
- 确认项目是否真需要 classmap：检查
composer.json有没有显式"classmap": ["src/"]，没有就别强求 -
--classmap-authoritative的价值不在体积，而在跳过所有stat()系统调用——用strace -e trace=openat php -r "new \App\Http\Controllers\HomeController();"观察，openat 调用数应趋近于 0 - 若用了
"files"自动加载（如全局 helper），它们不会进 classmap，但会被单独require_once；只要 helper 里不动态 new 未声明类，就不会破防
APCu 和 opcache 配合才真正稳
光靠 classmap 权威模式还不够。PHP 层面的缓存才是最后一道加速器。
- 启用
opcache.enable=1和opcache.preload，preload 文件里只能写require，禁止任何运行时判断 - 加
--apcu-autoloader参数（Composer 2.1+ 支持），让 APCu 缓存 classmap 查找结果，减少内存读取开销 - 调试时务必关掉 CLI 下的 opcache（
opcache.enable_cli=0），否则缓存会掩盖 classmap 漏类问题
最常踩的坑不是命令写错，而是混淆了「构建时行为」和「运行时行为」：composer install 决定 autoload 结构，php-fpm 进程是否预热、opcache 是否加载、APCu 是否启用，才是决定最终速度的关键变量。少一个环节，前面所有优化都白做。
