ThinkPHP自动加载类文件_类文件自动加载法【实战】-ThinkPHP-PHP中文网

thinkphp 6+ 类自动加载失败主因是psr-4映射未配对或未生效，需确保命名空间、路径大小写/斜杠严格一致，并执行composer dump-autoload -o。

thinkphp自动加载类文件_类文件自动加载法【实战】

ThinkPHP 6+ 的类自动加载失败，90% 是因为 Composer 的 PSR-4 映射没配对、没生效，或者命名空间与路径大小写/斜杠不一致——不是框架坏了，是加载链断在了第一步。

这是最典型的路径映射错误：PHP 把 appcontrollerIndex 当作一个完整命名空间去拼路径，结果找 app/controller/Index.php 失败。

检查文件真实路径是否为 app/controller/Index.php（注意大小写，Linux 下 index.php ≠ Index.php）
打开该文件，确认顶部有且仅有：namespace appcontroller;（末尾无空格，反斜杠是英文，不能写成 app/controller 或 Appcontroller）
确认类名是 class Index，首字母大写，与文件名完全一致
运行 composer dump-autoload -o，不是 dump-autoload，漏掉 -o 在开发环境常导致缓存未更新

TP6 不再识别 Loader::addNamespace()，必须走 Composer 的 PSR-4 注册流程。

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

编辑项目根目录的 composer.json，在 "autoload": {"psr-4": {}} 里加一行："app\utils\": "app/utils/"（注意双反斜杠转义，末尾带斜杠）
确保类文件 app/utils/ArrHelper.php 顶部声明：namespace apputils;，类名为 class ArrHelper
执行 composer dump-autoload -o，生成优化映射；如果改完仍不生效，删掉 vendor/composer/autoload_psr4.php 再重试
别把类放 extend/ 下就指望自动加载——那里默认不在 PSR-4 范围内，除非你手动在 composer.json 里加映射

这不是 ThinkPHP 的问题，是 Composer 的 autoload.php 没被正确引入或包本身 autoload 配置缺失。

检查 public/index.php 是否包含：require __DIR__ . '/../vendor/autoload.php';（TP6 默认有，但如果你重写过入口，可能删了）
运行 composer show overtrue/pinyin，确认已安装；再看它的 composer.json 里 "autoload" 是否声明了 "psr-4"，没声明就得手动补
某些包高版本改了命名空间（比如从 OvertruePinyinPinyin 变成 OvertruePinyinStandard），查文档比猜类名更可靠
临时验证：在控制器里直接 require vendor/overtrue/pinyin/src/Pinyin.php，能跑通说明是 autoload 链路问题，不是代码问题

能调通，但不该用——它们绕过 Composer，性能差、不兼容热更新、上线后容易在 Linux 下因大小写失效。

Loader::import('user.Think#Test') 是 TP5 风格，TP6 中已标记为兼容层，未来版本会移除
Loader::addPsr4('common', APP_PATH . 'common/') 会和 Composer 的 autoload_psr4.php 冲突，注册顺序不确定时类加载行为不可预测
唯一合理用 Loader::addPsr4() 的场景：调试阶段临时加一个目录，且你明确知道它不会进生产部署
真正要长期用的目录，只做一件事：改 composer.json → dump-autoload -o → 提交配置文件

最常被忽略的一点：Composer 的 PSR-4 映射对路径末尾斜杠、命名空间末尾反斜杠、文件系统大小写三者都敏感，Windows 开发时“差不多能跑”不等于 Linux 上线后不出错，上线前务必在目标环境跑一遍 php -r "new apputilsArrHelper();" 验证。