composer 不支持传统按需加载，真正影响启动速度的是文件扫描、fallback 和重复解析；应使用 composer install --optimize-autoloader --classmap-authoritative --no-dev 而非 dump-autoload -o，并严格规范命名空间与路径映射。
Composer 本身不支持传统意义上的「按需加载」——它没有 lazy-load 类机制，所有 autoload 配置在 vendor/autoload.php 加载时就完成注册和映射构建。真正影响启动时间的，是「是否必须扫描、是否必须 fallback、是否重复解析」。大型项目慢，90% 不是类多，而是自动加载器在拼命找类。
为什么 composer dump-autoload -o 在大型项目里常没用甚至更慢
这个命令只重写 autoload_static.php 和轻量级映射，根本不会触发 classmap 扫描。它默认不读取你的 "autoload": {"classmap": [...]} 配置，也不扫描 src/ 或 vendor/ 下的真实 PHP 文件。结果就是：vendor/composer/autoload_classmap.php 为空或只有零星几条，运行时仍走 PSR-4 路径拼接 + file_exists() 遍历。
- 验证方法：打开
vendor/composer/autoload_classmap.php，看数组长度是否远小于你预期的类数 - 典型现象：冷启动耗时 >150ms，
strace -e trace=openat,stat php index.php 2>&1 | grep vendor显示上百次对vendor/xxx/src/...的访问 - 真正该跑的是：
composer install --optimize-autoloader --classmap-authoritative --no-dev，不是dump-autoload
--classmap-authoritative 是开关，不是装饰
启用后，自动加载器查不到类就直接报 Class not found，绝不 fallback 到 PSR-4。这能砍掉 70%+ 的文件系统调用，但前提是你的代码 100% 合规：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 命名空间末尾必须有反斜杠（
namespace AppConsoleCommands;✅，不是namespace AppConsoleCommands❌） - 类文件路径必须与命名空间严格一一对应（
AppModelsUser→src/Models/User.php，大小写不能错） -
"autoload"和"autoload-dev"不能重叠声明同一前缀（比如都写了"App\": "app/"） - 不能依赖
"files"类型加载全局函数（它绕过 classmap，且无法被 authoritative 模式覆盖）
怎么让 classmap 真正「按需」——只扫你要的，不碰无关目录
盲目把整个 vendor/ 或 src/ 加进 classmap，会导致映射文件体积暴涨（3MB+），每次请求反序列化开销反而压倒收益。关键是限定范围：
- 只对「稳定、极少变更」的目录加 classmap：
"classmap": ["src/Support/", "lib/Helpers/"]，别加tests/、examples/、docs/ - 第三方包慎用全量 classmap；若只用
MonologLogger和MonologHandlerStreamHandler，就单独列这两个文件："classmap": ["vendor/monolog/monolog/src/Logger.php", "vendor/monolog/monolog/src/Handler/StreamHandler.php"] - 删除 composer.json 中无意义的 autoload 条目，比如
"": "legacy/"或宽泛映射"MyLib\": "src/"（应细化到子命名空间）
APCu 和 OPcache 不是可选项，是生产环境底线
classmap 再快，如果每次请求都要从磁盘读取并反序列化几 MB 的数组，性能就白优化了：
- APCu 缓存只在 PHP-FPM 下生效（CLI 默认关闭），且缓存的是 classmap 数组本身，不是文件；部署后必须
opcache_reset()或 reload FPM，否则旧映射一直残留 - OPcache 必须开启：
opcache.enable=1、opcache.memory_consumption >= 128M，否则autoload_static.php无法被有效缓存 - PHP 7.4+ 强烈建议配置
opcache.preload，在 FPM master 进程启动时预加载vendor/autoload.php，彻底消除运行时加载开销
classmap 和 authoritative 模式暴露的从来不是性能问题，而是代码结构和命名规范问题。一个报 Class not found 的错误，十有八九是你漏了命名空间末尾的反斜杠，或者大小写不一致——这些在 PSR-4 fallback 下被掩盖了，却悄悄拖垮了整条加载链。
