ThinkPHP各版本引入第三方类库的核心逻辑是优先自动加载、不满足则手动加载：TP5/TP6推荐Composer PSR-4自动加载；extend目录需严格匹配命名空间；TP3.2/TP5可用import()/vendor()手动导入；原生include/require仅作兜底。
ThinkPHP 不同版本对第三方类库的引入方式差异较大，但核心逻辑一致：优先走自动加载，不满足则手动加载。下面按主流版本（TP5/TP6 为主，兼顾 TP3.2 的典型用法）整理几种真正常用、有效、不易出错的方法。
Composer 自动加载（TP5/TP6 推荐首选）
TP5 起全面支持 PSR-4，TP6 完全依赖 Composer。只要第三方库符合规范，安装后直接可用：
- 执行 composer require vendor/name（如
composer require guzzlehttp/guzzle） - 确保入口文件（如
public/index.php）已包含require __DIR__.'/../vendor/autoload.php'; - 在代码中 use 对应命名空间，然后 new 实例（如
use GuzzleHttp\Client;） - 自定义类（如
app/utils/Helper.php）需在composer.json中注册 PSR-4 映射，再运行composer dump-autoload -o
放入 extend 目录 + 命名空间引用（TP5/TP6 标准做法）
适合你自行封装的工具类或轻量 SDK，无需发布到 Packagist：
- 把类文件放至
extend/mylib/MyClass.php - 文件内声明命名空间
namespace mylib;，类名与文件名一致 - 在控制器中直接
use mylib\MyClass;或new \mylib\MyClass(); - 注意：目录结构必须严格匹配命名空间层级，否则自动加载失败
使用 import() 或 vendor() 手动导入（TP3.2 / TP5 兼容写法）
适用于无命名空间、非标准后缀（如 .class.php）、路径不规则的老类库：
立即学习“PHP免费学习笔记（深入）”；
-
import('qrcode', EXTEND_PATH);→ 加载extend/qrcode.php -
import('wechat-sdk.wechat', EXTEND_PATH, '.class.php');→ 加载extend/wechat-sdk/wechat.class.php -
vendor('Zend.Filter.Dir');→ 默认加载thinkphp/library/Vendor/Zend/Filter/Dir.php - 导入后实例化时注意命名空间：若类没声明 namespace，需用
new \Dir();（带反斜杠）
原生 include/require（兜底方案，慎用）
当以上方式都失效，或只是临时调用一个简单函数文件时可考虑：
include_once EXTEND_PATH . 'aliyun/oss/autoload.php';require_once VENDOR_PATH . 'some/sdk/init.php';- 优点是绝对可控；缺点是破坏自动加载机制，无法被 IDE 正确识别，也不利于后期维护
- 仅建议用于无命名空间、无 composer 支持、且不频繁调用的遗留脚本
