本文介绍如何在已获取的 laravel 集合（而非重新查询数据库）中，基于指定字段值（如 `pr_code`）高效检索单个匹配项，重点使用 `firstwhere()` 等集合原生方法。

当你已通过 Projects::all() 加载全部项目到内存形成 Eloquent 集合后，若需从中查找 pr_code 为 1234 的项目，无需再次发起数据库查询——Laravel 集合提供了语义清晰、性能良好的链式方法来完成此操作。

最推荐的方式是使用 firstWhere() 方法：

$projects = Projects::all();
$targetProject = $projects->firstWhere('pr_code', 1234);

✅ firstWhere() 是专为“按字段值查找首个匹配项”设计的集合方法，内部自动遍历并返回第一个满足条件的模型（未找到则返回 null），简洁且可读性极强。

你也可以拆解为两步组合使用（等效但略冗长）：

Laravel Cloud

Laravel Cloud（cloud.laravel.com）。此技能用于处理所有 Laravel Cloud 请求，包括搜索和读取数据。只要任务涉及 Laravel Cloud，即使用此技能。

下载

$targetProject = $projects->where('pr_code', 1234)->first();

其中 where() 返回一个过滤后的新集合，first() 从中取首项——功能正确，但 firstWhere() 更语义化、性能略优（底层可提前终止遍历）。

⚠️ 注意事项：

• firstWhere() 自 Laravel 5.3+ 起可用；若使用旧版本，请升级或改用 where(...)->first()；
• 所有集合操作均在 PHP 内存中执行，因此适用于数据量适中（如数百条）的场景；若集合过大，建议优先考虑数据库层过滤（如 where()->first()），避免内存与性能开销；
• 字段名区分大小写，确保 'pr_code' 与模型实际属性/数据库列名一致；
• 若需查找多个匹配项，可使用 where() 或 filter()；若需严格匹配（含类型），可传入第三个参数 true：firstWhere('pr_code', '1234', true)。

总结：在已有集合上做查找，首选 collection->firstWhere('key', $value) —— 它精准、高效、符合 Laravel 惯例，是集合操作的最佳实践之一。