C# Academy · 课时

声明局部函数

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

在方法内部定义辅助函数。 你通过在浏览器中直接运行的动手代码来练习 C# Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

在方法内部定义辅助函数。

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

什么是局部函数

局部函数是在另一个方法内部声明的方法。它只能在包含它的成员内部可见，因此可以让辅助逻辑靠近使用位置，同时不扩展类的成员范围。

声明局部函数

请像编写普通方法一样编写局部函数，并将其嵌套在代码块中。在同一个作用域内，您可以在声明之前或之后调用它。

using System;

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

        Console.WriteLine(Square(4));
        Console.WriteLine(Square(7));
    }
}

使用代码块主体的局部函数

局部函数可以像任何方法一样使用完整的代码块主体，其中包含多条语句、循环和自己的局部变量。

using System;

public class Program
{
    public static void Main()
    {
        int Factorial(int n)
        {
            int result = 1;
            for (int i = 2; i <= n; i++) result *= i;
            return result;
        }

        Console.WriteLine(Factorial(5));
    }
}

提升可读性

局部函数可以为一段逻辑命名，而不必在类中添加只供一个方法使用的私有方法。这样可以让相关代码集中在一起。

using System;

public class Program
{
    public static void Main()
    {
        string Format(string label, int value) => label + ": " + value;

        Console.WriteLine(Format("Score", 90));
        Console.WriteLine(Format("Level", 3));
    }
}

使用局部函数实现递归

局部函数可以调用自身，因此可以在需要递归的位置轻松表达递归逻辑。

using System;

public class Program
{
    public static void Main()
    {
        int Fib(int n) => n < 2 ? n : Fib(n - 1) + Fib(n - 2);

        for (int i = 0; i < 7; i++)
            Console.Write(Fib(i) + " ");
        Console.WriteLine();
    }
}

局部函数可以在使用后声明

与局部变量不同，局部函数可以在方法中先被引用、后声明。编译器会解析整个外层作用域。

using System;

public class Program
{
    public static void Main()
    {
        Console.WriteLine(Greet("Ada")); // used before declared

        string Greet(string name) => "Hello, " + name;
    }
}

参数和返回类型

局部函数支持普通方法所支持的一切功能：多个参数、返回值、ref 和 out 参数，以及泛型。

using System;

public class Program
{
    public static void Main()
    {
        bool TryHalve(int n, out int half)
        {
            half = n / 2;
            return n % 2 == 0;
        }

        if (TryHalve(10, out int result))
            Console.WriteLine("half is " + result);
    }
}

泛型局部函数

局部函数可以是泛型的，使用独立于外层方法的类型参数进行参数化。

using System;

public class Program
{
    public static void Main()
    {
        T Echo<T>(T value)
        {
            Console.WriteLine("echoing " + value);
            return value;
        }

        int n = Echo(42);
        string s = Echo("hi");
        Console.WriteLine(n + " " + s);
    }
}

嵌套局部函数

局部函数自身也可以包含局部函数。内部局部函数只能在其父函数中可见，从而形成作用域非常明确的辅助层次。

using System;

public class Program
{
    public static void Main()
    {
        int Compute(int x)
        {
            int Double(int n) => n * 2;
            int AddOne(int n) => n + 1;
            return Double(AddOne(x));
        }

        Console.WriteLine(Compute(5));
    }
}

使用局部函数验证参数

一种常见模式是：立即验证参数，然后将实际工作延后到局部函数中。对于迭代器而言，这尤其有用，因为参数验证会立即执行。

using System;
using System.Collections.Generic;

public class Program
{
    static IEnumerable<int> Range(int start, int count)
    {
        if (count < 0) throw new ArgumentOutOfRangeException(nameof(count));
        return Iterate();

        IEnumerable<int> Iterate()
        {
            for (int i = 0; i < count; i++) yield return start + i;
        }
    }

    public static void Main()
    {
        foreach (var n in Range(10, 3)) Console.WriteLine(n);
    }
}

何时使用局部函数

当辅助逻辑只被一个方法使用、需要一个描述性名称，或需要访问该方法的局部状态时，可以考虑使用局部函数。这样既能保持类的整洁，也能让相关逻辑易于找到。

using System;

public class Program
{
    public static void Main()
    {
        int total = 0;
        void Add(int n) => total += n; // helper tied to this method
        Add(3); Add(4); Add(5);
        Console.WriteLine(total);
    }
}

快速检查

回想局部函数是什么。

回顾

局部函数是嵌套在方法中的命名辅助函数。

它们只能在包含它们的成员内部可见。
支持参数、返回值、out/ref、泛型和递归。
可以在声明之前被引用。
非常适合只使用一次的辅助逻辑，以及在迭代器中立即验证参数。

常见问题解答

「声明局部函数」课时是免费的吗？

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

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

在方法内部定义辅助函数。你通过在浏览器中直接运行的动手代码来练习 C# Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

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

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

「声明局部函数」课时需要多长时间？

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

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

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

此课程中的所有课时

← 返回 C# Academy