开启--classmap-authoritative必须与--optimize-autoloader、--no-dev协同生效，否则因classmap不全导致class not found；单独-dump-autoload -o仅扁平化psr-4映射，不关闭fallback查找。
开启 --classmap-authoritative 能提效，但不是加个参数就生效——它必须和 --optimize-autoloader、--no-dev 协同工作，且 classmap 表本身得完整覆盖所有生产用类，否则直接报 Class not found。
为什么只跑 composer dump-autoload -o 没用？
Composer 2.0+ 中，-o（即 --optimize-autoloader）本身不启用权威模式，它只是把 PSR-4 映射“扁平化”进 autoload_classmap.php，但仍保留 fallback 查找逻辑。真正关闭动态扫描的是 --classmap-authoritative，但它单独运行会失败：没有 --optimize-autoloader，autoload_classmap.php 就是空的或极小，权威模式等于查一张白表。
- 执行
composer dump-autoload -o后，打开vendor/composer/autoload_real.php，如果findFile()方法里仍有foreach ($this->prefixesPsr4循环，说明没生效 - 错误现象：线上报错堆栈指向某个类找不到，但该类明明在
src/下且命名空间正确——大概率是 classmap 漏了它，而权威模式又禁止 fallback - 正确命令是：
composer dump-autoload --classmap-authoritative --optimize-autoloader --no-dev
classmap 表怎么才算“完整覆盖”？
classmap 不是靠猜，是靠扫描结果说话。它只收录你明确配置的路径下真实存在的 .php 文件中声明的类、接口、trait，且不解析命名空间语义——只认 class XXX 这种字面声明。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 确认
composer.json的"autoload"块里写了"classmap": ["src/", "lib/"]——路径必须存在，末尾斜杠表示递归扫描；写成"src"（无斜杠）会被当作文本忽略 - 新增类文件后，必须重新运行
dump-autoload，否则不会进表；删了类也不自动清理，旧映射仍留着 - 检查生成的
vendor/composer/autoload_classmap.php是否非空，并搜索你的类名，确认键值对存在，例如：'App\Helper' => $baseDir . '/src/Helper.php' - 避免误扫：不要把
tests/、examples/、docs/加进 classmap，它们会让映射表膨胀数 MB，反而拖慢冷启动
哪些情况会悄悄破坏权威模式？
即使命令跑对、表也生成了，代码里几个常见操作也会让 autoloader 退化回 fallback 模式，完全浪费优化效果。
- 调用了
ClassLoader::addPsr4()或addClassMap()动态注册——权威模式只信任静态生成的autoload_classmap.php，任何运行时追加都无效 - 用了
"files"类型自动加载（如"files": ["src/helpers.php"]）：这类文件会被require_once，但里面new出来的类若不在 classmap 中，就会触发 fallback - 框架启动时 patch 了加载器，比如 Laravel 的
IlluminateFoundationBootstrapLoadConfiguration可能重置$classMap；需检查bootstrap/autoload.php或服务提供者中是否有类似操作 - CI/CD 构建时用了
composer install，但没传--no-dev：dev 依赖的 autoload 规则残留，会导致 fallback 触发，权威性失效
真正难的不是加参数，而是确保整个链路干净：配置路径准确、扫描动作执行、生成文件有效、运行时不被干扰。漏掉任意一环，线上就可能静默降级，性能没提升，还多了一层排查难度。
