thinkphp6自动加载路径由composer.json的psr-4规则决定，而非config/app.php配置；修改app_namespace仅影响路由解析，不参与类加载；必须严格遵循命名空间与物理路径一致，并执行composer dump-autoload -o生效。
ThinkPHP 的自动加载路径不是靠某个配置项“指定”，而是由 Composer 的 composer.json 和类文件的物理位置共同决定的；手动改 config/app.php 里的 app_namespace 或写 Loader::addNamespace() 基本无效，尤其在 TP6+。
自动加载路径实际由 composer.json 的 psr-4 规则控制
TP6+ 默认不依赖 ThinkPHP 自己的 Loader 做命名空间映射，而是把自动加载全交给 Composer。这意味着：路径映射规则只存在于项目根目录的 composer.json 文件中，且必须是 "psr-4" 段下的声明。
- 正确写法示例：
"App\": "app/"（注意双反斜杠转义，末尾带斜杠） - 错误写法：
"App": "app/"（缺反斜杠，命名空间解析失败）、"App\": "./app/"（带点号，Composer 不认相对路径符号） - 路径必须是相对于项目根目录的，不能是绝对路径，也不能含
./或../ - 改完后必须运行
composer dump-autoload -o，否则新类不生效（开发阶段加-o反而更稳，别信“只上线才加”的说法）
为什么改了 app_namespace 还不生效？
app_namespace 在 config/app.php 中仅影响路由解析和默认模块/控制器定位逻辑，比如 URL /index 对应哪个类，但它不参与 Composer 的类查找过程。即使你设成 "app_v2"，只要 composer.json 里没配 "app_v2": "app_v2/"，new 一个 app_v2serviceFoo 仍会报错。
- 它只在
thinkApp::module()、thinkRoute::parseUrl()等运行时路径拼接中起作用 - 对
new appserviceBar()、use apputilsHelper这类直接 new/use 的场景完全无感 - 如果你同时用了
Loader::addPsr4('common', APP_PATH . 'common/')，那它和 Composer 的 PSR-4 是两套并行机制，容易冲突——优先级取决于注册顺序，调试时极难复现
vendor 里第三方包加载失败，问题不在 ThinkPHP
报 Class "OvertruePinyinPinyin" not found，90% 是因为 vendor/autoload.php 没被入口文件引入，或者该包自己的 composer.json 没声明 autoload 规则。
- 检查
public/index.php是否有这行：require __DIR__ . '/../vendor/autoload.php';（TP6 默认有，但有人删了） - 进 vendor/overtrue/pinyin/composer.json，确认里面有类似
"psr-4": { "Overtrue\Pinyin\": "src/" } - 如果包用的是
classmap，必须跑composer dump-autoload -o才能生成映射，光dump-autoload不够 - 别在
extend/下放包还指望自动加载——那里默认不注册，得手动加到composer.json的 psr-4 里
最常被忽略的一点：Linux 服务器上大小写敏感，app/controller/Index.php 里写 namespace appcontroller; 是对的，但写成 AppController 或 appController 就直接失败——Windows 开发机测不出，一上线就炸。路径、命名空间、文件名，三者必须严格一致，一个字母都不能错。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
