ThinkPHP没有“自动搜索路径”概念，其类加载、配置读取、模板定位等均依赖显式声明的路径映射而非目录遍历；核心是autoload_namespace命名空间映射、CONFIG_PATH固定配置目录、__ROOT__动态计算，非搜索机制。
ThinkPHP 没有“自动搜索路径”这个内置概念，所谓“自动搜索路径”实际是开发者对类自动加载、配置文件查找、模板定位等行为的模糊统称——必须拆解到具体场景才能正确配置。
autoload_namespace 配置命名空间映射路径
这是最常被误称为“自动搜索路径”的核心机制。ThinkPHP 会按 autoload_namespace 中定义的命名空间前缀 → 目录映射关系，拼出类文件路径并尝试加载。
- 配置位置：项目根目录
config/app.php或app/config.php（TP6/TP7 在config/app.php） - 写法必须是相对路径，且以
/结尾，例如：'app\common\'=> APP_PATH . 'common/'，不能写成./app/common/或绝对路径 - 如果类名是
app\common\service\UserService，框架会尝试加载APP_PATH . 'common/service/UserService.php' - 多个命名空间可并列配置，但重复前缀会导致后注册的覆盖前注册的
CONFIG_PATH 和 config/autoload.php 的加载顺序
ThinkPHP 加载配置时，并不“搜索”目录，而是按固定顺序读取预设路径下的文件。关键点在于 CONFIG_PATH 常量是否被正确定义。
-
CONFIG_PATH默认指向APP_PATH . 'config/'（如app/config/），你不能靠改这个常量来“扩展搜索”，它只控制主配置目录 - 额外配置文件需显式引入：在
config/autoload.php中返回一个数组，其中键为配置名，值为文件路径（支持相对路径，如'database' => APP_PATH . 'extra/database.php'） - 若路径写错或文件不存在，框架不会报错，而是静默跳过——这是最容易踩的坑：你以为加载了，其实没生效
模板路径和 __ROOT__ 不是自动搜索，而是运行时计算
像 __ROOT__、__PUBLIC__ 这类常量，不是从一堆路径里“搜索”出来的，而是根据当前请求的 URL 和入口文件位置动态推算的。
立即学习“PHP免费学习笔记（深入）”；
-
__ROOT__是 Web 服务器 DocumentRoot 到入口文件所在目录的相对路径，例如入口是/var/www/html/index.php，而网站根目录是/var/www/html，则__ROOT__为空字符串；若入口在/var/www/html/app/public/index.php，则__ROOT__通常是/app/public - 这个值在应用初始化早期就固化了，后续无法通过配置“添加搜索路径”来改变它
- 如果你发现
__ROOT__输出不对，问题一定出在 Web 服务器重写规则或部署结构上，而不是 ThinkPHP 配置漏写了什么路径
别用 classmap 试图“兜底扫描”目录
虽然 composer.json 支持 classmap，但在 ThinkPHP 项目中应避免依赖它做“自动搜索”。
-
classmap是 Composer 构建期生成的静态映射表，一旦类文件增删，必须手动执行composer dump-autoload，否则新类根本不会被识别 - PSR-4 映射优先级高于 classmap，如果同一个类名同时出现在两者中，PSR-4 的版本会被加载，classmap 的直接失效
- ThinkPHP 自身的自动加载器并不读取 Composer 的 classmap，除非你显式引入
vendor/autoload.php并启用 Composer 加载器
真正需要“多路径支持”的场景（比如插件模块各自带配置或类库），应该用独立命名空间 + 显式 autoload_namespace 配置，而不是幻想框架会自动遍历目录。路径不是被“搜索”出来的，是被“声明”出来的——这点一旦混淆，调试成本会指数上升。
