ThinkPHP项目需手动配置composer.json的PSR-4映射，如"App": "app/"，并运行composer dump-autoload -o优化加载；文件路径、命名空间、类名须严格一一对应且大小写敏感。
app/ 目录下、写了正确的命名空间，new AppServiceUser() 依然会报错——因为框架没配，Composer 就不认识这个映射。
composer.json 必须手动加 psr-4 映射
ThinkPHP 的 app/ 目录不会被 Composer 自动识别，你得自己在项目根目录的 composer.json 里声明：
-
"autoload"是顶层字段，不能嵌在require或其他地方 - 命名空间前缀末尾必须带双反斜杠：
"App": "app/"，写成"App"或"App\"（Windows 风格）都可能失败 - 路径值是相对于
composer.json所在位置的子路径，不能写./app/或../app/ - 改完后必须运行
composer dump-autoload（开发调试建议加-o生成 classmap）
正确示例：
{
"autoload": {
"psr-4": {
"App": "app/",
"Common": "common/"
}
}
}
文件路径和命名空间必须严格一一对应
PSR-4 不是“大概能找着就行”，而是大小写、层级、拼写全敏感。常见报错 Class AppHttpControllersHomeController not found 往往不是配置错了，而是结构没对齐：
-
AppHttpControllersHomeController→ 必须对应app/Http/Controllers/HomeController.php - 目录名
Http不能写成http或HTTP（Linux 生产环境直接失败） - 类文件里只能定义一个类，且类名必须是
class HomeController，不能是class homecontroller或class HomeController2 - 不能多出一层冗余目录，比如
app/App/Http/...—— 因为命名空间前缀已经是App，再套一层就错位了
别让 ThinkPHP 自加载和 Composer 冲突
ThinkPHP 启动时会注册自己的 Loader，它默认优先级高于 Composer 的自动加载器。如果你同时用了 Loader::addPsr4() 和 composer.json 里的 PSR-4，结果可能是：
立即学习“PHP免费学习笔记（深入）”；
- 某些请求走 TP 加载器，某些走 Composer（尤其在 CLI 和 Web 混用时）
- 同一类被重复注册，浪费内存，甚至因路径不一致导致
Cannot declare class - 开发时类能加载，上线后突然报错（因 Linux 下大小写更严格，或 autoloader 注册顺序变化）
实操建议：
- 要么全交给 Composer 管理（删掉所有
Loader::addPsr4()调用，禁用config/app.php中的class_map和alias干扰项） - 要么彻底禁用 Composer 的 PSR-4（清空
composer.json的autoload.psr-4，重跑dump-autoload），只靠 TP 运行时加载 - 若必须混用，确保
Loader::addPsr4()在public/index.php引入thinkphp/base.php后立即执行，且命名空间前缀不与 Composer 的冲突
优化 autoload 性能：-o 参数不是可选项
开发阶段不加 -o，每次 new 一个类都要扫描 vendor/composer/autoload_psr4.php、拼路径、调 file_exists()，遇到 Xdebug 或 IDE 断点时卡顿明显。
-
composer dump-autoload -o会生成扁平化的autoload_classmap.php，查找是 O(1) 哈希查表 - ThinkPHP 自身的
thinkphp/library已被框架composer.json声明为 PSR-4，但你的app/和common/默认不在 classmap 里——必须手动加进composer.json的"classmap"字段 - 生产环境务必用
-o；开发环境如果频繁改类名或目录结构，可暂时不用，但要清楚代价
加 classmap 示例：
{
"autoload": {
"psr-4": { "App": "app/" },
"classmap": ["app/", "common/"]
}
}
文件路径、命名空间、类名三者之间没有容错空间，一旦部署到 Linux 服务器，大小写错一位、多一个目录层级、漏掉命名空间末尾的反斜杠，都会让自动加载静默失败——这种问题往往不报错，只抛 Class not found，而你得从头核对每个字符。 
