thinkphp 加载第三方类库需按版本选择方式：tp6+ 必须用 composer 自动加载，tp5.1–5.2 推荐 extend 目录匹配命名空间，tp3.2 支持 library、autoload_namespace 或 import；错用方式导致 class not found。
ThinkPHP 加载第三方类库没有“万能模板”，但有按版本区分的清晰路径。核心差异在于：TP3/5 依赖框架内置自动加载机制，TP6+ 则完全绑定 Composer，跳过它就无法启动。选错方式，90% 的“Class not found”都源于此。
TP6+：必须走 Composer 自动加载
入口文件（如 public/index.php）第一行必须是：
之后所有操作围绕 Composer 展开：
- 第三方库统一用
composer require vendor/name安装，例如：composer require aliyuncs/aliyun-oss-php-sdk - 安装后直接 use 命名空间，无需手动 require 或 import，例如：
use OSSOssClient; - 自定义类库需在
composer.json中显式注册 PSR-4 映射，例如："autoload": { "psr-4": { "app\extend\": "extend/" } }
然后执行composer dump-autoload -o - 不支持
import()、Vendor()等旧函数，它们已被移除
TP5.1–5.2：extend 目录 + 命名空间优先
官方推荐将非 Composer 类库放在 extend/ 目录下，结构严格匹配命名空间：
- 类文件路径：
extend/aliyun/oss/OssClient.php - 对应命名空间：
namespace aliyunoss; - 使用方式：
$client = new liyunossOssClient(...);或use aliyunossOssClient; - 若类无命名空间，可用
Loader::import('aliyun.oss.OssClient', EXTEND_PATH)（TP5.0 支持，5.1+ 已弃用，建议改用require_once）
TP3.2：Library / AUTOLOAD_NAMESPACE / import 三选一
灵活性高，但需注意加载优先级：
- 放
ThinkPHP/Library/Org/下，命名空间为OrgUtilMyClass，可直接 new - 自定义根命名空间，在配置中写：
'AUTOLOAD_NAMESPACE' => ['AliOSS' => THINK_PATH . 'Extend/AliOSS']，类内声明namespace AliOSS; - 不规范类库（无命名空间、路径混乱）用
import('AliOSS.autoload', '', '.php')手动引入启动文件 - 注意大小写敏感，目录名与命名空间必须完全一致
通用避坑提醒
- 不要把 SDK 直接丢进
vendor/手动解压——Composer 不识别，不会自动加载 - 多个同名命名空间（如两个 OSS）会冲突，必须重命名空间或隔离目录
- TP6+ 项目若没
composer.json或没运行过composer install，框架根本起不来 - 调试时可查
vendor/composer/autoload_psr4.php，确认你的命名空间是否已注册
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
