直接用 composer require illuminate/collections 即可安装，无需 laravel 框架，支持 php 8.0+；务必用 collect() 而非 new collection()，filter() 默认剔除 falsy 值，reject() 需回调才生效；嵌套提取用 pluck→flatten→pluck→unique 链式调用；注意 dd()/toarray() 等会触发惰性集合全量计算。
非 Laravel 项目中安装 illuminate/collections
直接用 composer require illuminate/collections 就行，别装错包。它不依赖 Laravel 全栈框架，只依赖 PHP 8.0+ 和几个基础组件（如 symfony/var-dumper），在纯 CLI 工具、微服务或遗留系统里都能跑。
注意两点：
– 不要手动 new Collection()，始终用 collect() 工厂函数，它会自动处理空值、Traversable 类型和类型提示；
– 安装后无需任何注册或引导逻辑，collect([1,2,3]) 立刻可用。
filter() 和 reject() 的行为差异必须厘清
这两个方法看起来对称，但新手常因语义混淆写出 bug：
-
filter()默认剔除所有 falsy 值（null、false、0、''），传空回调时行为一致；Laravel 10 起禁止传null，必须显式写filter()或filter(fn($v) => (bool)$v) -
reject()必须带回调才有意义，否则等价于保留全部——它不是“反向 filter”，而是“排除满足条件的项” - 示例：
collect([0, 1, false, 'ok'])->filter()返回[1, 'ok']；而collect([0, 1, false])->reject(fn($v) => $v === 0)只剔除0，返回[1, false]
嵌套数据提取别硬写 foreach，用 pluck + flatten + unique 组合
面对 ['orders' => [['items' => [['supplier' => 'A'], ['supplier' => 'B']]], ['items' => [['supplier' => 'A']]]]] 这类结构，pluck('items.*.supplier') 会失败——pluck() 不支持通配符。
正确链路是：
- 先
pluck('items')拿到二维集合 - 再
flatten()拉平成一维 - 然后
pluck('supplier')提取字段 - 最后
unique()去重
整条链： collect($data)->pluck('items')->flatten()->pluck('supplier')->unique()。中间任意一步都可加 filter() 清洗空值，比如 ->filter()->unique() 避免 null 干扰去重。
惰性求值陷阱：dd()、dump()、toArray() 会提前触发计算
Collection 默认惰性求值，但只要遇到 dd()、dump()、toArray()、json_encode() 或循环遍历（foreach），整个链就会立刻执行并加载全部数据到内存。
大数据量下这很危险——比如处理 20 万条日志时，在 map() 后插个 dd()，等于强制把全部中间结果实例化出来。
调试建议：
– 用 ->take(5)->all() 截断查看样本
– 把链拆成变量分步赋值，每步只调 count() 或 first() 观察形态
– 真要全量看，确保数据量可控，或改用 LazyCollection 替代
