Composer 不提供运行时按需加载，仅生成自动加载映射；真正的按需加载由 PHP autoload 机制触发，Composer 的作用是构建高效、准确、可维护的索引。
Composer 本身不提供运行时按需加载逻辑，它只负责生成自动加载映射；真正的“按需加载”由 PHP 的 autoload 机制在运行时触发，而 Composer 的作用是让这个机制高效、准确、可维护。
为什么 composer dump-autoload 不能跳过？
你写的类没被加载，不是因为没“按需”，而是 Composer 还不知道它在哪。执行 composer dump-autoload（或安装/更新时自动触发）会扫描 psr-4、psr-0、classmap 等配置，生成 vendor/autoload_runtime.php 和核心的 vendor/composer/autoload_classmap.php 等文件——这些才是 PHP 自动加载器真正读取的索引。
- 不执行该命令，新增类即使路径规范也不会被识别
- 开发中频繁增删类，建议加
-o（优化 classmap）或用--apcu（启用 APCu 缓存映射）提升性能 - 若用了
files类型自动加载（如全局函数），也要靠它注册到加载器中
psr-4 是最常用也最容易配错的加载方式
它把命名空间前缀和物理路径做静态映射，PHP 在 new 一个类时，根据类名反推路径，再 require 对应文件——这就是“按需”的本质：不 new 就不找、不 require。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 错误示例：
"MyLib\": "src/"—— 若类为MyLibFooBar，会去找src/Foo/Bar.php，但若实际文件在src/MyLib/Foo/Bar.php，就会失败 - 正确写法：
"MyLib\": "src/MyLib/"，确保命名空间前缀与目录结构严格对齐 - 多个前缀可并列配置，Composer 会按顺序匹配，越具体的前缀建议越靠前
什么时候该用 classmap 而不是 psr-4？
当你的类不遵循 PSR-4 命名规范（比如传统下划线命名、无命名空间、或散落在非标准目录），classmap 是兜底方案：它通过遍历目录，把每个 .php 文件里定义的类名全部登记进数组，运行时查表加载。
- 适合 legacy 代码、工具类文件（如
src/helpers.php）、或含function定义的文件（需配合files） - 执行
composer dump-autoload -o才会生成优化后的 classmap，否则每次加载都要实时扫描目录，性能差 - classmap 不支持命名空间推导，类名必须字面匹配（包括大小写），且无法处理动态类名（如
new $className时若未提前声明，仍会报错）
自动加载失败的典型现象和排查路径
报错 Class "XxxYyy" not found，别急着改代码，先确认加载链是否打通：
- 检查
composer.json中 autoload 配置是否拼写正确（尤其末尾反斜杠和路径斜杠/） - 运行
composer show -p看当前项目是否已作为 root 包被识别；子模块若未设为pathrepository，不会被主项目 autoload - 用
composer dump-autoload -v查看详细扫描日志，确认目标类文件是否被纳入映射 - 临时加一句
var_dump($loader->findFile('XxxYyy'));（其中$loader是require 'vendor/autoload.php'返回的对象），看路径是否为空
真正决定“按需”的是 PHP 的 SPL 自动加载机制，Composer 只是帮它建好高效率的索引。配错映射、跳过 dump 步骤、混淆 psr-4 与 classmap 的适用边界——这三处出问题的概率远高于语法或逻辑错误。
