ThinkPHP 6+ 自定义驱动需严格遵循 PSR-4：命名空间、文件路径、大小写三者必须完全一致，并在 composer.json 中配置 "app\cache\driver\": "app/cache/driver/"，执行 composer dump-autoload -o 后方可自动加载。
ThinkPHP 加载驱动类不是靠手动 require 或写死路径，而是依赖 PSR-4 自动加载 + 命名空间与目录结构的严格对齐；一旦报 Class "thinkcachedriverFile" not found，90% 是命名空间声明、文件路径、大小写三者中至少有一处不匹配。
驱动类文件放在哪、怎么命名
ThinkPHP 6+ 的驱动类（如缓存、日志、数据库）默认放在 vendor/topthink/think-xxx/src/ 下，但你自定义驱动时必须遵守框架约定：
- 目录结构必须和命名空间完全对应：比如想写一个 Redis 缓存驱动，类名是
appcachedriverRedis，那文件就得放在app/cache/driver/Redis.php - 文件名必须首字母大写，且与类名完全一致：
Redis.php✅，redis.php❌（Linux 下直接失败） - 类顶部的命名空间必须完整、无拼写错误：
namespace appcachedriver;✅，namespace appcacheDriver;❌（大小写敏感） - 不能把驱动类扔进
extend/就指望自动加载——那里默认没注册 PSR-4 映射，得手动配或改入口
如何让自定义驱动被自动识别
ThinkPHP 6 不再用 thinkLoader::addNamespace() 这类 TP5 方式，统一走 Composer 的 PSR-4 注册。你需要改两处：
- 在
composer.json的"autoload"→"psr-4"段里加一行："app\cache\driver\": "app/cache/driver/"（注意双反斜杠转义） - 执行
composer dump-autoload -o（必须加-o，否则开发时可能不生效） - 确认该驱动类继承了正确基类，比如缓存驱动要继承
hinkcachedriverDriver，否则运行时报错不是“找不到类”，而是“实例化抽象类” - 别在配置里写
'type' => 'redis'却忘了在config/cache.php中注册驱动别名：'redis' => ppcachedriverRedis::class
为什么 new hinkcachedriverFile 能加载，而 new ppcachedriverRedis 不行
这是因为 hinkcachedriverFile 属于核心包，其 PSR-4 映射已在 vendor/composer/autoload_psr4.php 中由 Composer 自动生成；而你的 ppcachedriverRedis 属于应用层代码，必须自己注册映射并刷新 autoload 文件。
立即学习“PHP免费学习笔记（深入）”；
- 常见错误现象：
Class "appcachedriverRedis" not found，但文件明明存在、命名空间也写了——八成是漏了composer dump-autoload -o - 检查
vendor/composer/autoload_psr4.php是否已包含你新增的映射项，没有就说明dump-autoload没生效 - 如果驱动类用了 traits 或依赖其他未加载的类，也要确保它们的命名空间和路径同样合规，否则会卡在“找到类但 require 失败”
- 不要试图在
common.php里用Loader::addClassMap()强行映射驱动类——它绕过 PSR-4，后续扩展包或热重载可能失效
最易忽略的是大小写一致性：Windows 下可能侥幸跑通，一上 Linux 就崩；还有就是 composer.json 里路径末尾少了个 /，或者命名空间末尾多了一个 ，这种细节错一点，整个链路就断了。
