--classmap-authoritative 能提速的前提是所有类已完整扫入 autoload_classmap.php，否则因无 fallback 机制直接报错；它不加速扫描，而是彻底禁用 PSR-4 目录查找，仅依赖 classmap 查表。
加 --classmap-authoritative 确实能提速，但不是“一加就快”，而是「快的前提是你已经把所有类都扫进 classmap 了」；漏一个，运行时直接 Fatal error: Class not found。
为什么 --classmap-authoritative 有时没提速？
它不加速扫描，它直接砍掉扫描——只查 vendor/composer/autoload_classmap.php。但如果这个文件里缺类，Composer 就不会 fallback 到 PSR-4 目录去找，而是立刻报错。所以线上没提速，大概率是 classmap 没覆盖全，autoloader 实际退回到了普通模式（你根本没真正启用它）。
- 检查
vendor/autoload.php是否含'classmap-authoritative' => true - 打开
vendor/composer/autoload_real.php，搜findFile方法：如果只剩if ($classMap = $this->classMap)分支，且没有$this->prefixesPsr4或$this->fallbackDirsPsr4相关逻辑，才算真生效 - 用
grep -c "MyClass" vendor/composer/autoload_classmap.php确认关键类名存在（注意大小写和命名空间斜杠）
composer dump-autoload --classmap-authoritative 必须搭配的参数
单独加 --classmap-authoritative 是无效的——它只是开关，不生成 classmap。必须和 -o（或 --optimize）一起用，否则 autoload_classmap.php 为空或极简，根本撑不起权威模式。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 正确命令：
composer dump-autoload -o --classmap-authoritative --no-dev -
--no-dev很关键：dev 依赖的 autoload 配置（如 tests/ 目录）若残留，可能触发 fallback，破坏权威性 - 不要用
composer install --classmap-authoritative：该参数对install无意义，只对dump-autoload生效
哪些类容易被漏进 classmap？
classmap 只扫 composer.json 中明确声明的 autoload 路径，且默认跳过空目录、隐藏文件、非 .php 后缀文件。常见漏点：
- 放在
tests/或examples/下的类，除非你在autoload里显式加了对应路径 - 通过
"files": ["src/helpers.php"]加载的全局函数文件：它们会被require_once，但里面new的类若不在 classmap 中，仍会失败 - 运行时生成的类（如 Laravel 的
_ide_helper.php、Doctrine Proxy 类），除非你手动把它加进autoload.files并确保它被dump-autoload -o扫到 - 第三方包里用了
classmap映射但路径写错（比如写成vendor/mylib/src而不是mylib/src）
Docker 和 CI/CD 里最容易错的三件事
部署环境跟本地开发环境不一致，是 Class not found 最高发场景。
- Dockerfile 里写
RUN composer install --classmap-authoritative：语法合法但完全无效，应改为RUN composer install --optimize-autoloader && composer dump-autoload -o --classmap-authoritative --no-dev - CI 构建时用了缓存的
vendor/，但没清autoload_classmap.php，导致旧 classmap 被复用 - 本地开发启用了
--classmap-authoritative，改完类忘了dump-autoload，结果提交后 CI 构建失败——这选项只该出现在部署流程，不该进开发日常
真正启用 --classmap-authoritative 后，性能提升来自减少 stat() 和目录遍历，但前提是 classmap 文件本身别太大；超过 5MB 可能拖慢 opcache 加载，这时得考虑拆包或精简 autoload 范围。
