C#局部函数（Local Function）是C# 7.0引入的特性，允许开发者在一个方法内部定义另一个函数，这个内部函数只能在包含它的方法内被调用，无法从外部访问。这种特性可以让开发者把某个方法内重复的逻辑封装起来，同时避免对外暴露不必要的公共方法。
C#局部函数的基本使用方法
局部函数的定义和普通函数类似，只是它必须放在某个方法的内部，不能和其他类级别的方法平级。局部函数可以包含参数、返回值，也可以访问包含它的方法内的局部变量和参数。
基础语法示例
下面是一个简单的局部函数示例，在CalculateSum方法内部定义了一个Add局部函数，用来计算两个整数的和：
using System;
public class MathHelper
{
public int CalculateSum(int a, int b)
{
// 定义局部函数Add，接收两个int参数，返回int结果
int Add(int x, int y)
{
return x + y;
}
// 调用局部函数
int result = Add(a, b);
return result;
}
}
class Program
{
static void Main()
{
MathHelper helper = new MathHelper();
int sum = helper.CalculateSum(3, 5);
Console.WriteLine(sum); // 输出8
}
}
局部函数访问外部变量的特性
局部函数可以直接访问包含它的方法内的局部变量和参数，不需要额外传递，这一点和匿名方法、Lambda表达式类似：
public void ProcessData(int baseValue)
{
int multiplier = 2;
// 局部函数可以直接使用baseValue和multiplier两个外部变量
int Multiply()
{
return baseValue * multiplier;
}
int result = Multiply();
Console.WriteLine(result);
}
什么时候应该使用Local Function
局部函数并不是所有场景都适用，合理的使用场景才能发挥它的价值，以下是几个适合使用局部函数的情况：
1. 方法内部有重复逻辑需要封装
如果一个方法内部有多次重复的小段逻辑，把这些逻辑抽成局部函数可以避免代码重复，同时不会污染类的公共方法列表。比如下面的例子，方法内多次需要计算平方值：
public double CalculateDistance(double x1, double y1, double x2, double y2)
{
// 局部函数计算平方，避免重复写x*x的逻辑
double Square(double num)
{
return num * num;
}
double deltaX = x2 - x1;
double deltaY = y2 - y1;
return Math.Sqrt(Square(deltaX) + Square(deltaY));
}
2. 逻辑仅对当前方法可见，不需要对外暴露
如果某段逻辑只会被当前方法使用，不需要被类的其他方法或者外部调用，使用局部函数可以限制它的作用域，避免其他开发者误调用，也减少类的公共接口复杂度。比如一个解析数据的方法内部需要一个辅助的校验逻辑，这个校验逻辑只在这个解析方法内使用，就适合定义为局部函数。
3. 需要迭代器方法或者异步方法的内部封装
局部函数支持定义为迭代器方法（使用yield return）或者异步方法（使用async/await），可以在方法内部封装这类特殊逻辑。比如下面的异步局部函数示例：
public async Task<string> GetProcessedDataAsync(string url)
{
// 异步局部函数，用来发送请求并获取响应
async Task<string> FetchDataAsync()
{
using (var client = new System.Net.Http.HttpClient())
{
return await client.GetStringAsync(url);
}
}
string rawData = await FetchDataAsync();
// 处理原始数据
return rawData.ToUpper();
}
不适合使用局部函数的情况
局部函数也有局限性，以下场景不建议使用：
- 如果封装的逻辑需要在多个方法之间复用，应该定义为类的私有方法，而不是局部函数，否则会导致代码重复。
- 如果局部函数的逻辑非常复杂，代码行数很长，会占用包含它的方法的大量空间，反而降低可读性，这种情况建议抽成独立的私有方法。
- 如果需要在局部函数外部修改局部函数内定义的变量，需要注意变量的捕获机制，避免产生意外的副作用，这种情况可以考虑是否用其他方式实现。
局部函数和Lambda表达式的区别
很多开发者会混淆局部函数和Lambda表达式，两者的核心区别如下：
| 对比项 | 局部函数 | Lambda表达式 |
|---|---|---|
| 语法形式 | 和普通函数定义类似，有方法名 | 匿名，使用=>语法 |
| 调用方式 | 直接通过函数名调用 | 需要赋值给委托变量再调用 |
| 递归支持 | 可以直接递归调用自身 | 需要先把Lambda赋值给变量才能递归 |
| 性能 | 编译后和普通方法类似，没有额外委托开销 | 通常会生成委托实例，有一定开销 |
如果逻辑比较简单，不需要递归，也不在意微小的性能差异，用Lambda表达式也可以；如果需要递归、或者希望避免委托开销，优先选择局部函数。
C#局部函数Local_Function函数封装代码复用作用域修改时间：2026-06-12 14:18:28