📋 yield return 同步迭代器 · 速查表

最简单的迭代器

public IEnumerable<string> GetItems()
{
    yield return "one";
    yield return "two";
    yield return "three";
    // 方法结束 = 隐式 yield break
}

局部变量→字段

所有在 yield return 暂停点之间"存活"的局部变量被提升为状态机类的字段，包括：

• 显式声明的局部变量
• foreach 迭代变量
• using 变量（编译器保证 Dispose 在 finally 中调用）
• 方法参数中非 ref/out 的参数

过滤 模式一

public static IEnumerable<T> Filter<T>(
    IEnumerable<T> source, Func<T, bool> pred)
{
    foreach (var item in source)
        if (pred(item))
            yield return item;
}

无限序列 模式二

public static IEnumerable<long> Fib()
{
    long a = 0, b = 1;
    while (true) { yield return a; (a, b) = (b, a + b); }
}
// 用 Take() 控制——Fib().Take(10)

提前终止 模式三

public static IEnumerable<T> TakeUntil<T>(
    IEnumerable<T> source, Func<T, bool> stopWhen)
{
    foreach (var item in source)
    {
        if (stopWhen(item)) yield break;
        yield return item;
    }
}

资源安全释放 模式四

public IEnumerable<string> ReadLines(string path)
{
    using var reader = new StreamReader(path);
    string line;
    while ((line = reader.ReadLine()) != null)
        yield return line;
    // reader.Dispose() 在 finally 中自动调用
}