生产环境必须用 composer install --no-dev --optimize-autoloader，因其完整构建 classmap 并跳过 dev 类；dump-autoload -o 仅轻量重写 autoload 文件，不重建 classmap、不校验路径，且在标准 PSR-4 项目中几乎无效。
生产环境必须用 composer install --no-dev --optimize-autoloader，而不是 composer dump-autoload -o；后者在 Composer 2.x + PHP 7.4+ 下基本无效，甚至拖慢冷启动。
为什么 dump-autoload -o 在多数项目里不生效
它默认不重建 vendor/composer/autoload_classmap.php，只刷新 PSR-4 映射和 autoload_static.php。只有项目中显式配置了 "classmap": ["src/"] 或使用了 "files" 加载方式时，-o 才会真正触发 classmap 重建。
标准 PSR-4 项目（如 Laravel、Symfony）仅靠 "psr-4" 配置，dump-autoload -o 实际只是把路径“硬编码”进 classmap 文件，不解决运行时查找逻辑，反而让 autoload_classmap.php 膨胀到几 MB —— 每次请求都要完整加载该数组，而真实调用的类通常不到 5%。
- 检查
vendor/composer/autoload_classmap.php是否存在且非空：若文件体积小或为空，说明没生成成功 - 确认是否误将
tests/、docs/等目录写进了autoload.psr-4或autoload.classmap，导致扫描冗余 - CI/CD 构建阶段若只跑
dump-autoload -o，但没装新包，那新依赖里的类根本不会进 classmap
install --optimize-autoloader 和 dump-autoload -o 的本质区别
前者是完整构建流程：读取 composer.lock，安装包，扫描所有启用的 autoload 配置（psr-4、classmap、files），并确保生成的 classmap 被 vendor/autoload.php 正确引用；后者只是轻量重写 autoload 文件，不触碰 vendor 目录结构，也不校验命名空间与路径是否匹配。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（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会跳过autoload-dev块，避免测试类污染生产 classmap -
composer dump-autoload -o不感知新增类文件 —— 改了类名或移动了文件后，它不会自动重扫，得手动删掉autoload_classmap.php再执行 - 某些插件（如 Drupal 模块管理器）依赖 runtime classmap 补充机制，开了
--classmap-authoritative后直接失效，这不是 bug，是设计约束
开启 --classmap-authoritative 后报 Class not found 怎么办
这不是配置错了，是 classmap 漏了类 —— 它强制关闭 fallback 查找，查不到就直接抛错，不拼路径、不 file_exists()、不遍历目录。
- 检查
composer.json中autoload.psr-4的命名空间末尾是否有反斜杠："App\": "app/"是对的，"App": "app/"会扫描失败 - 确认没用
"files"类型加载全局函数（如"app/Helpers/functions.php"）—— 这类文件不会进 classmap，开了 authoritative 后仍能加载，但容易误判为“优化失效” - Laravel 的
Route::get()闭包、Symfony 的config/services.php中匿名类等运行时注册内容，本身不对应物理类文件，自然不在 classmap 中 - OPcache 启用前提下，
autoload_static.php已被高效缓存；而 classmap 数组因结构动态，难以被 OPcache 充分优化
真正影响性能的关键点在 composer.json 配置本身
autoload 性能瓶颈往往藏在 autoload 规则写法里，而不是要不要加参数。
- 删掉无用 autoload 条目：
"docs/": ["docs/"]、"tests/": ["tests/"]这类会让 classmap 白扫几百个文件 - 避免命名空间前缀过宽，例如
""（空字符串）作为前缀会递归扫描整个目录，应改用"Legacy\": "legacy/src/"等精准映射 - 确认没有重复注册同一命名空间：比如
"App\": "app/"同时出现在psr-4和classmap中，Composer 会叠加处理，增加匹配耗时 - 测试类必须严格放在
autoload-dev块里，且部署时用--no-dev，否则上线后多加载一堆不用的类，还可能意外触发初始化逻辑
classmap 不是银弹，它把“查找成本”转嫁成了“内存加载+解析开销”，而现代 PHP（8.0+）+ OPcache 下，这个权衡越来越不划算。最常被忽略的复杂点是：你优化的不是“加载速度”，而是“可预测性”——一旦开了 --classmap-authoritative，任何路径/命名空间不一致都会立刻暴露，但错误信息不指向真实原因（比如拼写错误），而是直接 Class not found。
