本地函数是编译期生成独立方法符号的真函数，支持递归、yield return、async，不分配委托；必须在调用前声明，不可重载或泛型推导，静态版禁用局部变量捕获，调试时堆栈名非直观。
本地函数不是语法糖，也不是“写起来更短的 lambda”——它在编译期生成独立方法符号，能递归、支持 yield return 和 async，且不分配委托对象。用错场景或忽略作用域限制，反而会让代码更难调试。
本地函数必须声明在包含方法体内，且不能前置调用
常见错误是把本地函数写在调用语句之后，却期望它像普通方法一样“先声明后使用”。C# 允许在方法任意位置声明本地函数，但调用点必须在声明之后（按执行顺序），否则报 CS0165 “使用了未赋值的局部变量” 或 CS8421 “本地函数不能在声明前被引用”。
- ✅ 正确：声明放在方法末尾，调用在前；或声明在调用之前
- ❌ 错误：
var result = Calc(); int Calc() => 42;—— 这会编译失败 - ⚠️ 注意：即使本地函数没用到外部变量，也不能跨方法调用，哪怕只是静态本地函数
非静态本地函数自动捕获局部变量，但生命周期由外部方法决定
本地函数访问外部方法的局部变量时，C# 编译器会隐式构造闭包类，把变量“提升”为该类的字段。这和 lambda 行为一致，但关键区别在于：本地函数不会强制创建委托实例，所以没有额外堆分配开销。
- 变量被捕获后，其生命周期延长至整个外部方法执行结束，而非仅当前语句块
- 若外部方法返回的是
IEnumerator或IAsyncEnumerable，闭包变量会随迭代器/异步状态机存活，可能引发意料外的内存驻留 - 避免在循环中定义并立即调用本地函数来捕获循环变量（如
for (int i = 0; i Console.WriteLine(i); f(); }），虽然这里不会出错，但容易混淆语义；真要捕获每次迭代值，应显式传参
静态本地函数不能访问局部变量，但可访问参数和 this
加 static 修饰符的本地函数，明确切断与外部方法局部作用域的绑定。它仍可访问外部方法的参数（因为参数本质是方法的“输入局部变量”），也可访问 this（如果外部方法是非静态的），但无法读写任何局部变量。
- 适用场景：纯计算逻辑，输入完全来自参数，无副作用，且你希望向读者强调“此函数不依赖上下文”
- 错误示例：
static int GetX() => x;（x是外部方法的局部变量）→ 编译错误 CS8422 - 性能提示：静态本地函数不会触发闭包类生成，对 GC 更友好；但若本就不需要捕获，又何必用本地函数？此时普通私有方法或
const局部变量可能更直接
本地函数不支持重载、泛型推导或作为委托传递
本地函数名在作用域内唯一，不能同名不同参；也不能像 Func<t></t> 那样参与类型推导；更不能直接赋给委托变量（除非显式转换）。
- ❌ 不支持重载：
void Log(string s) { } void Log(int n) { }→ CS0111 “类型已包含名称为‘Log’的定义” - ❌ 不能用于泛型推导：
List<int>.Find(x => IsEven(x))</int>中的IsEven若是本地函数，编译器无法推导T；必须写成List<int>.Find(IsEven)</int>或显式转换为Func<int bool></int> - ⚠️ 想当委托用？得手动转：
Func<int int> square = x => x * x;</int>是 lambda；而int Square(int x) => x * x; Func<int int> f = Square;</int>会报错，需写成Func<int int> f = Square;</int>（C# 10+ 支持隐式委托转换，但仅限签名完全匹配且无重载）
最易被忽略的一点：本地函数的调试体验和普通方法不同——它不会出现在调用栈的“方法列表”中（Visual Studio 调试器里显示为 `
