最常见原因是命名空间与目录结构不匹配：ThinkPHP 5.0严格遵循PSR-4，namespace app\library\payment必须对应application/library/payment/Payment.php，路径层级、大小写、类名均须完全一致，Linux下尤其注意v1与V1区分。
命名空间与目录结构不一致导致类找不到
这是最常见也最容易被忽略的问题：ThinkPHP 5.0 严格遵循 PSR-4 自动加载规则，namespace 必须和文件物理路径完全对应。比如你写了 namespace app\library\payment，那类文件就必须放在 application/library/payment/Payment.php；如果实际路径是 application/library/Payment.php，就会报 Class 'app\library\payment\Payment' not found。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 检查文件所在目录层级是否与命名空间小写形式逐级匹配（TP5 默认路径全小写）
- Linux 环境下注意大小写敏感，
v1和V1是两个不同目录 - 类名必须与文件名一致（如
Alipay.php里只能定义class Alipay） - 避免在命名空间中混用大小写驼峰（如
App\Controller\ApiV1），除非你明确配置了非标准自动加载
第三方类库没用命名空间时无法自动加载
很多老项目或轻量工具类（比如早期的 qrcode.php、PHPExcel.php）压根没写 namespace，TP5 的自动加载器直接跳过它们，new \QrCode() 会报错。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 必须用
Loader::import()或助手函数import()手动载入文件 - 路径参数要传对：无命名空间类放在
extend/下，就用EXTEND_PATH；在vendor/下，就用VENDOR_PATH - 调用时类名前必须加反斜杠，例如
new \QrCode()，否则 PHP 会去当前命名空间下找 - 别用
use引入无命名空间类——语法错误
与 think / app / traits 根命名空间冲突
如果你把第三方类库放到 extend/ 目录下，又起了和框架同名的根命名空间（比如 namespace think\cache\driver），或者误用了 app 作为自定义命名空间前缀（如 namespace app\util），会导致类被 TP5 自动加载器误判为框架或应用类，从而覆盖或冲突。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
-
extend/下的类，命名空间不要以think、app、traits开头 - 推荐用项目专属前缀，比如
namespace myproject\tool，对应文件路径extend/myproject/tool/Helper.php - 若必须复用某第三方包的原命名空间（如
Monolog\Logger），确保它已通过 Composer 安装，并由 Composer 自动加载，不要手动挪进extend/ - 检查
composer.json中的autoload配置，避免 PSR-4 映射覆盖了你的自定义路径
vendor 类库被 import() 错误加载引发重复定义
有人为了“统一写法”，对 Composer 安装的类库也用 Loader::import('monolog.logger', VENDOR_PATH)，结果触发两次加载：一次是 Composer 自动加载，一次是 import() 手动包含，最终报 Cannot declare class Monolog\Logger, because the name is already in use。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- Composer 安装的类库，一律走自动加载，直接
use Monolog\Logger或new \Monolog\Logger() -
Loader::import()只用于非 Composer 管理、无命名空间、或路径不在自动加载范围内的类文件 - 不确定是否已加载？加一句
class_exists('Monolog\Logger')判断再决定是否 import - 禁用
vendor()助手函数——它本质就是import()的封装，同样有重复加载风险
Loader？类名解析时有没有隐式拼接当前命名空间？import() 后的类到底挂在哪个作用域？这些问题不厘清，换十种写法都可能踩进同一个坑。 
