应使用composer install --no-dev --optimize-autoloader，而非dump-autoload -o，因classmap仅在install/update时生成；需验证autoload_classmap.php内容规模、autoload_real.php中addClassMap调用及opcache缓存状态。
Composer自动加载慢，不是类太多，而是默认走 PSR-4 时每次都要拼路径、调 file_exists() 判断文件是否存在——尤其在没开 OPcache 或缓存未命中时，这个开销会被放大几十倍。真要提速，核心就两条：用 classmap 代替运行时查找，再让 OPcache 稳稳接住。
怎么确认 --classmap-authoritative 是否真正生效
别只看命令有没有报错，得查三处：
- 运行
composer dump-autoload --optimize --classmap-authoritative --no-dev后，检查vendor/composer/autoload_classmap.php是否存在且内容远超几十行（比如几千个类路径） - 打开
vendor/composer/autoload_real.php，搜索addClassMap—— 如果看到$loader->addClassMap($map)被调用，说明classmap已加载；如果只有setPsr4没有addClassMap，那优化根本没进去 - 线上部署后，用
php -d opcache.enable=1 -r "require 'vendor/autoload.php';"测试，并查opcache_get_status()['scripts']里有没有它 —— 若没出现，说明 OPcache 没缓存 autoload 文件，--classmap-authoritative白开了
composer.json 的 classmap 字段该写哪些目录
classmap 是预扫描生成的，目录越宽，生成越慢、文件越大、首次加载 I/O 压力越高。只加结构稳定、极少新增类的目录：
- 比如
app/exception/、app/contract/、common/（ThinkPHP 项目），或你自定义的统一接口/基类目录 - 绝对不要把
tests/、examples/、docs/塞进classmap或psr-4—— 它们会被扫进映射表，徒增体积，还可能在生产环境意外加载测试类 - ThinkPHP 的
app/默认不在classmap里，必须手动加；但加之前先确认你没在config/app.php的class_map里重复声明过相同类 —— 否则spl_autoload_register队列里会出现两套加载逻辑，浪费内存
为什么开了 --classmap-authoritative 还报 Class not found
这个参数的意思是：“classmap 里没有，就真没有，别 fallback 到 PSR-4 扫描”。所以报错基本等于配置漏了：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 新增类文件后忘了重新跑
composer dump-autoload --optimize --classmap-authoritative --no-dev——classmap还是旧的，自然找不到 - 类文件没按 PSR-4 规范命名或放错位置，又没被
classmap目录覆盖到（比如临时加了个app/utils/Helper.php，但app/utils/没进classmap） - 用了
"files"类型自动加载（如全局函数文件），它不进classmap，但也不受--classmap-authoritative影响 —— 这部分不会报错，但容易误以为“所有 autoload 都走 classmap” - 命名空间末尾缺反斜杠，例如
"App": "app/"应为"App\": "app/"，导致扫描器跳过整个目录
composer install --optimize-autoloader 和 dump-autoload -o 到底该用哪个
直接说结论：composer install --optimize-autoloader（或简写为 composer install -o）才是生产环境真正生效的命令；composer dump-autoload -o 在绝大多数项目里是无效的，它不会重建 vendor/composer/autoload_classmap.php，只是“假装优化”。
原因很简单：Composer 的 classmap 文件只在安装或更新依赖时生成（即触发 install 或 update），而 dump-autoload 默认只刷新 PSR-4 映射、重写 autoload_static.php 等轻量文件，不碰 classmap —— 除非你同时用了 --classmap-authoritative 或项目里明确定义了 "classmap" 配置。
CI/CD 中必须写死：composer install --no-dev --optimize-autoloader；别信 "optimize-autoloader": true 写在 composer.json 里就等于生效 —— 它只是个默认开关，不触发任何实际动作。
