thinkphp 6+ 自动加载必须依赖 composer 的 psr-4 规范：入口需引入 vendor/autoload.php；自定义类命名空间与目录结构严格对应，并在 composer.json 中声明映射；新增类后须执行 composer dump-autoload -o；非 composer 类库放 extend/ 并手动 require_once；函数文件通过 extra_file_list 配置或 provider.php 引入；tp3/5 的旧机制（如 library/、loader::addnamespace）在 tp6 中已失效。
ThinkPHP 实现自动加载，核心在于让 PHP 在实例化类或调用类方法时，能按规则自动定位并引入对应文件，无需手动写 require 或 include。不同版本机制差异较大，但自 ThinkPHP 6 起已完全绑定 Composer，自动加载必须走 PSR-4 规范路径注册与加载流程。
ThinkPHP 6+：必须靠 Composer PSR-4 注册
入口文件（如 public/index.php）第一行就必须加载 Composer 自动加载器：
-
require __DIR__ . '/../vendor/autoload.php';—— 这步不可省略、不可延后 - 自定义类（如
appcommonserviceUserService）必须满足：命名空间路径 = 目录结构，例如：namespace appcommonservice;→ 文件路径为app/common/service/UserService.php - 在
composer.json中显式声明 PSR-4 映射："autoload": { "psr-4": { "app\": "app/" } } - 每次新增类或修改命名空间后，运行
composer dump-autoload -o生成优化后的自动加载映射
第三方类库（非 Composer 包）的引入方式
不通过 Packagist 安装的 SDK 或工具类，推荐统一放在 extend/ 目录下，并手动引入：
- 把 SDK 放入
extend/alipay/AopClient.php等路径 - 在使用处用
require_once EXTEND_PATH . 'alipay/AopClient.php';（EXTEND_PATH是框架常量） - 不建议直接往
app/或library/下硬塞非 PSR-4 结构的类——TP6 不再识别旧版Library/自动加载逻辑
公共函数文件（非类）的自动加载
函数不能靠 PSR-4 加载，需通过配置触发自动包含：
- 将函数文件放在
app/common/function.php（TP6 默认自动加载该文件） - 若需额外加载，如
app/common/helper.php，在config/app.php中添加：'extra_file_list' => [app_path() . 'common/helper.php'] - 也可在服务提供者（
app/provider.php）中用include_once显式引入，确保全局可用
旧版 ThinkPHP（3.x / 5.x）的兼容说明
这些版本仍支持 Library/ 目录和 AUTOLOAD_NAMESPACE 配置，但 TP6 已移除该机制：
- TP5.1 还保留部分自动搜索逻辑（如
extend/+ 命名空间映射），但优先级低于 Composer - TP3.2 允许在配置中写
'AUTOLOAD_NAMESPACE' => ['Org' => THINK_PATH . 'Org']，TP6 不再生效 - 任何试图绕过 Composer 直接复用 TP3/5 的
Loader::addNamespace()在 TP6 中会静默失败
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
