ThinkPHP多库联动核心在于统一识别、避免冲突与重复加载，关键取决于TP3.2/TP5/TP6版本对应的自动加载机制：TP6依赖Composer配置PSR-4/files/classmap；TP5支持extend目录、Loader::import及类映射；TP3.2依靠Library/Vendor目录约定与import/vendor函数。
ThinkPHP 多库联动引入第三方类库，核心不在“多”，而在“怎么让不同来源的类能被统一识别、不冲突、不重复加载”。关键取决于你用的是 TP3.2、TP5 还是 TP6+，因为自动加载机制完全不同。TP6 完全依赖 Composer，TP5 支持 Composer + 手动映射 + extend 目录，TP3.2 则靠 import/vender + Library 目录约定。下面按主流版本分场景说明。
TP6：Composer 主导，多源共存靠 autoload 配置
TP6 不支持也不需要 import 或 vendor() 函数，所有类加载都走 Composer 的 PSR-4 / files / classmap 机制。
- 官方扩展（如 think-captcha）：直接 composer require topthink/think-captcha，安装后自动注册命名空间，use 即可
- 非标准第三方库（比如一个没发到 Packagist 的 SDK）：放进 extend/ 目录，再在 composer.json 中显式注册 PSR-4 映射，例如：
"autoload": { "psr-4": { "QrCode\": "extend/qrcode/" } } - 纯函数文件（如 helper.php）：用 "files" 字段引入，避免每次 new 类时重复 require：
"autoload": { "files": ["extend/helper.php"] }，然后运行 composer dump-autoload -o - 注意：不要把多个同名命名空间指向不同路径，否则自动加载会随机命中一个，引发行为不一致
TP5：extend 目录 + Loader::import + 命名空间三选一
TP5 兼容性较强，支持自动加载和手动导入双模式，适合混合使用多种第三方来源。
- 推荐方式：把第三方类放 extend/ 目录，按 PSR-4 规范组织，例如：
extend/wechat/WxPay.php → namespace wechat;，然后 use wechatWxPay; - 旧版无命名空间类（如 PHPExcel.class.php）：放在 extend/phpexcel/，用 Loader::import('phpexcel.PHPExcel', EXTEND_PATH, '.class.php') 加载，实例化写 new PHPExcel()
- 快速测试临时类：直接 require_once EXTEND_PATH . 'xxx.php';，但不建议长期使用，绕过自动加载不利于维护
- 类库映射可提速：对高频调用类，用 Loader::addClassMap(['WeChat' => EXTEND_PATH.'wechat/WeChat.php']) 提前绑定路径
TP3.2：Library/Vendor 目录 + import/vender 函数分工明确
TP3.2 没有 Composer 强制要求，但结构约定强——路径即规则，改目录就得同步改调用写法。
立即学习“PHP免费学习笔记（深入）”；
- 符合命名规范的类（有 namespace，.class.php 后缀）：放进 Library/Org/ 或 Library/Vendor/，例如：
Library/Org/Util/Array.class.php → namespace OrgUtil;，调用 new OrgUtilArray(); - 无命名空间或后缀不符（如 xxx.php）：必须用 import() 或 vendor()，区别在于：
— import('Org.Util.Date') 默认找 .class.php，路径为 Library/Org/Util/Date.class.php
— vendor('Zend.Filter.Dir') 默认找 .php，路径为 Vendor/Zend/Filter/Dir.php - 手动 require 场景：当类内部依赖相对路径常量（如 __DIR__）时，vendor() 会自动切换当前工作目录，比 require 更安全
- 切记：import 和 vendor 都是运行时加载，不能在类定义里直接 new，必须放在方法体内
跨版本共通避坑点
无论哪个版本，“类找不到”八成出在加载链断裂，而不是代码本身。
- 路径大小写敏感：Linux 下 extend/QrCode/ 和 extend/qrcode/ 是两个目录
- 命名空间末尾不加反斜杠：写 use QrCodeQrCode;，不是 use QrCodeQrCode;（use 前不加 ）
- 实例化时加反斜杠：new QrCodeQrCode() 中的 表示从根命名空间开始，防止当前命名空间污染
- TP6 修改 composer.json 后必执行 composer dump-autoload -o，否则新增映射不生效
- TP3.2 的 import 路径中不能含 .php 后缀，vendor 可以含，但一般省略
