Composer自动加载的核心机制是配置驱动的映射系统，通过composer.json中PSR-4等配置生成vendor/autoload.php及autoload_psr4.php等映射文件，并借助spl_autoload_register注册自动加载逻辑，实现类名到文件路径的按需映射与加载。
Composer自动加载的核心机制是什么
Composer 不是自己去扫描文件，而是通过生成一个 vendor/autoload.php 文件，把类名到文件路径的映射关系（PSR-4 或 PSR-0）预先注册进 PHP 的 spl_autoload_register()。只要你的类命名和目录结构符合规则，require 'vendor/autoload.php' 之后，new 一个类就会自动找对应文件。
- PSR-4 是当前主流，要求命名空间前缀对应物理路径，类名严格匹配文件名（如
AppControllersHomeController→src/Controllers/HomeController.php） - 自动加载只在类首次被引用（new / static call / instanceof 等）时触发，不是一加载就全读进内存
- 如果类名拼错、命名空间没对上路径、或者文件没放在声明的根目录下，就会报
Class not found，而不是语法错误
如何配置 composer.json 实现 PSR-4 自动加载
在项目根目录的 composer.json 中写明 "autoload" 段，指定命名空间前缀和源码路径：
{
"autoload": {
"psr-4": {
"App\": "src/"
}
}
}
-
App后面的双反斜杠是必须的，表示命名空间结尾，不能写成App或App/ -
"src/"是相对于composer.json的路径，必须存在且可读；若用src（无尾部斜杠）也能工作，但官方示例都带斜杠，建议统一 - 修改后必须运行
composer dump-autoload才会更新vendor/autoload.php；开发中改了命名空间或挪了文件，漏掉这步就会加载失败 - 如果有多个命名空间，可以写多个键值对，例如同时加载测试类：
"Tests": "tests/"
为什么 new 类时报 Class not found，但文件明明存在
这类问题八成出在映射断点上，而不是文件本身：
- 类文件里没有声明正确的命名空间，比如文件在
src/Models/User.php，但开头缺了namespace AppModels; - 命名空间用了小写或下划线，如
appmodelsUser，而 PSR-4 要求首字母大写且用反斜杠分隔 - 文件扩展名不是
.php（比如保存成了.php.txt），Windows 下容易踩这个坑 -
composer dump-autoload没加-o参数，而你又启用了 OPcache：OPcache 缓存了旧的 autoload map，导致新增类不生效，此时要加composer dump-autoload -o生成优化版映射 - 使用了 classmap 方式但忘了运行
dump-autoload，classmap 不支持动态发现，必须显式刷新
何时该用 classmap 而不是 PSR-4
PSR-4 适合结构清晰、命名规范的新项目；classmap 更适合这些场景：
立即学习“PHP免费学习笔记（深入）”；
- 第三方库没遵循 PSR 标准，类名和文件名不一致（比如
Database_MySQL.php里定义了Database_MySQL类） - 需要加载全局函数文件（如
src/helpers.php），这时在autoload里加"files"数组更直接 - 遗留项目目录混乱，无法快速整理命名空间，用
"classmap": ["legacy/"]让 Composer 扫描并硬编码路径映射 - 注意：
classmap生成后不会自动感知新文件，每次增删类都要重新跑composer dump-autoload
实际项目里常混合使用：主代码走 PSR-4，辅助函数走 files，老模块走 classmap。真正容易被忽略的是——autoload 配置只影响 require 项目的自动加载，如果你在 vendor/ 里手动改了某个包的 composer.json，它不会生效；那种情况得去那个包自己的仓库配。
