Composer 不支持运行时按需映射，真正的按需加载由 PHP 层触发；PSR-4 是唯一真正按需的加载方式，依赖命名空间前缀与类名推导路径；生产环境必须用 composer install --no-dev --optimize-autoloader（可选 --classmap-authoritative）以优化冷启动性能。
Composer 本身不支持运行时按需映射——它只生成静态映射表，真正的“按需”发生在 PHP 层：只有 new、static::class、class_exists()（非 autoload = false 模式）等触发时，才查映射、加载文件。优化方向不是让 Composer “更懒”，而是让映射更准、查找更快、初始化更轻。
PSR-4 是唯一真正按需的加载方式
PSR-4 不预扫描文件，也不生成全量 classmap；它靠命名空间前缀 + 类名推导路径，比如 AppControllerHomeController → app/Controllers/HomeController.php。这个过程是延迟的、无额外开销的。
- 必须确保
composer.json中 PSR-4 配置末尾带反斜杠："App\": "app/"，否则映射失效（JSON 中写"App\"或"App"均可，但漏掉会彻底找不到类） - 目录结构必须严格对齐：若写
"App\": "app/"，则AppConsoleCommandDeployCommand必须落在app/Console/Command/DeployCommand.php，不能多一层app/App/... - 避免宽泛前缀覆盖具体前缀：多个 PSR-4 映射共存时，把更具体的（如
"AppConsole\": "app/Console/"）放在更前面，否则会被"App\": "app/"提前截断匹配
composer install --optimize-autoloader 才是生产部署的正确命令
composer dump-autoload -o 在 Composer 2.x + PHP 7.4+ 环境下基本无效，它不会重建 vendor/composer/autoload_classmap.php，只刷新 autoload_static.php 和 PSR-4 映射。而 classmap 文件才是影响冷启动的关键——它体积大、require 开销高，且只在 install 或 update 时生成。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 生产环境必须用：
composer install --no-dev --optimize-autoloader，它会扫描所有启用的 autoload 配置（包括 PSR-4 目录），生成紧凑的autoload_static.php（Composer 2 默认格式），适配 OPcache - 加
--classmap-authoritative后，自动加载器会跳过所有 fallback 查找逻辑（如遍历 PSR-4 前缀拼路径），只查 classmap；一旦报Class not found，说明 classmap 漏了类，不是配置错，是生成没覆盖到 - 验证是否生效：打开
vendor/composer/autoload_real.php，检查findFile()方法是否只剩一个if ($classMap = $this->classMap)分支，没有foreach循环
classmap 越大越慢，不是越快
很多人误以为 classmap = 快，实际它常是冷启动瓶颈。如果 autoload_classmap.php 达几 MB（常见于误把 tests/、docs/、examples/ 加进 "classmap" 或 PSR-4 映射），每次请求都要全量 require 进内存，而单次请求通常只用到其中不到 5% 的类。
- 精简 PSR-4 映射：不要写
"App\": "app/"，改用更具体的"App\Controller\": "app/Controllers/"、"App\Model\": "app/Models/"，缩小扫描范围 - 非核心逻辑（如 CLI 命令、导出组件）拆成独立包，用
suggest而非require，避免其 autoload 规则污染主项目 - 禁用
"files"加载方式：它会在项目启动时一次性 require 所有指定文件，无法按需，且其中 new 出来的类极易漏进 classmap
最易被忽略的一点：冷启动慢的主因往往不是类加载本身，而是 vendor/autoload.php 加载时反复调用 stat() 和 file_exists()。这只有在 --optimize-autoloader 生效、--classmap-authoritative 开启、且 --no-dev 严格过滤后，才能彻底规避。本地跑通不等于线上安全——CI/CD 流水线里必须固化这条命令，而不是依赖开发者手动 dump-autoload。
