thinkphp 6 的自定义命名空间映射必须在项目根目录 composer.json 的 "autoload"."psr-4" 中配置，如 "mylib\": "app/common/mylib/"，修改后需执行 composer dump-autoload；app::bind() 不解决自动加载问题，路径须为静态相对路径，且类文件结构、命名空间声明、大小写须严格匹配 psr-4 规范。
ThinkPHP 6 的 composer.json 自动加载配置在哪改
修改自定义类库的命名空间映射，核心不在 ThinkPHP 配置文件里，而在项目根目录的 composer.json 中。TP6 完全依赖 Composer 的 PSR-4 自动加载机制，框架自身不接管这一层。
常见错误是去改 config/app.php 或试图在 app/Providers/AppServiceProvider.php 里手动注册——这些操作无效，Composer 不会识别。
- 打开项目根目录下的
composer.json - 找到
"autoload"节点（不是"autoload-dev"），在"psr-4"下添加你的命名空间映射 - 例如：把
app/common/MyLib/映射为MyLib\，就加一行"MyLib\": "app/common/MyLib/" - 改完必须运行
composer dump-autoload，否则新路径不会生效
为什么 App::getInstance()->bind() 绑定不了自定义命名空间
因为 App::getInstance()->bind() 只用于容器绑定「已存在」的类或接口，它不参与类文件查找和自动加载过程。命名空间到路径的映射发生在 PHP include 前一刻，由 Composer 的 autoloader 处理。
典型误用场景：写了个 MyLibUtilsStringHelper，在 app/common/MyLib/Utils/StringHelper.php 里，但没在 composer.json 里声明 MyLib 映射，然后试图用 bind('MyLibUtilsStringHelper', ...) 强行注入——结果报错 Class MyLibUtilsStringHelper not found。
- 类找不到的根本原因是自动加载失败，不是容器绑定失败
-
bind()前提是类能被正常 new 出来，否则连绑定入口都进不去 - 如果只是想让某个类走单例或替换实现，先确保它能被自动加载，再考虑
bind()
TP6 中 app_path() 和 base_path() 对路径映射的影响
在 composer.json 的 PSR-4 映射中，路径必须是相对于 composer.json 所在位置（即项目根目录）的相对路径，不能用 app_path() 这类运行时函数。
有人会写 "MyLib\": "app_path()/common/MyLib/"，这会导致 Composer 直接报错：Invalid argument supplied for foreach() 或更隐蔽的 autoload 文件未生成问题。
- 所有路径必须是静态字符串，如
"app/common/MyLib/"、"vendor/myorg/mylib/src/" -
app_path()是 TP6 运行时辅助函数，只在框架启动后可用，对 Composer 加载器完全不可见 - 如果类库放在
vendor/下，优先走 Composer 包管理；放app/下才需要手动加 PSR-4 映射
修改后类仍报 Class not found 的三个高频排查点
即使 composer.json 改了、也执行了 dump-autoload，还是找不到类？大概率卡在这几个地方。
- 类文件末尾缺少
namespace声明，或声明与composer.json中的键不一致（比如映射写的是"MyLib\": "app/common/MyLib/"，但文件里写的是namespace MyLibs\Utils;） - 文件名大小写不匹配：Linux 下
StringHelper.php和stringhelper.php是两个文件，类名StringHelper必须对应首字母大写的文件名 - IDE 缓存或 OPcache 没清：改完
composer.json后，PHP 可能还缓存着旧的 autoload_classmap.php，执行composer dump-autoload -o强制优化并刷新缓存
最麻烦的是命名空间嵌套层级和目录结构没对齐——PSR-4 要求子命名空间必须对应子目录，MyLibUtilsStringHelper 就必须落在 MyLib/Utils/StringHelper.php，少一层目录或多一层都会断掉。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
