ThinkPHP引入第三方类库应按来源选择加载方式：Composer包直接use；非Composer但规范的放extend/并PSR-4注册；完全不规范的老类库手动require_once。禁用已废弃的Vendor/目录和vendor()方法。
ThinkPHP 引入第三方类库，关键不在“怎么加”，而在“走哪条路”。不同来源、不同规范、不同版本的类库，加载机制完全不同。用错路径，90% 的“Class not found”就来了。
Composer 安装的包：直接 use，别折腾
TP6/TP5.1+ 项目默认基于 Composer 构建，所有通过 composer require 安装的包（如 guzzlehttp/guzzle、phpoffice/phpspreadsheet）都会被自动注册进 vendor/autoload.php。
- 入口文件（如
public/index.php）已预置require __DIR__ . '/../vendor/autoload.php';，确保它没被删或写错路径 - 安装后，在控制器或服务类中直接
use对应命名空间即可，例如：use PhpOfficePhpSpreadsheetSpreadsheet; - 无需手动
require_once、不用Loader::import、更不推荐复制文件到extend或vendor目录下硬塞
非 Composer 包（无 composer.json）：放 extend/，按 PSR-4 命名
自己写的工具类、下载的 SDK（如某支付 SDK 的纯 PHP 版）、未打包成 Composer 的老代码，应统一放进 extend/ 目录，并严格遵循 PSR-4 规范。
- 目录结构必须与命名空间一致：比如类
namespace alipayutil;，文件就得放在extend/alipay/util/SignHelper.php - 在
composer.json的"autoload": {"psr-4": {}}中显式注册，例如："alipay\": "extend/alipay/" - 执行
composer dump-autoload -o生效，之后就能use alipayutilSignHelper;正常调用
完全不守规范的老类库（无命名空间、后缀不是 .php）：用 include 或 require 手动加载
比如某些遗留的 xxx.class.php、functions.inc，或 Zend/Smarty 风格的扁平结构类，自动加载机制无效，只能手动引入。
立即学习“PHP免费学习笔记（深入）”；
- 推荐放在
extend/legacy/下，避免污染主结构 - 在需要的地方用原生 PHP 方式加载：
require_once EXTEND_PATH . 'legacy/MyOldClass.class.php'; - 注意：不要用
Loader::import或vendor()—— TP5.1+ 已移除这些方法；TP6 更是彻底弃用
特别提醒：别再碰 Vendor/ 目录和 vendor() 方法
TP3.x 和早期 TP5 的 Vendor/ 目录（位于框架内部）及 vendor() 函数，是历史兼容方案。TP5.1 起官方明确废弃，TP6 完全删除。强行沿用会导致：
- 类找不到（
Class not found） - 路径错误（
require报告 No such file） - 与 Composer 自动加载冲突，引发重复定义或覆盖
