ThinkPHP 的 extend/ 目录需手动注册命名空间、配置、服务等才能使用：类须声明命名空间并用 Loader::addNamespace() 注册；Facade 需重写 getFacadeClass() 并在 config/app.php 映射；配置文件必须放 config/extra/ 下且返回数组；插件需在 providers 或 provider.php 中显式注册。
ThinkPHP 的 extend/ 目录不是“插件安装区”，直接丢文件进去就用，90% 会报 Class not found。它默认不扫描、不自动加载、不注册命名空间——你得手动告诉框架“这些类在哪、叫什么、怎么调”。
extend/ 目录里的类为什么 new 不出来？
因为 ThinkPHP 默认只加载 app/、vendor/ 和配置的自动加载路径，extend/ 完全被忽略。
- 类文件必须声明命名空间，比如
extend/mylib/Helper.php要写namespace extend\mylib; - 调用时不能省略命名空间前缀，得写
new extend\mylib\Helper()（除非你注册了别名） - 更常用的做法是在
app/common.php或服务提供者的register()方法里加：Loader::addNamespace('mylib', EXTEND_PATH . 'mylib/');
之后就能用new mylib\Helper() - 如果用了 PHP8+，注意
Loader类在 TP8 中已迁移到think\facade\Loader，但底层仍支持旧调用方式；推荐统一用think\Loader防止兼容问题
想封装成门面（Facade）却报 getFacadeClass 未定义？
这是扩展封装中最常踩的坑：只写了 Facade 类，没重写 getFacadeClass()，框架根本不知道该代理到哪个真实类。
- 假设你的工具类是
extend\utils\JsonFormatter，那么门面类app\facade\JsonFormatter必须包含：protected static function getFacadeClass() { return 'extend\utils\JsonFormatter'; } - 然后在
config/app.php的'facade' => []数组里加映射：'json_formatter' => app\facade\JsonFormatter::class - 最后才能在任意地方调用
JsonFormatter::format($data) - 漏掉任何一步，都会触发
Fatal error: Call to undefined method getFacadeClass()
扩展自带的配置文件（如 alipay.php）放 config/ 下不生效？
ThinkPHP 只合并 config/extra/ 目录下的同名 PHP 文件，config/alipay.php 是无效路径。
立即学习“PHP免费学习笔记（深入）”；
- 正确路径是
config/extra/alipay.php，内容必须是纯return [];数组，不能有echo、var_dump或执行逻辑 - 读取方式仍是
config('alipay.app_id')，和内置配置完全一致 - 多环境配置不要在
extra/alipay.php里做if (APP_ENV === 'prod')判断——应拆成config/extra/alipay_dev.php和config/extra/alipay_prod.php，框架会按APP_ENV自动加载对应文件 - 若扩展包本身带配置（如
topthink/think-queue），它不会自动复制进config/，需手动从vendor/topthink/think-queue/config/queue.php复制过去
composer require 装完插件，use 还是报错？
装上了 ≠ 注册了。Composer 只负责下载和自动加载，但 ThinkPHP 的服务、Facade、事件监听器等，必须由服务提供者（Service Provider）显式注册。
- 检查
config/app.php的'providers'数组，确认是否加入了类似think\captcha\CaptchaService::class的条目 - 打开
composer.json，搜dont-discover：如果值是["*"]，说明全局禁用了自动发现，删掉这行或改成精确列表（如["topthink/framework"]） - 部分插件（如
think-queue）不带服务提供者，或者提供者未启用，就得自己在app/provider.php里手动追加 - 命令行指令（如
php think queue:work）要生效，还必须在config/console.php的'commands'里注册，否则php think根本不认识
最易被忽略的点是：extend/ 目录下类的命名空间声明和 Loader 注册必须严格匹配路径；Facade 类的 getFacadeClass() 返回值必须是完整类名（含反斜杠）；配置文件路径差一个 extra/ 就彻底失效。这些不是“可选优化”，而是运行前提。
