ThinkPHP 6+ 自动加载完全依赖 Composer 的 PSR-4 机制，根本原因在于命名空间与物理路径不匹配或未执行 composer dump-autoload -o；需确保 composer.json 中正确配置 "App\": "app/"、类名与文件名严格一致、入口引入 vendor/autoload.php，且禁用已废弃的 Loader::addNamespace()。
ThinkPHP 6+ 的自动加载不是靠框架自己写一堆 __autoload 或手动 require 实现的，它完全交由 Composer 的 PSR-4 自动加载机制接管——你改了类文件却报 Class not found，90% 是因为没走通这条链。
为什么 new AppServiceUser() 找不到类？
这是最典型的路径-命名空间错位问题。TP6 默认不注册 app/ 目录到 Composer 加载器，哪怕你的类文件明明在 app/service/User.php，且顶部写了 namespace appservice;，只要 composer.json 里没配 "App\": "app/"，就一定失败。
-
AppServiceUser这个类名会被 Composer 拆解为App+ServiceUser，然后去app/目录下找ServiceUser.php—— 注意不是User.php，也不是service/User.php - 命名空间末尾必须带双反斜杠
"App\"，漏掉一个就会把AppServiceUser当成顶层命名空间，去项目根目录找AppServiceUser.php - 文件名必须和类名严格一致：类叫
User，文件就得是User.php，不能是user.php或UserService.php（除非你用的是 classmap） - 改完
composer.json后必须运行composer dump-autoload -o，否则新映射不会写入vendor/composer/autoload_psr4.php
composer dump-autoload -o 到底做了什么？
它把所有 PSR-4 规则展开成一张扁平的类名 → 文件路径映射表，存在 vendor/composer/autoload_classmap.php 里。启用优化后，new AppServiceUser() 不再实时拼路径，而是直接查表——快，但代价是：你新增类或改命名空间后，不重新 dump 就永远找不到。
- 开发阶段建议只用
composer dump-autoload（不加-o），避免缓存导致的“改了代码却没生效”假象 -
-o生成的 classmap 会覆盖 PSR-4 行为，哪怕你配置了"App\": "app/"，最终也按 classmap 里的绝对路径加载 - 如果某个类既在 PSR-4 映射范围，又被 classmap 扫到（比如你手动把
app/加进了 classmap），classmap 条目优先生效，PSR-4 规则被跳过
第三方包如 overtrue/pinyin 加载失败怎么查？
这不是 ThinkPHP 的锅，是 Composer autoloader 链断了。入口文件 public/index.php 必须包含 vendor/autoload.php，少这一行，整个 vendor 下的包全失效。
立即学习“PHP免费学习笔记（深入）”；
- 检查
vendor/autoload.php是否被引入：打开public/index.php，确认有require __DIR__.'/../vendor/autoload.php'; - 运行
composer show overtrue/pinyin看实际安装的版本，v5+ 已把主类从OvertruePinyinPinyin改成OvertruePinyinGenerator - 某些老包用的是
classmapautoload 类型，必须加-o才能生效，单纯dump-autoload不够 - 别去动
vendor/composer/autoload_*.php—— 它们是自动生成的，下次composer install就被覆盖
真正容易被忽略的点是：TP6 的“自动加载”其实分两层——框架核心类走自己的 thinkLoader（比如 thinkDb），而你写的业务类、服务类、工具类，全部依赖 Composer。这两套机制互不感知，也绝不混用。想让 app/utils/ArrHelper.php 被 new apputilsArrHelper() 加载，唯一正路就是配 PSR-4 + dump-autoload，别试 thinkLoader::addNamespace()，那玩意 TP6 早就删了。
