yield return 是 C# 中实现自定义迭代器的简洁高效方式,编译器将其转为状态机支持延迟执行;方法返回 IEnumerable 或 IEnumerator,不可含 return 语句(除 yield break)、ref/out 参数或 try-catch 包裹 yield;适用于大数据、IO 流及无限序列。

在C#中,yield return 是实现自定义迭代器最简洁、高效的方式,它让方法能逐个返回元素,而无需手动实现 IEnumerable 和 IEnumerator 接口。
yield return 的基本用法
标记为 yield return 的方法必须返回 IEnumerable 或 IEnumerator,且不能有 return 语句(除 yield break 外),也不能有 ref/out 参数或 try-catch 包裹 yield 语句(但可在 try 外或 finally 中使用)。
编译器会将该方法自动转换为一个状态机类,支持延迟执行和按需生成数据。
- 每次调用
MoveNext()时,代码从上一次暂停处继续执行,直到下一个yield return或方法结束 - 值在真正遍历时才计算,适合处理大数据、IO 流或无限序列
- 方法内可混合普通逻辑与
yield return,比如条件判断、循环嵌套
简单示例:生成斐波那契数列前 N 项
以下方法返回前 n 个斐波那契数:
public static IEnumerableFibonacci(int n) { long a = 0, b = 1; for (int i = 0; i < n; i++) { yield return a; long temp = a + b; a = b; b = temp; } }
调用方式:foreach (var x in Fibonacci(10)) Console.WriteLine(x); —— 每次只算一个数,不预先分配数组。
配合条件和嵌套循环的实用写法
比如遍历二维数组并跳过空值:
public static IEnumerableFlattenAndFilter(string[,] matrix) { if (matrix == null) yield break; int rows = matrix.GetLength(0); int cols = matrix.GetLength(1); for (int i = 0; i < rows; i++) { for (int j = 0; j < cols; j++) { string val = matrix[i, j]; if (!string.IsNullOrEmpty(val)) yield return val; } }}
也可用
yield break提前退出整个迭代,相当于“return”。注意点和常见误区
yield return方法不是普通方法调用——它不立即执行,而是返回一个可枚举对象;只有在foreach、ToList()、First()等触发遍历时才开始运行。
- 不要在
yield方法中捕获局部变量用于异步/多线程场景(闭包变量会被共享),需小心生命周期- 无法在
catch块中使用yield return,但可在try内或外分别处理- 调试时注意:断点可能不会在首次调用方法时命中,而是在第一次
MoveNext()时才进入基本上就这些。用好
yield return,能让集合处理更轻量、更清晰、更符合 C# 的惯用风格。










