必须配置autoload、执行composer dump-autoload、引入vendor/autoload.php三者缺一不可；psr-4映射中命名空间前缀须双反斜杠结尾（如"app\": "src/"），路径为相对路径且大小写敏感，修改后不运行dump-autoload则映射无效。
类文件写好了，new App\User() 却报 Class not found？不是代码写错了，而是 Composer 根本没被告诉“去哪找这个类”。必须配 autoload、跑 composer dump-autoload、引入 vendor/autoload.php——三者缺一不可。
PSR-4 映射怎么写才不白配
最常用也最容易踩坑的是 PSR-4。它靠命名空间前缀 + 目录路径拼出文件位置，比如 App\User → src/User.php，前提是映射写对。
-
"App\": "src/"中的App\末尾双反斜杠不能少，漏掉就变成字符串转义，整个映射静默失效 -
"src/"是相对于composer.json所在目录的路径，不能写成./src或src（少斜杠在某些系统下失败） - 别写成
"App\": "src/App/"：这会让App\User去找src/App/User.php，但你实际放在src/User.php—— 路径多了一层 - 子目录名必须和命名空间段完全一致：
App\Http\Controllers→src/Http/Controllers/→src/Http/Controllers/HomeController.php
classmap 和 files 各该用在哪儿
PSR-4 不是万能的。遇到老代码、无命名空间、或只有函数的文件，得换方式。
-
classmap：适合legacy/下一堆DatabaseUtil.php、StringUtils.php这类没命名空间的类。配置"classmap": ["legacy/"]后，composer dump-autoload会扫描所有.php文件，生成“类名 → 文件路径”表。新增类必须重跑命令 -
files：只用于加载全局函数或常量，比如src/helpers.php。它会在每次引入vendor/autoload.php时无条件require_once，不能放类定义（否则重复定义报错） -
autoload-dev里的配置（如测试类）只在--no-dev以外生效，CI 环境若用了该参数，tests/下的类就找不到
为什么改完 composer.json 还是加载不到
常见原因不是配置错，而是执行链断了。
- 入口文件（如
index.php）没第一行引入require __DIR__ . '/vendor/autoload.php';—— 没这句，Composer 加载器根本没启动 - 改了
composer.json但没运行composer dump-autoload；install或update不会自动触发 autoload 刷新 - 项目根目录不对：在
src/目录下执行composer dump-autoload，它找不到composer.json，命令看似成功实则无效 - 存在手动定义的
function __autoload($class) { }或调用了spl_autoload_unregister—— 这会覆盖甚至干掉 Composer 的加载器
验证是否真生效的最快方法
别猜，直接测。
- 加一行
var_dump(class_exists('App\User'));，返回true才算通 - 如果返回
false，先确认vendor/autoload.php是否已引入，且是在任何new或use之前 - Linux 下注意大小写：
HomeController.php写成homecontroller.php就加载失败，Windows 不报错但部署后崩 - 调试时可跑
composer show --platform看 autoloader 是否启用，比翻日志快
真正容易被忽略的，是路径相对性与执行时机：所有路径都以 composer.json 为原点，所有配置变更都依赖 dump-autoload 主动刷新——Composer 不监听文件系统，它只认你亲手敲下的那条命令。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
