autoload阶段慢首要排查xdebug：其develop模式注入调试钩子会使加载耗时翻数倍，应先用php -d xdebug.mode=off测试基准耗时；classmap未生效因dump-autoload --optimize仅生成映射但保留psr-4 fallback，需配合--classmap-authoritative和composer install --no-dev --optimize-autoloader才能强制查表。
autoload 阶段慢？先确认是不是 Xdebug 在拖后腿
PHP 项目启动变慢、require 'vendor/autoload.php' 耗时明显升高，第一反应不该是改 Composer 配置，而是查 Xdebug 是否开着。Xdebug 3.3 默认启用 develop 模式时，即使没连 IDE，也会注入大量调试钩子，让自动加载耗时翻几倍甚至十几倍。
验证方式很简单：
- 运行 php -m | grep xdebug 看是否加载
- 再用 php -d xdebug.mode=off -r "require 'vendor/autoload.php';" 测真实开销
- 对比开启/关闭 Xdebug 的 time php -r "require 'vendor/autoload.php';" 结果
如果关掉 Xdebug 后耗时从 1200ms 降到 180ms，那后续所有优化都白做——先统一关掉再排查。
classmap 没生成？dump-autoload --optimize 不等于生效
composer dump-autoload --optimize 只是生成 vendor/composer/autoload_classmap.php，但 PHP 运行时是否真用它，取决于 vendor/autoload.php 加载的到底是哪套逻辑。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
关键点在于：
- --optimize 生成 classmap，但保留 PSR-4 fallback 查找（即找不到类仍会遍历目录）
- --classmap-authoritative 才真正禁用 fallback，强制只走 classmap
- 两者都需配合 "optimize-autoloader": true 写进 composer.json，否则 install/update 时不会自动启用
常见翻车场景：
- 本地跑 dump-autoload --optimize，但 CI 里只跑 install，没设 optimize-autoloader → classmap 白生成
- tests/ 目录没写进 autoload-dev，却用了 --classmap-authoritative → Class not found
火焰图怎么抓 autoload 瓶颈？别直接跑整个应用
想用 flamegraph 看自动加载耗时，不能直接对 php artisan serve 或 php index.php 录制——HTTP Server 启动过程混杂了路由、中间件、DB 连接等干扰项，autoload 占比被稀释。
正确做法是隔离最小执行单元：
- 写个极简脚本：php -d opcache.enable_cli=0 -d memory_limit=-1 -r "require 'vendor/autoload.php'; echo 'OK';"
- 用 sudo flamegraph -o autoload.svg -- php ...（Linux/macOS）
- 或 cargo flamegraph --bin your-app -- -r "require 'vendor/autoload.php';"（Rust + PHP FFI 场景）
火焰图里重点关注：
- 底部宽大的 spl_autoload_call 或 ComposerAutoloadClassLoader::loadClass 区域
- 如果看到大量 file_exists、is_dir、scandir 堆在顶部，说明 fallback 查找正在高频触发
- 若 autoload_classmap.php 被频繁读取但函数调用栈浅，说明 classmap 生效且高效
autoload_classmap.php 里缺类？不是路径问题就是扫描漏了
启用了 --classmap-authoritative 却报 Class not found，别急着删 vendor 重装。先打开 vendor/composer/autoload_classmap.php，搜索报错的类名。
如果搜不到，原因通常是：
- 类文件在 symlink 目录里，Composer 默认跳过符号链接（除非加 --ignore-platform-reqs 或改配置）
- autoload 或 autoload-dev 中声明的路径末尾少了 /，比如写成 "App\": "src" 而非 "App\": "src/" → Composer 不认这是目录
- 类文件扩展名不是 .php（比如用了 .php.inc），而 classmap 扫描只认标准扩展名
- 文件权限为 000 或属主不匹配，file_get_contents 失败导致跳过扫描
临时验证：手动往 autoload_classmap.php 里加一行 'Your\Class' => __DIR__ . '/../src/Your/Class.php',，再试 require —— 如果 OK，问题就锁定在扫描逻辑上。
