ThinkPHP 6 中 thinkCollection 不默认自动加载，因其命名空间未被 Composer 的 PSR-4 映射覆盖；需通过 thinkhelperStr::collection() 调用或手动 require_once 加载，不可直接 new 或 use。
Collection 类在 ThinkPHP 中不是默认自动加载的“核心类”，它属于 thinkCollection，但实际能否直接 new 或 use 成功，取决于你用的是 TP6 还是 TP5，以及是否已触发 Composer 的 PSR-4 映射。
TP6 默认不自动加载 thinkCollection —— 它被定义在 vendor/topthink/framework/src/think/Collection.php，但该文件所属的命名空间 think 并未在 composer.json 的 psr-4 中显式注册（框架自身通过 thinkLoader::addNamespace() 注册，但仅限于框架启动时内部调用）。所以你写 new hinkCollection([]) 会报 Class "thinkCollection" not found，除非满足以下任一条件。
为什么 new hinkCollection() 直接报错？
根本原因不是类不存在，而是 Composer 的自动加载器没把它纳入 PSR-4 映射范围。TP6 的 think 命名空间由框架自己用 Loader::addNamespace('think', ...) 注册，但这个注册只对框架内部生效，**不会暴露给应用层代码的自动加载链**（除非你手动触发或复用 Loader）。
-
thinkCollection文件物理存在，路径正确，命名空间也对 - 但 Composer 的
autoload_psr4.php里没有"think\" => ["vendor/topthink/framework/src/think/"]这条映射 - 所以
spl_autoload_register链里没人能 resolve 到它，class_exists('thinkCollection')返回 false - 即使你在控制器里
use thinkCollection，也会失败——PHP 解析命名空间时就卡住了
TP6 中安全使用 Collection 的两种方式
别硬扛自动加载，直接走明确路径或封装调用：
- 用
thinkhelperStr::collection()：TP6.3+ 提供了这个助手函数，返回一个thinkCollection实例，底层已处理好加载逻辑，推荐首选：$col = hinkhelperStr::collection([1,2,3]);
- 手动 require_once（仅限调试或极简场景）：
require_once vendor_dir . '/topthink/framework/src/think/Collection.php';$col = new hinkCollection([1,2,3]);
注意vendor_dir要替换成真实路径，比如__DIR__.'/../vendor' - 不建议改
composer.json手动加think映射——它和框架启动流程冲突，可能引发重复注册或类覆盖
TP5.1 中 Collection 可以直接 new 吗？
可以，但有条件：
- TP5.1 的
thinkCollection是放在thinkphp/library/think/Collection.php，且框架在初始化时通过Loader::addNamespace('think', LIB_PATH . 'think' . DS)注册了整个think命名空间 - 这意味着只要你没删掉
Loader::register()，new hinkCollection([])就能成功 - 但要注意：TP5.1 默认不启用 Composer 自动加载，它用自己的
thinkLoader；而如果你在 TP5.1 项目中又引入了 Composer，并执行了composer dump-autoload，反而可能干扰原有加载顺序（因为自动加载检测顺序是：类库映射 → PSR-4 → PSR-0） - 验证方法：
var_dump(class_exists('think\Collection'));返回 true 才算真正可用
自定义集合类（如 apputilsMyCollection）怎么让 TP6 自动加载？
必须走 Composer PSR-4，不能依赖框架内部注册：
立即学习“PHP免费学习笔记（深入）”；
- 把类文件放
app/utils/MyCollection.php，顶部声明namespace apputils; - 在
composer.json的"autoload": {"psr-4": {...}}里加一行："app\utils\": "app/utils/"
- 运行
composer dump-autoload -o（-o很关键，否则开发时可能不生效） - 之后就能直接
use apputilsMyCollection;或new apputilsMyCollection(); - 别用
Loader::addNamespace()：TP6 已弃用该方法，且它注册的命名空间不会被 Composer 加载器识别
thinkCollection 是“框架私有类”，它的可用性不取决于文件是否存在，而取决于当前加载器链是否包含它的解析规则。多数人卡在这里，不是因为写错了路径，而是误以为“框架自带 = 自动可用”。 
