ThinkPHP 6+ 自动加载完全依赖 Composer 的 PSR-4 规则，需确保命名空间、物理路径、文件名大小写严格一致，并执行 composer dump-autoload -o 生效；第三方包需确认入口引入 vendor/autoload.php 且其 composer.json autoload 配置正确。
ThinkPHP 6+ 的自动加载不靠框架自己写一堆 __autoload 或手动 require，它完全交由 Composer 管理，核心就是 PSR-4 映射 + spl_autoload_register 触发机制。改完命名空间或加了新类却报 Class "appcontrollerIndex" not found？八成是路径、命名空间、大小写三者没对齐，或者漏了 composer dump-autoload -o。
PSR-4 命名空间与物理路径必须严格一一对应
ThinkPHP 6 不再维护自己的加载逻辑，所有类（包括 app/ 下的控制器、模型、服务）都走 Composer 的 PSR-4 规则：命名空间前缀 + 类名 → 目录路径 + 文件名。
-
appcontrollerIndex必须对应app/controller/Index.php（注意：文件名首字母大写，且扩展名是.php，不是.class.php） - 命名空间声明必须全小写：
namespace appcontroller;，不能写成AppController或app/controller（后者是非法命名空间语法） - 目录名和文件名大小写敏感：Linux/macOS 下
app/Controller/和app/controller/是两个不同路径，加载必然失败 - 类名必须与文件名完全一致：
class Index只能放在Index.php，不能是index.php或IndexController.php
composer dump-autoload -o 不是可选项，是必执行步骤
你改了命名空间、新增了类、调整了 composer.json 里的 psr-4 配置，不运行这句命令，Composer 就不知道有变化——它不会实时扫描文件系统。
- 开发中建议始终加
-o（optimize）：生成优化后的静态映射表vendor/composer/autoload_psr4.php，跳过运行时路径拼接，加载更快也更稳定 - 只运行
composer dump-autoload（不带-o）在某些环境下可能不生效，尤其启用了 OPcache 时 - 确认命令执行成功：终端输出应含
Generating optimized autoload files，而不是Generated autoload files（后者无优化）
vendor 第三方包加载失败，问题不在 ThinkPHP
报错如 Class "OvertruePinyinPinyin" not found，哪怕 composer require overtrue/pinyin 成功了，也大概率是入口文件没引入 Composer 自动加载器，或该包本身 autoload 配置有缺陷。
立即学习“PHP免费学习笔记（深入）”；
- 检查
public/index.php开头是否包含：require __DIR__ . '/../vendor/autoload.php';—— TP6 默认有，但如果你重写了入口，可能删掉了 - 查看该包的
composer.json，确认其"autoload": {"psr-4": {...}}声明正确，且命名空间前缀（如"Overtrue\Pinyin\": "src/"）与你代码中使用的use OvertruePinyinPinyin完全匹配 - 有些老包用
classmap，必须加-o才能生成映射，否则找不到类
自定义目录（如 app/utils/）怎么接入自动加载
别碰 thinkLoader::addNamespace() —— 这是 TP5 的遗物，TP6 已弃用。统一走 Composer 配置。
- 编辑项目根目录下的
composer.json，在"autoload": {"psr-4": {...}}里加一行："app\utils\": "app/utils/" - 注意双反斜杠转义（JSON 字符串内），路径末尾带斜杠，命名空间末尾也必须带反斜杠
- 执行
composer dump-autoload -o，之后就能直接new apputilsArrHelper() - 别把类扔进
extend/目录指望自动加载——那里默认不注册，要么配 autoload，要么手动require
最常被忽略的其实是大小写和斜杠方向：Windows 下开发容易忽略路径大小写，一上 Linux 就崩；composer.json 里写错一个反斜杠或漏掉末尾斜杠，映射就断掉。调试时直接打开 vendor/composer/autoload_psr4.php，看生成的数组里有没有你期望的键值对，比猜快得多。
