tp6自定义类库必须通过composer psr-4自动加载，路径、命名空间、文件名须严格对齐：类放app/下对应子目录，命名空间末尾与路径末尾均需加反斜杠，改composer.json后必执行composer dump-autoload -o。
ThinkPHP 6+ 项目里加自定义类库，别再用 import() 或硬塞 Loader::addClassMap() —— 这些在 TP6 已废弃，直接报错或静默失效。核心就一条：走 Composer 的 PSR-4 自动加载，路径、命名空间、文件名三者必须严格对齐，缺一不可。
类文件放哪？目录结构决定命名空间
自定义类不能随便扔进 app/ 下任意子目录就完事。TP6 默认只扫描 app/ 目录下的 PSR-4 映射（"app\": "app/"），所以你的类必须落在这个路径下，且目录层级要和命名空间完全一致：
- 想用
apputilsHelper，类文件就得是app/utils/Helper.php，顶部声明namespace apputils; - 想用
appserviceOrderService，就得放在app/service/OrderService.php，命名空间为appservice; - 文件名必须首字母大写，且与类名完全一致（
OrderService.php≠orderservice.php） - 别把类丢进
extend/目录指望自动加载——TP6 默认不扫描它，除非你手动配 autoload
composer.json 怎么配？漏掉反斜杠就加载失败
修改 composer.json 的 "autoload" → "psr-4" 段，加一行映射。注意两个细节：路径末尾带斜杠，命名空间末尾也必须带反斜杠，否则 Composer 找不到：
"autoload": {
"psr-4": {
"app\": "app/",
"app\utils\": "app/utils/"
}
}
上面这行 "apputils" 里的双反斜杠是 PHP 字符串转义，实际表示一个反斜杠；后面 "app/utils/" 的末尾斜杠也不能省——少了它，Composer 会把 apputilsHelper 解析成 app/utilsHelper.php，而不是 app/utils/Helper.php。
改完不执行 dump-autoload？等于没改
每次增删类、调整命名空间或改了 composer.json，必须手动运行：
composer dump-autoload -o
不加 -o 参数的话，开发时可能不生效（尤其开了 OPcache）；如果提示 Class not found，第一反应不是代码写错了，而是先跑这句命令。
另外，别在控制器构造函数里反复调用 new apputilsHelper() 前还想着“先 require 一下”——TP6 的自动加载是按需触发的，只要命名空间和路径对，new 的那一刻就会自动载入，多此一举反而干扰流程。
最常被忽略的点：大小写敏感不只是 Linux 才有。Windows 下文件系统不区分大小写，但 Composer 加载器和 PHP 类名解析是区分的。哪怕只是把 Helper.php 写成 helper.php，在 Windows 开发环境里也可能暂时“看起来能跑”，一上 Linux 就彻底崩。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
