结论：composer install --no-dev --optimize-autoloader 是单体应用生产部署的底线操作，但仅靠它远远不够；真正起效的前提是 autoload 配置本身干净、精准，且 classmap 不被无意义路径污染。因为 dump-autoload -o 默认不重建 autoload_classmap.php，仅刷新其他加载文件；只有 install/update 才触发完整扫描，而错误的 autoload 配置（如含 tests/、examples/）会膨胀 classmap，且未配 opcache 时优化无效。
直接说结论：composer install --no-dev --optimize-autoloader 是单体应用生产部署的底线操作，但仅靠它远远不够；真正起效的前提是 autoload 配置本身干净、精准，且 classmap 不被无意义路径污染。
为什么 composer dump-autoload -o 在单体项目里大概率白忙
单体应用（如 Laravel、Symfony 主干）通常依赖大量 PSR-4 包，但实际请求只用到其中 3%–10% 的类。而 dump-autoload -o 默认不重建 autoload_classmap.php —— 它只刷新 autoload_static.php 和 autoload_psr4.php，classmap 文件压根不动，除非你同时加 --classmap-authoritative 或项目里明确定义了 "classmap" 字段。
-
composer install -o才会强制触发 classmap 生成（因为 install/update 是唯一扫描 vendor 和 src 的时机） - 单体项目若在
composer.json里写了"tests/": ["tests/"]这类 autoload 条目，-o会把整个tests/目录下所有 PHP 文件塞进 classmap，徒增几 MB 数组体积 - Composer 2.x 已默认启用
autoload_static.php，它比 classmap 更轻量、更易被 opcache 缓存；盲目加-o反而让每次请求多 require 一个大数组
怎么写 autoload 配置才不算拖累性能
单体应用的 composer.json 里，autoload 块不是“能写就写”，而是要克制——每一条都得经得起追问：“这个路径下的类，是否真的会在运行时被自动加载？”
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 删掉
"docs/": ["docs/"]、"examples/": ["examples/"]这类条目：它们不会被加载，但会被-o扫入 classmap - PSR-4 前缀末尾必须带反斜杠：
"App\": "app/"✅，"App": "app/"❌（后者会导致命名空间匹配失败，classmap 漏类） - 避免宽泛前缀：
""（空字符串）映射到"legacy/"会递归扫描全部子目录；改用"Legacy\": "legacy/src/"精准控制 - 测试类必须放在
autoload-dev块里，且部署时务必用--no-dev，否则测试路径也会混进主 autoload 映射
--classmap-authoritative 能不能开？看这三点
这个参数不是“加速开关”，而是“信任开关”：它让 autoloader 彻底放弃 fallback 查找，类不在 classmap 里就直接报错。单体应用敢不敢开，取决于：
- 项目中有没有
"files"类型加载（比如全局函数文件）——有则不能开，files不进 classmap，开了就找不到函数 - 是否所有类都严格符合 PSR-4：命名空间大小写、目录结构、文件名与类名一致 —— Laravel 的
AppConsoleCommandsFooCommand必须对应app/Console/Commands/FooCommand.php，少一个Commands/目录或拼错大小写，classmap 就漏 - 有没有运行时动态注册的类（如 Laravel 的
AppServiceProvider::boot()里绑定的接口实现）——这类不对应物理文件，本就不该进 classmap，开了反而误伤
验证优化是否真生效，别只看命令有没有报错
执行完 composer install --no-dev --optimize-autoloader 后，光看命令成功没用，得确认三件事：
-
vendor/composer/autoload_classmap.php文件存在且非空（至少几百行） -
vendor/composer/autoload_real.php中出现$loader->addClassMap(...)调用（说明 classmap 被注入） - PHP opcache 已启用且未设
opcache.validate_timestamps=1（否则 autoload 文件每次都被重编译，classmap 再快也没用）
最容易被忽略的是第三点：classmap 优化和 opcache 是共生关系。没有 opcache，classmap 数组每次都要重新解析；有了 opcache 却没预热，前几次请求依然慢——这不是 Composer 的问题，是运行时环境没配平。
