ThinkPHP 中 new AppContractUserInterface 报错是因为 interface 不触发自动加载，必须通过 Composer PSR-4 正确配置 appcontract 命名空间映射并执行 composer dump-autoload -o，且文件名、命名空间、目录名须严格大小写一致。
ThinkPHP 本身不提供“契约类”这个概念——这是 Laravel 的术语，指定义行为接口的 Contract；ThinkPHP 对应的是 interface，且默认不自动加载 interface 文件，除非它被显式引用或符合 PSR-4 路径规则。
为什么 new AppContractUserInterface 会报 Class not found
错误本质不是“契约没加载”，而是 PHP 在解析 new、type-hint 或 implements 时，只对 class 和 trait 触发自动加载，interface 和 enum（PHP 8.1+）**仅在被 implements/extends/use 或类型声明中实际使用时才触发加载**，但前提是该 interface 文件路径必须能被现有自动加载器定位到。
常见现象：Class "AppContractUserInterface" not found，即使文件存在、命名空间正确，也依然报错——大概率是路径没注册进 Composer PSR-4。
- 确认文件真实路径是
app/contract/UserInterface.php（注意目录名小写contract，非Contract） - 检查命名空间是否严格为
namespace appcontract;（末尾无大写 C，大小写敏感） - interface 文件本身不包含
new或运行时逻辑，不会主动触发 autoload；只有当你在控制器里写public function index(UserInterface $user)时，PHP 才会在 DI 容器解析前尝试加载它——此时依赖 Composer 映射
如何让 app/contract/ 下的 interface 被自动加载
ThinkPHP 6+ 完全交由 Composer 管理自动加载，所以必须改 composer.json，不能靠 Loader::addNamespace() 或 appcommon.php 注册。
立即学习“PHP免费学习笔记（深入）”；
在项目根目录的 composer.json 的 "autoload" → "psr-4" 段里添加：
"app\contract\": "app/contract/"
注意：命名空间末尾双反斜杠 \，路径末尾正斜杠 /，二者必须对齐；Windows 下也用 /，PHP 的 require 兼容。
执行命令生效：
composer dump-autoload -o
- 别漏掉
-o，否则开发时可能因未生成优化映射而失效 - 改完
composer.json后，一定要运行该命令；手动改vendor/composer/autoload_psr4.php会被覆盖 - 如果 interface 放在
app/interfaces/这类自定义目录，同样配 psr-4，但命名空间需与目录名一致，例如"app\interfaces\": "app/interfaces/"
契约类（interface）在 ThinkPHP 中的实际使用场景
ThinkPHP 没有 Laravel 那套服务容器自动绑定契约的机制。interface 在 TP 里主要起两作用：类型约束 + 解耦标识，但不会自动实例化。
例如你定义了 appcontractPayment interface，想让不同支付网关实现它：
- 控制器中 type-hint 该 interface，TP 自带的容器 不会自动解析实现类，必须手动 bind：
Container::getInstance()->bind('appcontractPayment', 'appserviceAlipay'); - 若用
thinkContainer的make()，必须提前 bind，否则抛出ClassNotFoundException—— 这个异常不是因为 interface 没加载，而是实现类没注册或找不到 - interface 文件本身从不 new，所以即使没配 autoload，只要没人
implements或 type-hint 它，也不会报错；一旦用了，就必须可加载
最易忽略的一点：interface 文件名必须和 interface 名称完全一致（大小写敏感），比如 UserInterface.php 里必须是 interface UserInterface，不能是 interface userinterface 或 Userinterface；Linux 服务器上一个字母错就直接 500。
