yield return 只能在返回 ienumerable、ienumerator 等特定类型的实例方法或 get 访问器中使用，类型不匹配则编译失败；异步迭代需用 iasyncenumerable；yield break 用于合法终止迭代。
yield 不是语法糖，它是编译器帮你生成状态机的“开关”，用错就直接卡死或无限循环。
yield return 怎么写才不崩：返回值类型和方法签名必须严格匹配
你不能随便在任意方法里写 yield return。它只允许出现在返回类型为 IEnumerable<t></t>、IEnumerator<t></t> 或其非泛型对应类型的**实例方法**或**get 访问器**中。
- 错误写法：
public List<int> GetNumbers() { yield return 1; }</int>—— 编译失败，类型不兼容 - 正确写法：
public IEnumerable<int> GetNumbers() { yield return 1; yield return 2; }</int> - 注意：返回
IEnumerator<t></t>时，需手动调用MoveNext()和Current，一般不推荐；延迟加载场景基本都用IEnumerable<t></t> - 异步方法（
async Task<t></t>）里不能用yield return；要混合异步 + 迭代，得用IAsyncEnumerable<t></t>+yield return（C# 8+）
yield break 在什么时机该用：提前终止迭代的唯一合法方式
yield break 不是“跳出当前循环”，而是“告诉编译器：这次迭代到此为止，别再生成下一个状态了”。它常用于边界控制、空集合短路、条件过滤等场景。
- 常见误用：
for (int i = 0; i —— 看似合理，但一旦 <code>list[0]是null，整个枚举器直接空返回，调用方拿到的是空序列，不是异常 - 典型合理用法：
if (items == null || items.Length == 0) yield break;，避免后续逻辑空引用 - 和
return的区别：return在yield方法里是非法的（编译报错），只有yield break是终止迭代的合法出口
延迟加载怎么体现：每次 MoveNext() 才执行下一段代码
yield 方法体不是在调用时执行，而是在枚举器的 MoveNext() 被调用时，**按需执行到下一个 yield return 或 yield break**。这意味着你可以把耗时操作（如数据库查询、文件读取）放在 yield return 前面，实现真·懒加载。
public IEnumerable<string> ReadLines(string path)
{
using var reader = File.OpenText(path);
string line;
while ((line = reader.ReadLine()) != null)
{
// 每次 MoveNext() 触发一次 ReadLine()
yield return line.Trim();
}
}</string>
- 如果调用方只取前 3 行：
lines.Take(3).ToArray()，那文件只读到第 3 行就停，后面内容完全不加载 - 风险点：
using块会随方法返回而结束，但上面这段代码能跑通，是因为编译器把reader提升为状态机字段并自动实现IDisposable；但如果手动管理非托管资源（比如FileStream未包在using里），容易泄漏 - 不要在 yield 方法里 return 局部数组或列表——那就失去延迟意义了
yield 的真实代价：状态机开销和调试困难点
每次含 yield 的方法被调用，编译器都会生成一个私有嵌套类（比如 <readlines>d__0</readlines>），里面存所有局部变量、当前状态码、堆栈位置。这不是零成本。
- 高频小迭代（比如每帧遍历几个元素）可能比普通
for循环慢 2–5 倍，因为多了装箱、状态跳转、接口虚调用 - 调试时断点不会停在
yield return行，而是停在编译器生成的状态机MoveNext()方法里，堆栈也全是<xxx>d__N</xxx>，新手容易懵 - 无法用
ref、out参数，不能有unsafe块，也不能捕获ref局部变量——这些限制都是为了保证状态机能安全挂起/恢复 - 若逻辑简单且数据量小，直接返回
List<t></t>反而更清晰；yield 的价值只在“数据源大、消费方可能中途退出、或生成过程本身昂贵”时才真正凸显
最常被忽略的一点：yield 方法返回的 IEnumerable<t></t> 是**不可重用的**。一旦开始枚举，内部状态就往前走，再次遍历必须重新调用原方法获取新枚举器——否则你会得到空结果或 InvalidOperationException。
