dump-autoload -o 在多数项目中无效，因其默认不重建 autoload_classmap.php，仅刷新 PSR-4 映射和 autoload_static.php；真正生效需显式配置 classmap 或 files，否则在纯 PSR-4 项目中仅导致 classmap 膨胀却无实际加速。
Composer 的 “Optimizer” 不是一个独立组件，而是 composer install 或 composer dump-autoload 命令在传入 --optimize-autoloader（或 -o）时触发的一组生成行为——它不运行时优化，只预生成映射表。
— 为什么 dump-autoload -o 在多数项目里没效果？
因为 -o 默认不重建 vendor/composer/autoload_classmap.php，只刷新 PSR-4 映射和 autoload_static.php。它真正起作用的前提是：
- 项目中显式配置了
"classmap": ["src/"]，或 - 用了
"files"autoload 方式（如全局 helper 文件）
纯 PSR-4 项目（Laravel、Symfony 等）仅靠 "psr-4" 配置时，dump-autoload -o 实际只是把命名空间路径“硬编码”进 classmap 文件，但不会改变运行时查找逻辑；反而让 autoload_classmap.php 膨胀到几 MB，每次请求都得完整加载该数组，而真实用到的类通常不到 5%。
— install --optimize-autoloader 和 dump-autoload -o 的本质区别
前者是完整构建流程，后者只是轻量重写 autoload 文件：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
composer install --optimize-autoloader --no-dev：读取composer.lock，安装包，扫描所有启用的 autoload 配置（psr-4、classmap、files），并确保生成的 classmap 被vendor/autoload.php正确引用 -
composer dump-autoload -o：不触碰vendor/目录结构，不校验命名空间与路径是否匹配，也不感知新增类文件——改了类名或移动了文件后，它不会自动重扫
CI/CD 构建阶段若只跑 dump-autoload -o，但没装新包，那新依赖里的类根本不会进 classmap。
— 怎么确认 classmap 是否真正生成并生效？
不能只看命令是否执行成功，要查三处：
- 运行后检查
vendor/composer/autoload_classmap.php是否存在且非空（体积达几 MB 是正常量级） - 打开
vendor/composer/autoload_real.php，搜索addClassMap—— 如果看到$loader->addClassMap($map)被调用，说明 classmap 已加载；如果只有setPsr4没有addClassMap，那优化根本没进去 - 线上部署后，用
php -d opcache.enable=1 -r "require 'vendor/autoload.php';"测试，并查opcache_get_status()['scripts']里有没有它 —— 若没出现，说明 OPcache 没缓存 autoload 文件，--classmap-authoritative白开了
— --classmap-authoritative 是什么，为什么它容易出错？
它不是“加速开关”，而是“加载策略开关”：告诉 autoloader “classmap 里没有，就真没有，别 fallback 到 PSR-4 扫描”。所以报 Class not found 基本等于配置漏了：
- 新增类文件后忘了重新跑
composer dump-autoload --optimize --classmap-authoritative --no-dev - 类文件没按 PSR-4 规范命名或放错位置，又没被
classmap目录覆盖（比如临时加了个app/utils/Helper.php，但app/utils/没进composer.json的classmap字段） - 用了
"files"类型 autoload（如全局函数），这类文件不会进入 classmap，必须保留在"files"数组中，且不能依赖--classmap-authoritative
这个参数对动态类加载（如 Laravel Facade 的运行时存在性检测、插件机制）非常敏感——一旦 classmap 漏掉某个类，class_exists() 就会返回 false，而不是继续 fallback 查找。
