yield return 是 C# 中实现自定义迭代器的简洁高效方式，编译器将其转为状态机支持延迟执行；方法返回 IEnumerable 或 IEnumerator，不可含 return 语句（除 yield break）、ref/out 参数或 try-catch 包裹 yield；适用于大数据、IO 流及无限序列。
在C#中，yield return 是实现自定义迭代器最简洁、高效的方式，它让方法能逐个返回元素，而无需手动实现 IEnumerable<t></t> 和 IEnumerator<t></t> 接口。
yield return 的基本用法
标记为 yield return 的方法必须返回 IEnumerable<t></t> 或 IEnumerator<t></t>，且不能有 return 语句（除 yield break 外），也不能有 ref/out 参数或 try-catch 包裹 yield 语句（但可在 try 外或 finally 中使用）。
编译器会将该方法自动转换为一个状态机类，支持延迟执行和按需生成数据。
- 每次调用
MoveNext()时，代码从上一次暂停处继续执行，直到下一个yield return或方法结束 - 值在真正遍历时才计算，适合处理大数据、IO 流或无限序列
- 方法内可混合普通逻辑与
yield return，比如条件判断、循环嵌套
简单示例：生成斐波那契数列前 N 项
以下方法返回前 n 个斐波那契数：
public static IEnumerable<long> Fibonacci(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 IEnumerable<string> FlattenAndFilter(string[,] matrix)
{
if (matrix == null) yield break;
<pre class="brush:php;toolbar:false;">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# 的惯用风格。
