ThinkPHP引入第三方类库关键在路径、识别与加载机制。TP6+必须用Composer；TP5.1废弃vendor()，统一走Composer；TP3.2依赖Vendor()且路径后缀须匹配；通用原则是命名空间与目录严格一致、禁混用加载方式、按报错全称排查。
ThinkPHP 引入第三方类库，关键不在“怎么加”，而在“加在哪、怎么认、谁来加载”。不同版本差异大，搞错路径或加载方式，90% 的“Class not found”错误就源于此。下面按主流版本分场景说清。
TP6+：必须走 Composer，手动放文件无效
TP6 及以上版本完全依赖 Composer 自动加载机制，vendor 目录下手工复制的类库不会被识别，哪怕路径再对也不行。
- 安装标准库（如 Guzzle、phpspreadsheet）：直接运行
composer require guzzlehttp/guzzle，完成后在控制器中use GuzzleHttpClient;即可实例化 - 自定义扩展类（如
extend/utils/Helper.php）：需在composer.json中注册 PSR-4 映射，例如："autoload": { "psr-4": { "util\": "extend/utils/" } }，然后执行composer dump-autoload -o - 入口文件
public/index.php必须保留require __DIR__ . '/../vendor/autoload.php';，删掉或路径写错（如多一层嵌套没补../）就会报Class 'thinkApp' not found
TP5.1：推荐 Composer，旧式 vendor() 已废弃
TP5.1 起官方移除了 import() 和 vendor() 助手函数，强行使用会报错。所有第三方类库应统一走 Composer 流程。
- 非 Composer 包（如某 SDK 只有 .zip）：解压后放入
extend/目录，严格按 PSR-4 命名空间组织文件结构，例如extend/mylib/Api.php对应namespace mylib; - 不支持命名空间的老代码：只能用
include_once或require_once手动引入，但无法自动实例化，需确保全局类名不冲突 - 注意：直接往
vendor/目录里拖文件，即使路径仿照 Composer 结构，也不会被加载——TP5.1 的 autoload 仅读取vendor/composer/autoload_*.php文件
TP3.2：灵活但规则多，vendor() 是主力
TP3.2 没有 Composer 强约束，支持多种加载方式，但路径和后缀必须匹配约定。
立即学习“PHP免费学习笔记（深入）”；
- 类库放
ThinkPHP/Library/Vendor/下，比如Vendor/Wechat/Wechat.class.php，调用时写Vendor('Wechat.Wechat');，实例化用new Wechat(); - 若文件后缀是
.php（非.class.php），需显式指定后缀：Vendor('Qrcode.phpqrcode', '', '.php'); - 无命名空间的类（如纯 function 文件）：用
import()或直接include_once，例如import('Vendor.Util.Helper');对应Library/Vendor/Util/Helper.class.php - 注意大小写：
Vendor('wxpay.sdk')要求文件名为sdk.php，类定义为class sdk { ... }，实例化才可用new sdk();
通用避坑提醒
无论哪个版本，以下三点最容易被忽略：
-
命名空间与目录结构必须严格一致：比如
namespace appservice;就必须放在app/service/目录下，少一级或多一级都会加载失败 -
不要混用加载方式：同一类库既写
use又写import()，可能因重复定义导致致命错误 -
调试先看报错类名全称：如报
Class 'wechatPay' not found，说明自动加载器在找wechatPay这个命名空间，而不是WechatPay或pay，检查命名空间声明和文件路径是否完全匹配
