C# Academy · 课时

静态局部函数

Q: 「静态局部函数」这节课中我会学到什么？

避免捕获，以提升清晰度和性能。 你通过在浏览器中直接运行的动手代码来练习 C# Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

避免捕获，以提升清晰度和性能。

静态局部函数 是 CoddyKit 上的免费 C# Academy 课时。这是第 3 节课，共 4 节。你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。这是 C# Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 C# Academy 课程共包含 4 节课。

静态局部函数

将局部函数标记为 static 后，它就不能捕获任何外层变量或 this。这使函数自包含、意图更清晰，也不会产生隐藏的闭包分配。

声明静态局部函数

请在返回类型前添加 static 修饰符。函数仍然可以接收参数并返回值，只是不能访问外层局部变量。

using System;

public class Program
{
    public static void Main()
    {
        static int Square(int n) => n * n; // captures nothing

        Console.WriteLine(Square(6));
    }
}

禁止捕获

静态局部函数不能使用外层局部变量。它所需的一切都必须作为参数传入，这会使其输入更加明确。

using System;

public class Program
{
    public static void Main()
    {
        int factor = 3;
        // factor must be passed in, not captured
        static int Scale(int n, int f) => n * f;

        Console.WriteLine(Scale(5, factor));
    }
}

避免隐藏的分配

捕获变量的非静态局部函数可能会分配隐藏的闭包对象。静态局部函数从不捕获变量，因此可以完全避免这种分配。

using System;

public class Program
{
    public static void Main()
    {
        // Pure helper, no closure object created
        static bool IsEven(int n) => n % 2 == 0;

        for (int i = 0; i < 5; i++)
            Console.WriteLine(i + ": " + IsEven(i));
    }
}

意图自明

static 关键字向读者表明，该辅助函数只依赖自身的参数。这一保证让函数更容易理解和测试。

using System;

public class Program
{
    public static void Main()
    {
        static int Clamp(int value, int lo, int hi)
            => value < lo ? lo : value > hi ? hi : value;

        Console.WriteLine(Clamp(15, 0, 10));
        Console.WriteLine(Clamp(-3, 0, 10));
    }
}

由编译器强制禁止捕获

如果您意外地在静态局部函数中引用外层局部变量，编译器会报告错误。这可以尽早发现非预期的依赖。

using System;

public class Program
{
    public static void Main()
    {
        int seed = 7;
        // Correct: seed is passed explicitly, not captured
        static int Mix(int x, int s) => x * 31 + s;

        Console.WriteLine(Mix(2, seed));
    }
}

静态局部函数中的递归

静态局部函数仍然支持递归，因为调用自身并不等同于捕获变量。

using System;

public class Program
{
    public static void Main()
    {
        static int Power(int baseN, int exp)
            => exp == 0 ? 1 : baseN * Power(baseN, exp - 1);

        Console.WriteLine(Power(2, 10));
    }
}

结合输出参数使用

与任何方法一样，静态局部函数可以使用 out 参数；这与其不捕获变量的纯粹性结合得很好，适合实现尝试解析风格的辅助函数。

using System;

public class Program
{
    public static void Main()
    {
        static bool TryParsePositive(string s, out int value)
        {
            value = 0;
            return int.TryParse(s, out value) && value > 0;
        }

        if (TryParsePositive("42", out int n))
            Console.WriteLine("got " + n);
        Console.WriteLine(TryParsePositive("-1", out _));
    }
}

将静态局部函数作为委托传递

由于静态局部函数不会捕获任何内容，因此将其转换为委托时无需分配闭包；在性能关键路径中，这一点可能很重要。

using System;
using System.Collections.Generic;
using System.Linq;

public class Program
{
    public static void Main()
    {
        static bool IsBig(int n) => n > 100;

        var nums = new List<int> { 50, 150, 200, 10 };
        Console.WriteLine(nums.Count(IsBig));
    }
}

何时优先使用静态局部函数

只要辅助函数不需要外层状态，就应优先使用静态局部函数。它可以表明函数的纯粹性、防止意外捕获，并且可能更高效。只有确实需要捕获局部变量时，才去掉 static。

using System;

public class Program
{
    public static void Main()
    {
        static string Describe(int score)
        {
            if (score >= 90) return "A";
            if (score >= 80) return "B";
            return "C";
        }

        Console.WriteLine(Describe(95));
        Console.WriteLine(Describe(82));
    }
}

动手实践

编写一个纯粹的静态局部函数，并将它作为谓词传递给 LINQ。由于它不会捕获任何内容，因此转换为委托时无需闭包。

using System;
using System.Collections.Generic;
using System.Linq;

public class Program
{
    public static void Main()
    {
        static bool IsLeapYear(int year)
            => (year % 4 == 0 && year % 100 != 0) || year % 400 == 0;

        var years = new List<int> { 1900, 2000, 2004, 2021, 2024 };
        Console.WriteLine(string.Join(", ", years.Where(IsLeapYear)));
    }
}

快速检查

回想静态修饰符为局部函数增加了什么。

回顾

static 局部函数不会捕获任何内容。

它不能使用外层局部变量或 this；请通过参数传递数据。
它可以避免隐藏的闭包分配。
编译器会强制执行禁止捕获的规则，从而发现意外的依赖。
只要辅助函数不需要外层状态，就应优先使用它。

常见问题解答

「静态局部函数」课时是免费的吗？

是的 — 「静态局部函数」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 C# Academy 课程的其余内容，请升级到 CoddyKit PRO。 C# Academy 课程共包含 4 节课。

「静态局部函数」这节课中我会学到什么？

避免捕获，以提升清晰度和性能。你通过在浏览器中直接运行的动手代码来练习 C# Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 C# Academy 需要有经验吗？

无需任何先前经验。CoddyKit 上的 C# Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。这是第 3 节课，共 4 节。

「静态局部函数」课时需要多长时间？

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。

我能在这节 C# Academy 课中编写并运行代码吗？

能。每节 C# Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

← 返回 C# Academy