dump-autoload -o 在大型项目中无效，因它不扫描源码、不读取classmap配置、不重建autoload_classmap.php，仅重写autoload_static.php和psr-4前缀表；真正触发全量classmap扫描的只有composer install/update配合--optimize-autoloader与--no-dev。
单独执行 composer dump-autoload -o 在大型单体应用里不仅不减损性能，反而大概率引入冷启动延迟、内存膨胀和 classmap 漏项——它根本不是优化命令，而是容易误导的“假刷新”操作。
为什么 dump-autoload -o 在大型项目里基本无效
这个命令在 Composer 2.x 中已被降级为轻量映射刷新：它不扫描源码、不读取 composer.json 中的 "classmap" 配置、也不重建 vendor/composer/autoload_classmap.php。你看到的“优化成功”，只是重写了 autoload_static.php 和 PSR-4 前缀表。
- 检查
vendor/composer/autoload_classmap.php：若为空、大小不到 100KB 或条目少于 200 行，说明没扫到业务类 - 新增了
app/Console/Commands/DeployCommand.php，但命名空间写成namespace AppConsoleCommands;（缺反斜杠），-o完全跳过该文件 - CI/CD 脚本里用
dump-autoload -o替代install，上线后报Class not found是常态，不是偶然
composer install --no-dev --optimize-autoloader 才是唯一可靠路径
真正触发全量 classmap 扫描、生成精简映射、并启用高效加载策略的，只有 install 或 update 阶段。其中 --optimize-autoloader 是开关，--no-dev 是硬性前提。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
--no-dev确保autoload-dev（如"Tests\": ["tests/"]）不参与扫描，避免 classmap 膨胀 30%+ 且污染生产路径 - 必须显式在
composer.json中声明"classmap": ["app/", "src/", "common/"]，否则 Composer 2.x 默认跳过 classmap 扫描逻辑 - 执行后验证：打开
vendor/composer/autoload_real.php，搜索addClassMap—— 若存在且被调用，说明 classmap 已生效
--classmap-authoritative 不是加速器，是断电开关
加了这个参数，Composer 就彻底放弃 fallback：查不到 classmap 就直接抛 Class not found，不再走 file_exists() + 路径拼接。但它只在 classmap 完整覆盖运行时所有类的前提下才安全。
- 漏项原因往往藏在细节里：
"App": "app/"应为"App\": "app/"（末尾反斜杠是 PSR-4 语法必需） - 同时声明了
"App\": "app/"（PSR-4）和"app/"（classmap）→ 同一类注册两次，ClassLoader::findFile()可能返回错误路径 - 若项目含
"files"类型 autoload（如全局 helper 函数），--classmap-authoritative对其无效，这类文件永远不进 classmap，但又必须被 require —— 容易引发Cannot redeclare
最常被忽略的点：classmap 是否覆盖全部运行时类，不取决于目录是否存在，而取决于命名空间与文件路径是否严格匹配、composer.json 中路径是否显式声明、以及是否排除了 dev 路径。任何一环松动，--classmap-authoritative 就从“提速”变成“炸服务”。
