ThinkPHP6+自定义类自动加载核心是PSR-4映射，必须在composer.json中配置命名空间与路径的严格对齐，并执行composer dump-autoload生效；app_namespace仅影响URL路径拼接，不干预Composer自动加载。
ThinkPHP 自定义类自动加载路径，核心就一条：命名空间前缀必须和物理路径严格对齐，且只能靠 composer.json 的 psr-4 配置生效——TP6+ 已弃用 Loader::addNamespace() 和配置项 app_namespace 控制自动加载。
为什么改了 app_namespace 没用
你在 config/app.php 里把 app_namespace 改成 "app_v2"，但控制器还是从 app/controller/ 加载——这不是配置没读，而是这个配置只影响默认应用目录的根命名空间，不接管 PSR-4 自动加载链。它只在框架内部构造默认控制器路径时参与拼接，比如 Url::build('index') 这类辅助方法会用到，但类文件是否能被 new 出来，完全取决于 Composer 的 autoload 规则。
-
app_namespace不影响vendor/autoload.php的行为，也不改变spl_autoload_register的注册逻辑 - 路由绑定模块（如
/admin/index）时，实际加载的是appdmincontrollerIndex，此时命名空间直接由 URL 模块名拼接，app_namespace被跳过 - 如果你手动调用了
Loader::addPsr4()，它会和 Composer 冲突，优先级取决于谁先注册；但 TP6+ 文档明确不推荐这种写法
正确做法：改 composer.json 并 dump-autoload
想让 common/ 目录下的类走 common 命名空间，必须编辑项目根目录的 composer.json，在 autoload 段添加 PSR-4 映射：
{
"autoload": {
"psr-4": {
"common\": "common/",
"app_v2\": "app_v2/"
}
}
}
然后执行：
立即学习“PHP免费学习笔记（深入）”；
-
composer dump-autoload -o（加-o启用优化模式，生成静态映射表） - 确保目录末尾不带斜杠，命名空间末尾必须带双反斜杠（
"common\"），否则映射失败 - 改完后，
new commonServiceUserService()就会去找common/Service/UserService.php - Linux 环境下大小写敏感，
Common/目录和common命名空间不匹配就会报Class not found
常见错误现象与定位方式
自动加载失败时，别急着改框架配置，先确认是不是路径和命名空间“错位”了：
- 类文件放在
app_v2/controller/Index.php，但命名空间写成namespace app_v2controller;→ 正确应为namespace app_v2controller;（注意大小写），且文件名必须是Index.php（首字母大写，与类名一致） - 执行
composer show看是否真有你写的命名空间条目；运行composer dump-autoload -vvv可看到它实际扫描了哪些路径 - 在控制器里加
echo get_class($this);，输出结果是appcontrollerIndex，说明根本没走你期望的命名空间，得回头检查路由或模块绑定逻辑 - 报错
Warning: require(): failed to open stream或Class 'xxx' not found，大概率是 PSR-4 前缀没对上路径，或dump-autoload没重新运行
Library 目录和 AUTOLOAD_NAMESPACE 是 TP3/5 的遗留方案
TP6+ 中 Library 目录不再自动注册为根命名空间，AUTOLOAD_NAMESPACE 配置也已移除。如果你还在用类似 'My'=>THINK_PATH.'My' 这种写法，它只在 TP3.2 或 TP5.1 有效。TP6 的自动加载流程是：类库映射 → PSR-4 → PSR-0 → 手动 include，而前两步都依赖 Composer。
- TP3 的
Library/Org/Util/Auth.class.php对应OrgUtilAuth，这种约定在 TP6 不再原生支持 - 若必须兼容老代码，得在
composer.json里显式加一条"Org\": "thinkphp/library/Org/" - 所有自定义路径，只要不是
app/或extend/，就必须进composer.json，没有捷径
最易被忽略的一点：改了 composer.json 后，必须重新运行 composer dump-autoload，否则改动完全不生效——这一步不是可选，是强制的。而且上线前务必在目标环境（尤其是 Linux）验证大小写和路径分隔符，Windows 下能跑通不代表生产环境没问题。
