生产环境必须用composer install --no-dev --optimize-autoloader --classmap-authoritative --no-interaction，缺一不可：--no-dev排除开发依赖，--optimize-autoloader生成静态类映射，--classmap-authoritative强制仅查classmap提速，--no-interaction避免ci/cd卡住。
composer install --optimize-autoloader 是唯一真正生效的命令
想让第三方依赖包（比如 monolog/monolog、symfony/http-foundation）的类走 classmap 加载，必须在安装时生成映射——不是之后补救。运行 composer dump-autoload -o 不会把已安装包里的类写进 vendor/composer/autoload_classmap.php，它只处理你项目源码里声明的 PSR-4 路径，对 vendor 中的包无效。
正确做法只有这一种：
-
composer install --no-dev --optimize-autoloader（推荐用于部署） -
composer update --no-dev --optimize-autoloader（更新依赖时同步优化） - 若本地开发中临时验证，可加
--prefer-dist加速下载
验证是否成功：打开 vendor/composer/autoload_classmap.php，搜索一个第三方类名（如 "Monolog\Logger"），确认有对应路径；再看 vendor/composer/autoload_real.php 里是否调用了 $loader->addClassMap()。
第三方包的 classmap 生成依赖其自身 composer.json 配置
不是所有第三方包都能被塞进 classmap。Composer 只会扫描满足以下任一条件的包：
- 包的
composer.json中显式定义了"classmap"字段（如"classmap": ["src/", "lib/"]） - 包使用 PSR-0/PSR-4 声明了 autoload，并且文件结构规范（如
src/Class.php对应NamespaceClass） - 包根目录下存在无命名空间的 PHP 文件（如
functions.php），且未被"files"显式加载
像 laravel/framework 或 symfony/* 这类主流包基本都符合 PSR-4 规范，启用 --optimize-autoloader 后它们的类会被收录；但某些老旧包或纯函数库（如 ramsey/uuid 的早期版本）可能漏掉部分文件，需手动检查 autoload_classmap.php 内容。
开了 --optimize-autoloader 却报 Class not found？先查 dev 包和路径声明
常见错误不是优化本身出问题，而是环境或配置不匹配：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 忘了加
--no-dev：dev 包（如phpunit/phpunit）默认不进 classmap，但如果你没排除它们，autoload_classmap.php里就不会有这些类，而代码又引用了，就直接报错 - 第三方包用了
"files"加载全局函数（如symfony/polyfill-mbstring），这类条目不会出现在 classmap 中——但函数仍能用，只是别误以为“优化没生效” - 包内路径与命名空间不一致（比如
src/Helper.php里写了namespace MyLib;，但 composer.json 的 PSR-4 前缀是"MyLib\": "lib/"），导致扫描失败，classmap 空白
这类问题无法靠重跑 dump-autoload 解决，必须删掉 vendor/ 重装，或手动修正包的 autoload 配置（不推荐）。
classmap-authoritative 对第三方包的影响最直接也最危险
加 --classmap-authoritative（或 -a）会让 Composer 彻底禁用 fallback 查找：类不在 autoload_classmap.php 里，就直接抛 Class not found，连 PSR-4 拼路径都不试。
这意味着：
- 所有第三方包必须 100% 被 classmap 覆盖，不能依赖运行时扫描
- 某些动态行为会失效：比如 Laravel 的
App::bind()绑定的匿名类、Swoole 中 require 的临时类文件，都不在 classmap 里 - 一旦某第三方包升级后改了 autoload 配置（比如从 PSR-4 改成
files），部署立刻崩
所以生产环境开 -a 前，务必确认 autoload_classmap.php 包含你实际用到的所有第三方类——别只信文档，要 grep。
真正容易被忽略的是：classmap 优化效果高度依赖 opcache。即使 autoload_classmap.php 生成正确，如果 PHP 的 opcache.enable=0 或 opcache.validate_timestamps=1，每次请求仍要重新解析那个大数组。优化不是单点动作，是安装命令、autoload 配置、PHP 运行时三者咬合的结果。
