new一个类卡住数百毫秒，主因是Composer自动加载器首次运行时递归解析autoload规则并构建映射表；可通过composer dump-autoload --optimize-autoloader --classmap-authoritative强制生成扁平化classmap并禁用运行时查找。
为什么 new 一个类会卡住几百毫秒？
不是代码慢，是 Composer 自动加载器在递归解析依赖链时反复调用 class_exists() 或触发大量 require_once，尤其当包含数百个 autoload 规则、嵌套的 psr-4 和 classmap 混用时，PHP 需要逐层查找文件路径。典型现象：首次实例化某个服务类（如 Doctrine\ORM\EntityManager）时耗时突增，后续调用恢复正常。
关键瓶颈不在你的类本身，而在 Composer 的 ClassLoader 初始化阶段——它会在第一次 autoload 请求时构建完整映射表，而这个过程会扫描所有已注册的 vendor/composer/autoload_*.php 文件并合并规则。
如何跳过运行时 autoload 映射构建？
强制 Composer 在安装/更新阶段生成扁平化、可直接加载的 classmap，避免运行时解析：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 执行
composer dump-autoload --optimize-autoloader --classmap-authoritative（注意两个参数必须同时启用） -
--optimize-autoloader将 PSR-4/PSR-0 路径转为 classmap；--classmap-authoritative告诉 autoloader：“没在 classmap 里的类，一律不存在”，从而跳过文件系统扫描 - 确保
composer.json中没有动态修改 autoload 的逻辑（例如运行时addClassMap()），否则 classmap 权威模式会失效 - 上线前务必验证：删掉
vendor/autoload.php后重新composer install --no-dev --optimize-autoloader --classmap-authoritative，再测实例化延迟
哪些依赖包会让 classmap 优化失效？
以下情况会导致 Composer 无法完全扁平化 autoload，仍需运行时查找：
- 使用
files类型 autoload 的包（如monolog/monolog的src/functions.php），这类文件不会进入 classmap，每次加载都 require - 包内含
autoload-dev且被误引入生产环境（例如测试工具类被实际代码引用），dev autoload 不参与--optimize-autoloader - 第三方包声明了
autoload.psr-4但目录结构不规范（如命名空间与路径大小写不一致），Composer 无法静态推导，回退到动态匹配 - 项目中手动调用
spl_autoload_register()并混用其他 loader，会绕过 Composer 主 loader 的优化路径
实例化延迟还可能来自哪里？
别只盯着 autoload——复杂依赖树常触发连锁副作用：
- 构造函数里隐式 new 了其他类（比如
__construct()中调用new HttpClient()），而那个类又依赖更多服务，形成“实例化雪崩” - 依赖注入容器（如 Symfony DI 或 Laravel IoC）在 resolve 时执行大量反射操作，特别是带大量
@required属性或未预编译的代理类 -
composer.lock中存在循环 require（可通过composer depends --tree vendor/package-name检查），导致 autoloader 反复重入 - OPcache 未启用或未预热：即使 classmap 已优化，若 PHP 没缓存 opcode，仍要重复解析文件头和语法树
真正棘手的是 autoload 优化 + DI 容器预编译 + OPcache 预热三者没对齐——少一个，前面做的都白搭。
