SearchValues.Create 为什么比 Contains 更快
因为
SearchValues<char></char>把多个待查字符串预处理成位图或哈希索引，避免每次扫描都重复遍历所有目标词。普通
Contains或
IndexOfAny在查 5 个关键词时，每行要调 5 次；而
SearchValues一次扫描就能标记出所有匹配位置。
适用场景：日志解析、配置文件关键词提取、CSV/TSV 行内多字段定位。
只支持char和
string两种泛型参数，查子串必须用
SearchValues<string></string>，不能混用
SearchValues.Create(new[] { "ERROR", "WARN", "INFO" }) 会自动去重并优化内部结构，但传入 null 或空字符串会抛 ArgumentException在 .NET 8 中，
SearchValues<string></string>对短字符串（≤ 16 字节）启用 SIMD 加速，长字符串回退到高效哈希匹配
File.ReadLines + SearchValues.FindFirstCharacterOrValue 怎么配合用
直接对大文件逐行读取 + 检查首字符或关键词存在性，是内存友好且能 early-exit 的组合。别用
File.ReadAllLines加载全量再查 —— 即使文件只有 100MB，也可能触发 GC 压力。
常见错误：把
FindFirstCharacterOrValue当成“找完整子串”，其实它只返回第一个匹配的起始索引（或 -1），不区分是单字符还是整个字符串命中。 先用
SearchValues<string>.Create(new[] { "StatusCode:", "UserAgent:", "X-Request-ID:" })</string>
对每行调 values.FindFirstCharacterOrValue(line)，返回 ≥ 0 表示该行含任一关键词 若需定位具体是哪个词，再用
line.AsSpan().IndexOfAnyValues(values)获取详细偏移和匹配值 注意：如果某行含 "Status" 和 "StatusCode:"，
FindFirstCharacterOrValue只返回第一个匹配位置，不会告诉你匹配的是哪个
IndexOfAnyValues 返回值怎么解读才不踩坑
IndexOfAnyValues返回的是
Range类型（.NET 8 新增），不是整数索引。直接打印或比较会得到类似
[12..19]的结果，不是你想要的起始位置。
使用场景：需要精确提取匹配关键词前后上下文，比如截取 HTTP header 值、提取 JSON key 对应的 value 片段。
正确解包方式：var range = line.AsSpan().IndexOfAnyValues(values); int start = range.Start;如果没匹配，
range是
Range.Empty，此时
range.Start == 0但
range.Length == 0，不能只判
start == 0搭配
line.AsSpan()[range]可直接拿到匹配到的原始字符串（如 "UserAgent:"），无需额外
Substring性能提示：反复调用
IndexOfAnyValues时，确保
values是复用对象，不要每行都
Create新实例
跨平台文件路径和编码问题怎么绕开
SearchValues本身不处理编码，它只操作
ReadOnlySpan<char></char>。所以真正出错的地方往往在读文件这一步 —— 比如用默认编码读 UTF-8 BOM 文件，导致第一行乱码，关键词永远匹配不上。
Windows 上常见现象：
File.ReadLines("log.txt") 返回的行开头多出 \uFEFF，让
"ERROR"查不到。 统一用
File.ReadLines(path, Encoding.UTF8)，显式指定编码，尤其处理日志、配置等文本文件 路径分隔符不用自己替换，
Path.Join和
Path.DirectorySeparatorChar在 .NET 8 已足够健壮 如果文件可能含 BOM，用
StreamReader构造时传
detectEncodingFromByteOrderMarks: true更稳妥 别依赖
File.Exists做前置判断 —— 它在某些容器环境或网络路径下可能不准，直接 try/catch
FileNotFoundException更实际
最麻烦的其实是混合编码日志：一部分是 GBK，一部分是 UTF-8。这时候
SearchValues再快也没用，得先做编码探测。那已经不是查找问题，而是输入清洗问题了。
