Class "apputilsArrHelper" not found 是因该类未在 composer.json 的 "autoload": {"psr-4": {...}} 中注册，TP6 完全依赖 Composer 的 PSR-4 机制加载应用类，文件路径、命名空间、类名须严格匹配，且需执行 composer dump-autoload -o 生效。
ThinkPHP 6+ 项目里，工具类（比如 app/utils/ArrHelper.php）默认不会自动加载，直接 new apputilsArrHelper 会报 Class "apputilsArrHelper" not found——这不是框架坏了，是它压根没被 Composer 知道。
为什么 new AppUtilsArrHelper() 找不到类？
TP6 不再用自己写的一套 Loader::addNamespace() 去管应用层类，而是完全交由 Composer 的 PSR-4 加载机制。你写的工具类如果不在 composer.json 的 "autoload": {"psr-4": {...}} 里注册，Composer 就当它不存在。
- 常见错误现象：
Class "apputilsArrHelper" not found、Attempted to load class "DateHelper" from namespace "apputils" - 命名空间声明必须和物理路径严格对齐：文件在
app/utils/ArrHelper.php，就必须写namespace apputils;（注意末尾无），不能写AppUtils或apputils - 文件名必须首字母大写且与类名一致：
ArrHelper.php对应class ArrHelper，写成arrhelper.php或Arrhelper.php在 Linux 服务器上必失败 - 改了命名空间或加了新类后，不运行
composer dump-autoload -o，改动就无效
如何让 app/utils 下的工具类被自动加载？
唯一正解：编辑项目根目录的 composer.json，补全 PSR-4 映射，然后刷新 autoload。
- 打开
composer.json，在"autoload": {"psr-4": {...}}里加一行："app\utils\": "app/utils/"（注意双反斜杠转义，末尾带和/） - 确保路径是相对项目根目录的，不要写成
./app/utils/或绝对路径 - 执行命令：
composer dump-autoload -o（加-o是为了生成优化映射，开发环境也建议加，否则某些 IDE 补全或调试可能不识别） - 验证是否生效：运行
composer show --platform | grep autoload，或临时写个var_dump(class_exists('apputilsArrHelper'));
extend/ 目录下的工具类能自动加载吗？
不能，默认不参与 PSR-4 扫描。TP6 的 extend/ 是“手动加载区”，不是自动加载区。
立即学习“PHP免费学习笔记（深入）”；
- 如果你把
qrcode.php放进extend/qrcode.php，想用new QrCode()，必须先配 autoload 或改路径 - 方案一（推荐）：把它移到
app/tools/，并在composer.json中加"app\tools\": "app/tools/" - 方案二（兼容旧代码）：在
composer.json的"autoload": {"classmap": ["extend/"]}下添加，然后运行composer dump-autoload -o（注意：classmap 是全量扫描，加了大目录会影响 dump 速度） - 方案三（临时救急）：用
Loader::import('qrcode', EXTEND_PATH);，但这是 TP5 风格，TP6 不鼓励，且无法被 IDE 正确识别类型
vendor 里的第三方包加载失败怎么办？
这不是 ThinkPHP 的问题，是 Composer 加载链断了。入口文件里漏引 vendor/autoload.php 是最常见原因。
- 检查
public/index.php开头是否包含：require __DIR__ . '/../vendor/autoload.php';（TP6 默认有，但你若重写过入口，可能删掉了） - 运行
composer show overtrue/pinyin看实际安装版本，有些新版已把OvertruePinyinPinyin改成OvertruePinyinGenerator - 某些老包用的是
classmap而非 PSR-4，必须加-o才生效：composer dump-autoload -o - 别在
config/app.php里瞎配autoload_namespace——TP6 已弃用该配置项
最容易被忽略的一点：PSR-4 映射的命名空间前缀末尾必须是双反斜杠 \，路径末尾必须是正斜杠 /，少一个字符，整个命名空间就失效；而且大小写在 Linux 上是硬性约束，Windows 开发时测通了，一上生产就挂。
