ThinkPHP加载核心类库_核心类库自动加载【详解】

聊到 ThinkPHP 的核心类库——think\Cache、think\Log、think\Db 这些——很多人都以为它们天生就能直接 new，不需要手动 require 或 import。原则上确实如此，前提是你没动过自动加载链，也没把 vendor/autoload.php 删掉。一旦踩坑，报错信息往往就是 Class "think\Cache\Driver\File" not found 这种。

为什么 new hink\Cache\Driver\File() 会报错？

别急着怀疑“框架没加载核心类”，问题大概率出在 PSR-4 映射断了，或者被人为覆盖了。TP6+ 版本彻底交给了 Composer 来管理核心类的加载——think 命名空间的映射定义在 vendor/composer/autoload_psr4.php 里，通常指向 thinkphp/library/think/。一旦这个映射失效，框架再强也找不到类。

排查起来也不复杂：先看看入口文件 public/index.php 里是否还保持着 require __DIR__ . '/../vendor/autoload.php';；再去 vendor/composer/autoload_static.php 里找一下有没有 'think' => array($vendorDir . '/topthink/thinkphp/src/think') 这类条目（TP6.3 之后路径可能变成 topthink/thinkphp/src）；如果修改过 composer.json 或者手动移动过 thinkphp/ 目录，别忘了跑一遍 composer dump-autoload -o 强制刷新映射。

TP5 和 TP6 加载 think 类的方式差异在哪？

TP5 时代还保留着类似 think\Loader::addNamespace('think', THINK_PATH . 'library/think/') 这样的手动注册逻辑；到了 TP6，这套机制已经被彻底移除。所有命名空间都走 Composer 的 PSR-4 加载器。换句话说，你就算在 TP6 里调用 Loader::addNamespace()，它也不会报错，只是静默忽略——压根不生效。

• TP5：可以手动注册，可以改 AUTOLOAD_NAMESPACE，还支持 Loader::addClassMap() 做提前映射。
• TP6：只认 composer.json 里 "autoload": {"psr-4": {...}} 的配置。核心命名空间 think 是 Composer 自动注入的，靠 PHP 代码覆盖不了。
• 一个容易忽略的细节：TP6 的 Loader 类默认不初始化类库映射表，即使你写 Loader::addClassMap('think\Db', THINK_PATH . 'library/think/Db.php');，它也不会生效——因为自动加载流程中，类库映射检测（第1步）虽然比 PSR-4（第2步）早，但映射表本身是空的，除非你在 autoload 触发之前显式调用 addClassMap，这在实践中极难稳定。

自定义类想复用 think 命名空间怎么办？

最直接的忠告：别往 think 下硬塞东西。Composer 不允许跨包覆盖已注册的 PSR-4 前缀，如果你在 composer.json 里强行写 "think": "app/think/"，结果就是核心类加载失败，得不偿失。

• 正确姿势：用独立的命名空间，比如 app\util，然后在 composer.json 里添加 "app\\util": "app/util/"。清爽又安全。
• 如果非要把类名做成 think\MyCache 这种形式（比如为了和框架行为保持一致），那就把它发布成独立的 Composer 包，通过 composer require your-vendor/think-my-cache 引入，包自身的 composer.json 会声明 PSR-4 映射，不会和核心冲突。
• 临时调试可以用 class_alias()，比如 class_alias('app\util\MyCache', 'think\MyCache');，但只适合单文件验证，别用到生产环境。

还有一点容易被忽略：TP6 中 thinkphp 目录本身是否被 composer install 正确链接？有些部署会把 thinkphp 放进 vendor/topthink/thinkphp，有些则平铺在项目根目录——这两种结构对应的 PSR-4 路径完全不同。而且 dump-autoload 不会自动修正路径错误，必须人工核对 autoload_psr4.php 里的实际值才能定位问题。