class not found报错主因是vendor/autoload.php未正确引入或引入顺序错误，导致composer自动加载链路中断；thinkphp 6+完全依赖此文件实现psr-4加载，必须确保其在base.php之前被require且路径准确。
Class not found 报错，90% 不是类写错了，而是 vendor 目录没被正确加载 —— 根本问题不在你的代码，而在 Composer 的 autoload 链路断了。
vendor/autoload.php 没被引入或引入顺序错误
ThinkPHP 6+ 完全依赖 vendor/autoload.php 做 PSR-4 加载，如果它没执行，整个自动加载就瘫痪。常见于你改过入口文件 public/index.php，删掉了默认的 require __DIR__.'/../vendor/autoload.php';，或者把它挪到了 thinkphp/base.php 之后。
- 打开
public/index.php，确认第一行（或紧随define('APP_PATH', ...)后）有且仅有这一句：require __DIR__.'/../vendor/autoload.php'; - 这行必须在
require __DIR__.'/../thinkphp/base.php';之前，否则 ThinkPHP 自己的加载器会先启动，而 Composer 还没注册 - 别用
include或require_once替换 ——require是唯一安全写法，防止路径错误时静默失败
第三方包的 autoload 声明缺失或格式错误
运行 php think vendor:publish 后类仍找不到？不是 TP 问题，是那个扩展包根本没在自己的 composer.json 里声明 autoload，Composer 就不会把它纳入加载范围。
- 进该包目录（如
vendor/overtrue/pinyin），检查是否有composer.json，且含"autoload": {"psr-4": {"Overtrue\Pinyin\": "src/"}}这类声明 - 若没有，不能靠 TP 的
Loader::addNamespace()补救（TP6 已弃用），必须手动在项目根目录composer.json的autoload.ps r-4下追加："Overtrue\Pinyin\": "vendor/overtrue/pinyin/src/" - 注意反斜杠：Windows 下写成
"OvertruePinyin"（单反斜杠）会失效，必须是双反斜杠"Overtrue\Pinyin\" - 改完立刻执行：
composer dump-autoload -o，不加-o在某些环境可能不生效
composer show 能查到包，但类还是加载失败
说明包已安装，但命名空间映射没对上。典型表现是 composer show overtrue/pinyin 显示 v5.0.0，而文档写的是 use OvertruePinyinPinyin;，但实际类已移到 OvertruePinyinZhiYin —— 高版本废弃旧类名是常态。
- 用
composer show overtrue/pinyin --all查看该包所有已安装版本的完整信息 - 进
vendor/overtrue/pinyin/src/目录，直接看文件结构和namespace声明，别信文档 - 运行
grep -r "class Pinyin" vendor/overtrue/pinyin/src/快速定位真实类定义位置 - Linux 服务器上注意大小写：
Pinyin.php对应namespace OvertruePinyin，写成namespace Overtruepinyin就加载失败
runtime 缓存干扰导致 vendor 类“忽隐忽现”
开发中改了 vendor 包的命名空间，清了 Composer autoload 却仍报错？ThinkPHP 的 runtime/container/ 和 runtime/cache/ 会缓存类映射和服务绑定，哪怕 autoload 已更新，框架仍可能从旧缓存里取类。
- 执行：
rm -rf runtime/*（Linux/macOS）或手动清空runtime/全部子目录（Windows） - 确保
APP_DEBUG = true，否则类加载器会跳过动态解析，只读缓存 - 常驻进程（如 Swoole、Workerman）必须重启，否则旧 autoload 映射仍在内存里
- 别只清
runtime/cache/——runtime/container/里的服务容器缓存同样会导致 new 出来的对象无法注入依赖
最易被忽略的是：Composer 的 autoload 映射一旦生成，就和 ThinkPHP 的配置完全解耦。改了 config/app.php 里的 app_namespace，对 vendor 下任何类都无效；删了 Loader::addPsr4() 调用，也不会影响已写死在 vendor/composer/autoload_psr4.php 里的映射。问题不在 TP，而在你是否真正理解了 Composer 的加载边界。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
