ThinkPHP 文件加载采用分层机制：类文件严格遵循 PSR-4 自动加载（namespace 与路径一一对应，需执行 composer dump-autoload）；语言包需满足路径、命名、注册、时机四条件；配置、函数、模板各走专用加载路径；手动加载仅作兜底。
ThinkPHP 文件加载不是靠“include 一把梭”，而是有一套分层、有序、可配置的机制。核心在于自动加载（autoload）与显式加载（import / require）并存，但框架强烈倾向前者——尤其对类文件；而语言包、配置、模板等非类资源，则走各自专用路径。
类文件：全靠 PSR-4 自动加载，路径即命名空间
ThinkPHP 5/6+ 完全依赖 Composer 的 PSR-4 规范加载类。关键就一条：namespace 必须严格对应物理路径。
- 控制器必须写
namespace app\controller;，文件就得放在app/controller/IndexController.php；写成appcontroller或app\controller\Controller都会报“Class not found” - 模型写
namespace app\model;，文件就得在app/model/User.php；多级命名空间如app\service\payment\Alipay，对应路径就是app/service/payment/Alipay.php - 改完 namespace 或新增类后，必须运行
composer dump-autoload -o，否则 Composer 不知道这个类在哪 - Linux 下大小写敏感，
App\Controller和app\controller是两个不同命名空间，别指望本地 Windows 环境能掩盖问题
语言包：四条件缺一不可，静默失败是常态
语言包不自动加载，必须同时满足：路径对、命名对、注册对、时机对，漏一个就返回原字符串，还不报错。
- 路径必须小写连字符：
lang/zh-cn/common.php✅；lang/zh_CN/common.php❌；lang/zh-cn.php❌ - 文件内直接 return 数组：
return ['login' => '登录'];，不能套一层return ['zh-cn' => [...]] - 必须启用 Lang 中间件：
think\middleware\Lang::class要出现在app/middleware.php全局中间件列表中，且位置要在SessionInit之后 -
Lang::setLocale('en-us')必须在中间件 handle 开头就调用，不能在控制器构造函数或 action 里才设——那时语言包早已扫描完毕
配置、函数、模板：按需触发，各走各路
这些不属于类，不走 autoload，框架有独立加载逻辑：
立即学习“PHP免费学习笔记（深入）”；
- 配置文件（
config/app.php等）在应用初始化早期由Config类统一加载，支持多级合并和环境覆盖 - 公共函数文件（如
common.php）在应用启动时自动引入，路径为app/common.php或模块下同名文件 - 模板文件（
view/index/index.html）由View类根据当前控制器/操作名拼路径，再交由模板引擎解析；不依赖命名空间，纯路径匹配 - 扩展类库（
extend/下）可通过Loader::import('qrcode')手动加载，但更推荐用 Composer 管理并注册 PSR-4 映射
手动加载：仅作兜底，不建议日常使用
虽然框架提供了 Loader::import() 和助手函数 import()，但它绕过了自动加载缓存，性能低，也不支持命名空间别名。
- 适用于临时引入无命名空间的第三方脚本（如老版 PHPExcel）
- 路径支持别名：
import('@.util.upload')表示当前模块下的util/upload.php - ThinkPHP 5.0+ 明确不推荐用于控制器、模型等标准类，应优先走 PSR-4
