thinkphp 6+ 类加载依赖 composer 的 psr-4 自动加载机制，需严格对齐命名空间、路径与文件名；控制器须置于 app/controller/ 下且命名空间为 appcontroller，类名与文件名一致；自定义目录（如 app/service/）需在 composer.json 中手动配置 psr-4 映射并执行 composer dump-autoload -o。
ThinkPHP 6+ 的模块类库（如控制器、模型、中间件）不是靠“手动 require”或旧版 Loader::addNamespace() 加载的，而是由 Composer 的 PSR-4 自动加载机制驱动——只要命名空间、路径、文件名三者严格对齐，就能直接 new 或 use，否则必报 Class "appcontrollerIndex" not found 这类错误。
控制器类加载失败：路径、命名空间、文件名必须完全一致
常见现象是访问路由时提示 Class "appcontrollerIndex" not found，本质是 PHP 尝试加载类名 appcontrollerIndex，但没找到对应文件。
- 控制器文件必须放在
app/controller/目录下，且文件名首字母大写、与类名完全一致（例如Index.php） - 类顶部必须声明
namespace appcontroller;（注意反斜杠，不能写成appcontroller或AppController） - 类名必须与文件名一致：
class Index→ 文件Index.php；class UserAdmin→ 文件UserAdmin.php - 大小写敏感：Linux 系统下
index.php≠Index.php，Windows 下可能侥幸通过，但部署到生产环境必挂
自定义模块类（如 app/service/）需手动注册 PSR-4 映射
ThinkPHP 不会自动扫描 app/ 下所有子目录，只默认识别 controller、model、middleware 等少数约定目录。你加了 app/service/OrderService.php，想用 new appserviceOrderService()？得告诉 Composer。
- 编辑项目根目录下的
composer.json，在"autoload": {"psr-4": {...}}中添加一行："app\service\": "app/service/" - 注意双反斜杠转义（JSON 字符串中），路径末尾带斜杠，命名空间末尾也必须带反斜杠
- 执行
composer dump-autoload -o（加-o是关键，否则开发时可能不生效） - 改完后清空 runtime/cache/ 下的缓存，避免旧映射干扰
vendor 第三方包加载失败：别怪 ThinkPHP，先查 Composer 链路
报错 Class "OvertruePinyinPinyin" not found，哪怕 composer require overtrue/pinyin 成功了，问题也不在 TP 框架本身。
- 确认
public/index.php中是否引入了vendor/autoload.php（TP6 默认有，但如果你重写过入口文件，可能删掉了） - 运行
composer show overtrue/pinyin，看实际安装的版本——某些 v5+ 版本已把类名从Pinyin改为PinyinHelper，命名空间也可能从OvertruePinyin变成OvertruePinyinHelper - 某些老包用的是
classmap而非 PSR-4，必须加-o才能生成映射：composer dump-autoload -o - 别把第三方类放
extend/下还指望自动加载——TP6 已弃用 extend 目录的自动扫描逻辑，除非你手动在composer.json里配 autoload
最易被忽略的点：改了命名空间或新增类后，composer dump-autoload -o 这步永远不能跳。它不是“可选优化”，而是让 PSR-4 映射生效的强制开关——没跑这行命令，前面所有路径和命名空间配得再准也没用。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
