ThinkPHP 6/8 引入第三方类库必须通过 Composer 自动加载；需确保 composer.json 和 vendor/ 存在，标准库用 composer require 安装，非标准库放 extend/ 并手动引入或配置 autoload。
ThinkPHP 6/8 引入第三方类库，核心就一条：靠 Composer 自动加载，不是“能用”，而是“必须用”。只要 Composer 安装成功、路径正确、命名空间对得上，类就能直接 use 和 new，不用手动 require 或改入口文件。
确认项目已初始化 Composer
根目录下必须有 composer.json 和 vendor/ 目录。如果项目是手动搭建或从压缩包解压而来，先运行：
- composer init（按提示填完基本信息）
- 检查 composer.json 中是否有
"autoload": {"psr-4": {"app\": "app/"}}—— TP6/8 默认已配好，别删掉 - 若 vendor 为空，说明依赖没装全，执行 composer install 或 composer update
用 composer require 安装标准库
这是最常用、最推荐的方式。以 Guzzle HTTP 客户端为例：
- 在项目根目录运行：composer require guzzlehttp/guzzle
- Composer 自动下载、写入 autoload.php、更新 lock 文件
- TP 入口文件（如
public/index.php）已预置require __DIR__ . '/../vendor/autoload.php';，无需额外操作 - 代码中直接使用：
use GuzzleHttpClient;→$client = new Client();
处理非标准或无命名空间的类库
有些老库（比如某些 SDK、单文件工具类）不支持 PSR-4，也不能用 composer require 安装：
立即学习“PHP免费学习笔记（深入）”；
- 把文件放进 extend/ 目录（TP 官方推荐的扩展存放位置）
- 如果它没有命名空间，就无法自动加载，需手动引入：
require_once EXTEND_PATH . 'qrcode.php'; - 如果有命名空间但路径不标准（如
libWeChat对应extend/lib/WeChat.php），可在 composer.json 的"autoload"下加 PSR-4 映射：{"lib\": "extend/lib/"}，再运行 composer dump-autoload -o
常见失败原因和快速排查
报错 “Class not found” 时，90% 是加载链断了：
-
入口文件漏引 autoload.php：检查
public/index.php第一行是否为require __DIR__ . '/../vendor/autoload.php';，路径层级是否正确（嵌套深了要加更多../） -
命名空间与目录不匹配：例如类声明
namespace orgutil;，文件就必须放在extend/org/util/Helper.php - 用了 require_once 多次引入 autoload.php：会导致类重复定义，直接 fatal error
-
composer install 被跳过或失败：查看 vendor 是否真实存在对应包目录，
composer show可列出已安装包
