ThinkPHP的extend目录不是自动加载区，需手动注册命名空间或配置Facade、extra配置、命令行指令等才能生效。
ThinkPHP 的 extend 目录不是“插件安装区”
很多人把 extend 当成类似 npm 或 Composer 的扩展存放地，直接丢进第三方类库就完事——结果运行时报 Class not found。这不是 autoload 失败，而是 ThinkPHP 默认根本不会自动加载 extend 下的 PHP 文件。
真正起作用的是命名空间 + 手动注册或自动扫描。官方文档里那句“可存放自定义类库”没说清楚前提：你得让框架知道这些类在哪、叫什么、怎么加载。
- 如果类文件在
extend/mylib/Helper.php，必须声明命名空间namespace extendmylib;，且类名为Helper - 调用时写
new extendmylibHelper()，不能省略根命名空间反斜杠 - 更稳妥的做法是，在
app/common.php或服务提供者里用Loader::addNamespace()显式注册：Loader::addNamespace('mylib', EXTEND_PATH . 'mylib/');这样之后就能用new mylibHelper()
用 think acadeFacade 封装扩展类时，别漏掉 getFacadeClass
想把 extend 里的工具类变成像 Cache 那样全局可调的门面（Facade），光写一个继承 Facade 的类远远不够。最常踩的坑是忘记重写静态方法 getFacadeClass，导致调用时抛出 Call to undefined method getFacadeClass()。
- 假设扩展类路径是
extend/utils/JsonFormatter.php，命名空间为extendutils，类名为JsonFormatter - 门面类应放在
app/facade/JsonFormatter.php，内容必须包含：protected static function getFacadeClass() { return 'extend\utils\JsonFormatter'; } - 然后在
config/app.php的facade' => []数组里加上映射：'json_formatter' => app\facade\JsonFormatter::class,
之后才能用JsonFormatter::format($data)
扩展配置文件放哪？config/ 下不生效，得走 extra
扩展包自带的配置（比如 alipay.php 或 oss.php）如果直接扔进 config/，启动时不会被合并；ThinkPHP 只认 config/ 下的默认文件和 extra/ 子目录里的同名文件。
立即学习“PHP免费学习笔记（深入）”；
- 正确路径是
config/extra/alipay.php，内容格式必须是 return 数组，不能有 echo 或执行逻辑 - 读取方式仍是
config('alipay.app_id')，和内置配置无异 - 如果扩展需要多环境配置（如开发/生产不同密钥），不要在
extra/alipay.php里做判断，而应利用 ThinkPHP 的环境配置机制：新建config/extra/alipay_dev.php和config/extra/alipay_prod.php，框架会按APP_ENV自动加载对应文件
扩展命令行指令要注册到 command 配置，否则 php think 不识别
自己写的命令类（比如 extend/command/BuildApiDoc.php）即使继承了 thinkConsoleCommand，不显式注册进命令列表，php think list 就看不到它，更别说执行了。
- 在
config/console.php中找到'commands' => []，追加完整类名：'commands' => [ 'build_api_doc' => extendcommandBuildApiDoc::class, ], - 类中
configure()方法里设置的$this->setName('build:api-doc')决定了终端命令名，和数组键名无关 - 注意命名空间路径与实际文件路径严格一致，Windows 下大小写不敏感但 Linux 会直接报错
Class does not exist
扩展结构真正的难点不在放哪，而在“让框架看见并信任它”。路径、命名空间、注册点、加载时机，四个环节只要一环断开，就会静默失败——没有错误提示，只有功能不工作。
