Composer autoloader 按注册顺序匹配PSR-4前缀，遇首个匹配即停止；类未被引用时不触发加载，触发后严格依命名空间+目录配置字符串拼接路径，无扫描、无模糊匹配。
Composer autoloader 是怎么决定加载哪个文件的？
Composer 的自动加载不是“看到类就去扫目录”，而是靠生成的 vendor/autoload.php 和其中的 ClassLoader 实例，根据 PSR-4（或 PSR-0）规则把类名映射到文件路径。它不解析 PHP 文件内容，只靠命名空间前缀 + 目录配置做字符串匹配。
所以“按需加载”本质是：类没被 new 或 static 调用，就不会触发 autoload；而 autoload 一旦触发，就严格按注册的映射规则找文件——没有模糊匹配、没有运行时扫描。
-
composer.json中的"autoload": {"psr-4": {"App\": "src/"}}表示所有以App开头的类，都去src/下按命名空间结构找文件 - 如果类名是
AppHttpControllerHome，自动加载器会尝试加载src/Http/Controller/Home.php - 路径不存在或文件里没定义该类 → 报
Class 'AppHttpControllerHome' not found，不是“跳过”，而是失败
如何让某些类完全不进 autoload 映射？
常见场景：你有一堆工具函数文件（如 helpers.php）、或仅含 trait / interface 的 stub 文件，它们不该被 autoload 加载，否则可能提前执行副作用代码，或污染类加载逻辑。
正确做法不是删掉文件，而是从 autoload 配置中排除它们：
- 用
"autoload": {"files": ["src/helpers.php"]}—— 这是**一次性加载**，不是按需，适合全局函数，但会随autoload.php一起加载，无法“按需” - 真正“按需”的解法：**不注册**。把这类文件放在 autoload 映射外的目录（如
src/Support/），并在需要时用require_once手动引入 - 若必须放在映射目录内，可用
"autoload-dev"单独管理测试辅助类，生产环境不会加载它们
PSR-4 映射冲突时，ClassLoader 怎么选？
多个 PSR-4 映射前缀重叠（比如 "App": "src/" 和 "AppLegacy": "legacy/"），Composer 会按 composer.json 里声明的**顺序**匹配，遇到第一个匹配前缀就停止搜索。
这意味着：
- 更具体的前缀（如
AppLegacy）必须写在更宽泛的前缀（如App）之前，否则永远走不到legacy/ - 执行
composer dump-autoload -o后，映射会被扁平化为一个哈希表，但顺序逻辑仍保留——优化后只是查得快，不改匹配逻辑 - 用
composer show -s可查看当前生效的 autoload 映射顺序
为什么 dump-autoload -o 有时反而变慢？
-o（optimize）会把 PSR-4 映射转成 class-to-path 的静态数组，跳过字符串前缀匹配，理论上更快。但它有个隐藏代价：所有类名都会被预加载进内存，哪怕你一次都没用过。
尤其在大型项目中：
- autoload_classmap.php 可能达数 MB，PHP 解析这个大数组本身就有开销
- OPcache 对大数组的编译/缓存效率不如小文件分散加载
- 如果你的项目实际只用 20% 的类，
-o反而浪费内存和启动时间
建议：CLI 工具类多、Web 请求类少的项目，慎用 -o；高频 Web 服务且类分布集中，再考虑开启。用 blackfire 或 xhprof 实测 autoload 时间，比盲目加 -o 更可靠。
真正的按需加载，从来不在配置开关上，而在你是否真让类被引用——autoload 本身已经足够“按需”，问题往往出在代码组织和加载时机上。
