psr-4 映射过宽（如"app": "src/"）会导致 autoload 扫描爆炸，应按组件精确映射命名空间；classmap 是唯一绕过目录扫描的方案，需显式声明路径、确保真实存在并重跑 dump-autoload；--classmap-authoritative 仅在生产环境启用，要求所有类均被收录；autoload-dev 必须隔离测试代码，用 exclude-from-classmap 排除 tests/ 等目录。
PSR-4 映射太宽泛会导致 autoload 扫描爆炸
“App”: “src/” 这类兜底映射是大型项目 autoload 卡顿的头号元凶。它让 Composer 每次加载一个类，都要递归遍历整个 src/ 目录树——哪怕里面混着 migrations/、config/、views/ 这些非 PHP 类文件。真实瓶颈不在类数量，而在扫描路径长度和无效文件干扰。
必须把映射收窄到具体命名空间路径：
- ❌ 错误写法：
"App": "src/" - ✅ 正确写法：
"MyApp\Auth\": "components/auth/src/"、"MyApp\Payment\": "components/payment/src/" - 新增组件时，同步在
composer.json的autoload块里加新条目，不复用父级路径 - 所有组件包的
autoload必须只声明自身命名空间，禁止出现"App": "..."或"app": "..."这类跨包引用
classmap 是唯一能绕过目录扫描的方案
composer dump-autoload -o 本身不提速，它只是扁平化已有映射；真正压降检索开销，得靠 classmap 显式收录类文件路径。但这个机制极易失效——因为它是静态快照，不自动感知新增文件，也不校验路径真实性。
要让它生效，三件事缺一不可：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 在
composer.json的autoload块中明确写入："classmap": ["components/auth/src/", "app/Exceptions/"]（注意末尾带/表示递归） - 确保路径真实存在，
composer dump-autoload只 warning 不报错，路径错就等于没扫 - 新增类后必须重跑：
composer dump-autoload --classmap-authoritative --apcu - 用
grep -n "SomeClass" vendor/composer/autoload_classmap.php确认类是否真被收录
--classmap-authoritative 不是开关，是校验锁
启用 --classmap-authoritative 后，autoloader 彻底跳过 file_exists() 和 PSR-4 拼接逻辑，查不到就直接报 Class not found——这不是 bug，是它在告诉你：类名拼错了、命名空间少反斜杠、或文件放错目录了。
它只应在生产环境启用，且前提是：
- 所有运行时需要的类都进了
autoload_classmap.php（包括第三方包里的类，需靠composer install --no-dev --optimize-autoloader --classmap-authoritative完整重建） - 开发环境禁用，否则
php artisan tinker或测试类因未进 classmap 会崩 - 验证是否生效：
php -r "var_dump(composerAutoloadClassLoader::getRegisteredLoaders());"，看输出中是否有'classMapAuthoritative' => true
autoload-dev 的排除策略常被忽略
测试类、命令行工具、Mock 类如果混进生产 autoload，不仅拖慢加载，还可能引发运行时冲突。最易被忽略的是：这些代码默认仍会被 composer install --no-dev 扫描（只要它们在 autoload 而非 autoload-dev 块里）。
正确做法是物理隔离：
- 把测试专用代码统一放在
tests/或Tests/目录下 - 在
composer.json中用"exclude-from-classmap": ["tests/", "Tests/"]显式排除 - 确认
autoload-dev块里只声明开发期才需加载的路径，如"MyApp\Tests\": "tests/" - CI 流水线中强制使用：
composer install --no-dev --optimize-autoloader --classmap-authoritative
classmap 收录的组件子目录。
