真正生效的classmap优化必须执行composer install --no-dev --optimize-autoloader --classmap-authoritative，并显式配置"classmap": ["app/exceptions/", "app/contracts/", "common/"]等稳定路径；仅dump-autoload -o不扫描源码、不生成类路径，无法触发classmap重建。
中文镜像不影响classmap生成，别被下载快误导
换阿里云或腾讯云镜像后composer install变快，不代表自动加载变快。镜像只加速包下载，autoload_classmap.php是否生成、内容是否完整，完全取决于你执行的命令和composer.json配置，跟用哪个镜像无关。
常见误判：看到install耗时从 90s 缩到 30s，就以为 autoload 也优化了——其实只是 ZIP 下得快，classmap 还是空的，运行时照样每类都file_exists()扫一遍。
- 验证方式：检查
vendor/composer/autoload_classmap.php是否存在且含数千行（比如搜索App\Http\Controllers能命中） - 镜像同步延迟可能让 vendor 中包版本旧，导致新类名没被扫进 classmap，开了
--classmap-authoritative直接报错 - 真实耗时必须用
time包住整条链：rm -rf vendor composer.lock && composer clear-cache && time php -d memory_limit=2G composer install --no-dev --prefer-dist --optimize-autoloader --classmap-authoritative
必须用 install -o，dump-autoload -o 基本无效
composer dump-autoload -o在 Composer 2.9.6+ 环境下不重建autoload_classmap.php，它只刷新autoload_static.php和 PSR-4 映射表。真正生成 classmap 的唯一时机是install或update阶段。
执行dump-autoload -o后发现autoload_classmap.php体积仍是 0KB 或几十行，说明根本没扫到类——这不是命令写错了，是它本来就不干这事。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 正确做法：CI/CD 中固定写
composer install --no-dev --optimize-autoloader --classmap-authoritative -
"optimize-autoloader": true写在composer.json里不会自动触发任何动作，纯属摆设 - 漏掉
--no-dev会导致phpunit、mockery等测试类全进 classmap，文件体积暴涨至 2–5 MB，PHP-FPM 每次请求反序列化整个数组，冷启动反而更慢
classmap 要手动配路径，不是“开了-o就自动全扫”
即使加了--optimize-autoloader，如果composer.json里autoload.classmap字段为空或路径不存在，生成的 classmap 仍是空的。Composer 不会默认扫src/或app/，必须显式声明。
路径末尾必须带/表示递归扫描；写成"src"而非"src/"，结果就是 warning 不报错、但啥也没扫到。
- 合理范围示例：
"classmap": ["app/Exceptions/", "app/Contracts/", "common/"]——只选结构稳定、极少新增类的目录 - 绝对不要加
tests/、examples/、docs/，它们会被扫进 classmap，徒增体积还污染生产环境 - ThinkPHP 的
app/默认不在 classmap，需手动加；但加之前确认config/app.php里没重复声明相同类，否则spl_autoload_register队列里出现两套加载逻辑
开了 --classmap-authoritative 却 Class not found？查这三处
--classmap-authoritative不是“更快的 autoload”，而是“更严格的 autoload”：查不到类就直接抛错，不 fallback 到 PSR-4 拼路径。报错不是 bug，是它在告诉你 classmap 漏了类。
典型漏扫场景：新增app/Console/Commands/DeployCommand.php，但命名空间写成namespace AppConsoleCommands;（缺反斜杠），composer.json里 PSR-4 前缀是"App\": "app/"，扫描失败，classmap 里自然没有它。
- 验证是否生效：打开
vendor/composer/autoload_real.php，搜索addClassMap——没调用说明 classmap 根本没注册 - 再搜
findFile：只剩if ($classMap = $this->classMap)分支，无任何foreach循环，才算权威模式落地 -
files类型加载的全局函数（如"files": ["app/Helpers/functions.php"]）不会进 classmap，但开了-a后仍能加载；Laravel 中AppServiceProvider::boot()动态绑定的类也不在 classmap 中，跟-a无关
install流程——CI/CD 容易漏掉这步，导致线上 classmap 是旧的，开了--classmap-authoritative就崩。
