ThinkPHP 6+ 自动加载完全依赖 Composer 的 PSR-4 机制，非框架自实现；“Class not found”主因是命名空间与物理路径不匹配、未执行 composer dump-autoload -o 或 vendor/autoload.php 未引入。
ThinkPHP 6+ 的自动加载不是靠框架自己写一堆 __autoload 或手动 require 实现的，它默认完全交由 Composer 的 PSR-4 加载器接管。你遇到的 “Class not found” 错误，90% 是因为 Composer 没扫到你的类，而不是 ThinkPHP “没配置好自动加载”。
Class "appcontrollerIndex" not found 是路径和命名空间不匹配
这个错误典型表现为类名被连成一串、没有反斜杠分隔，说明自动加载器根本没按命名空间去拆解路径，而是把整个类名当成了一个扁平字符串去查文件。
- 检查
app/controller/Index.php文件是否存在，且首字母大写 —— ThinkPHP 不接受index.php或IndexController.php - 确认文件顶部有且仅有：
namespace appcontroller;（注意是反斜杠，不是斜杠；末尾不加） - 类名必须严格匹配文件名：
class Index，不能是class IndexController或class index - Linux/macOS 下大小写敏感，
AppControllerIndex和appcontrollerIndex是两个不同命名空间，别混用
自定义工具类（如 apputilsArrHelper）不生效，要改 composer.json
TP6 不再支持 Loader::addNamespace() 这类运行时注册方式，所有自定义命名空间必须走 Composer 配置。
- 在项目根目录的
composer.json中的"autoload"→"psr-4"下添加："app\utils\": "app/utils/"（注意双反斜杠转义） - 路径末尾带斜杠，命名空间末尾也必须带反斜杠，二者对齐才匹配得上
- 执行
composer dump-autoload -o（开发阶段可先不加-o，避免优化后改了代码不生效） - 别把类放
extend/下就指望自动加载 —— 那里默认不注册，要么配 autoload，要么手动require
第三方包（如 OvertruePinyinPinyin）报错，先看 vendor/autoload.php 是否引入
TP6 的入口文件 public/index.php 默认包含 vendor/autoload.php，但如果你动过入口或用了自定义启动流程，这一步可能被删掉。
立即学习“PHP免费学习笔记（深入）”；
- 打开
public/index.php，确认存在require __DIR__ . '/../vendor/autoload.php'; - 运行
composer show overtrue/pinyin查版本，某些 v5+ 版本已将类移到OvertruePinyinGenerator，原Pinyin类废弃 - 如果包用的是
classmap而非 PSR-4（老包常见），必须加-o才能生成映射：composer dump-autoload -o -
vendor/composer/autoload_static.php是最终生效的映射表，出问题时可直接打开它搜类名，看是否在里面
Loader::import() 还能用，但等于绕过自动加载机制
这个函数在 TP6 里只是个兼容性兜底，它不走 Composer，也不认命名空间，纯粹是拼路径 + include_once。
- 调用
Loader::import('app.utils.ArrHelper')会尝试加载app/utils/ArrHelper.php，忽略命名空间声明 - 无法加载带子命名空间的类（如
apputilscacheRedisHelper），因为.不代表层级分隔 - 性能差：每次调用都做一次文件存在判断和 IO，无缓存、无优化
- 热更新失效：改了类文件，不重启 PHP-FPM 或 CLI 进程，
import可能仍加载旧内容（OPcache 影响）
最常被忽略的一点：Composer 的 PSR-4 映射只在 dump-autoload 时静态生成，它不会监听文件变化。改了命名空间、加了新类、挪了文件位置，不跑一遍命令，自动加载就永远找不到那个类 —— 这不是 Bug，是设计使然。
