EF Core 中 List.Contains() 自动翻译为 SQL IN 语句，支持多种类型；字符串的 .Contains() 对应 LIKE 模糊匹配，二者不可混淆，需注意空集合、参数数量限制及大数据量优化策略。
EF Core 中实现 Contains 查询，本质就是把 C# 的 List.Contains() 转成 SQL 的 IN 语句。只要写法规范，EF Core 会自动翻译，不需要手写原生 SQL。
用 List.Contains 实现 IN 查询（最常用）
这是最自然、推荐的方式。EF Core 支持对本地集合（如 List、string[]）调用 Contains，并正确生成 WHERE ... IN (...)。
示例：
var ids = new List{ 1, 5, 8, 12 }; var users = context.Users .Where(u => ids.Contains(u.Id)) .ToList();
✅ 生成的 SQL 类似：SELECT * FROM Users WHERE Id IN (1, 5, 8, 12)
注意点：
- 集合不能是
null，否则运行时报错；建议先判空或用ids.Any() ? ... : Enumerable.Empty() - 集合大小无硬性限制，但 SQL Server 对
IN子句参数数量有默认上限（约 2100 个），超量时可分批查询或改用临时表/表值参数 - 支持
string、Guid、DateTime等类型，只要数据库能比较即可
对字符串字段做模糊 Contains（不是 IN！别混淆）
⚠️ 注意：如果想查“用户名包含某个子串”，那是 string.Contains()，对应 SQL 的 LIKE '%xxx%'，和 IN 完全无关。
示例：
var keyword = "admin";
var users = context.Users
.Where(u => u.Name.Contains(keyword)) // ✅ 模糊匹配
.ToList();
❌ 错误写法（不会报错但逻辑不对）：
.Where(u => new[] { "admin", "test" }.Contains(u.Name)) // 这才是 IN 查询，查 Name 是否等于某几个固定值
用 EF.Functions.Like 做更灵活的字符串匹配
如果需要类似 IN + 模糊组合（比如多个前缀匹配），可用 EF.Functions.Like 配合 OR：
var prefixes = new[] { "adm%", "test%", "dev%" };
var users = context.Users
.Where(u => prefixes.Any(p => EF.Functions.Like(u.Name, p)))
.ToList();
✅ 生成类似：WHERE Name LIKE 'adm%' OR Name LIKE 'test%' OR Name LIKE 'dev%'
大数据量时的优化建议
当要查几百上千个 ID 时，直接传大集合可能触发性能或参数限制问题：
- 拆分成每 1000 个一批，用
Union或循环查询后合并 - 把 ID 列表插入临时表，再用
JOIN查询（适合极大量，需手动执行 SQL 或使用FromSqlRaw） - 用内存过滤（仅限数据已加载到内存后）：
context.Users.ToList().Where(u => ids.Contains(u.Id))—— 但不推荐，会全表拉取
基本上就这些。核心记住：C# 侧用 list.Contains(xxx) → 自动变 SQL 的 IN；字符串自身的 .Contains() → 变 LIKE。别混用，逻辑和性能差很远。