Composer 不支持运行时按需加载，其 autoload_static.php 或 classmap 为静态映射；真正按需触发在 PHP 层（如 new、class_exists）；PSR-4 是唯一延迟加载机制，依赖命名空间与路径严格对应；classmap 反而可能拖慢冷启动，因需反序列化数 MB 数组；生产构建必须用 composer install --no-dev --optimize-autoloader --classmap-authoritative。
Composer 本身不支持运行时按需加载
很多人以为“按需加载”是 Composer 的功能，其实不是。Composer 只生成静态映射表（autoload_static.php 或 autoload_classmap.php），真正的“按需”发生在 PHP 层：只有 new、class_exists()（非 autoload = false 模式）、static::class 这类操作触发时，才查映射、加载文件。所以优化方向不是让 Composer “更懒”，而是让映射更准、查找更快、初始化更轻。
PSR-4 是唯一真正延迟加载的机制
它不预扫描、不生成全量 classmap，靠命名空间前缀 + 类名推导路径，比如 AppHttpControllersHomeController → app/Http/Controllers/HomeController.php。这个过程无额外开销，但必须满足三个硬条件：
-
composer.json中 PSR-4 映射末尾必须带反斜杠："App\": "app/"，写成"App": "app/"或"App": "app/"（转义错误）都会失效 - 目录结构必须严格对齐：若配置
"App\": "app/"，则AppConsoleCommandDeployCommand必须落在app/Console/Command/DeployCommand.php，不能多一层app/App/ - 多个 PSR-4 映射共存时，更具体的前缀（如
"AppConsole\": "app/Console/"）必须放在更宽泛的前缀（如"App\": "app/"）前面，否则会被提前截断
classmap 不等于快，反而可能是冷启动瓶颈
很多人误以为加了 --optimize-autoloader 就一定快，实际它会生成一个全量 autoload_classmap.php，体积常达 2–5 MB（尤其当 composer.json 错误包含 "tests/": ["tests/"] 或未加 --no-dev）。单次请求只用到其中不到 5% 的类，却要反序列化整个数组——相当于为查一个电话号码背整本黄页。
验证是否真用了 classmap：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 打开
vendor/composer/autoload_real.php，搜索findFile()方法：如果只剩if ($classMap = $this->classMap)分支，没有foreach ($this->prefixesPsr4循环，才算生效 - 执行
php -r "require 'vendor/autoload.php'; var_dump(class_exists('AppHttpControllersHomeController'));"，再临时删掉autoload_classmap.php：若仍返回true，说明 fallback 还在工作，--classmap-authoritative没起作用
生产构建必须用 install 而非 dump-autoload
composer dump-autoload -o 在 Composer 2.x + PHP 7.4+ 下基本无效：它不重建 autoload_classmap.php，只刷新 autoload_static.php 和 PSR-4 映射。而真正影响冷启动的是 classmap 文件，它只在 install 或 update 阶段生成。
正确构建流程（必须在 Dockerfile 或 CI 中执行）：
-
COPY composer.json composer.lock ./（顺序不能错，否则缓存失效） RUN composer install --no-dev --optimize-autoloader --classmap-authoritative --no-scripts --no-progress- 确保
opcache.enable=1且opcache.revalidate_freq=0，否则每次请求都检查 classmap 时间戳
漏掉 --no-dev 会让 phpunit、larastan 等测试类进 classmap；漏掉 --classmap-authoritative 会导致自动加载器仍走 PSR-4 fallback，冷启动卡在文件系统遍历上——这两个参数必须同时生效，缺一不可。
