C# Academy · 课时

扩展方法解析

Q: 「扩展方法解析」这节课中我会学到什么？

了解编译器如何查找扩展方法。 你通过在浏览器中直接运行的动手代码来练习 C# Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

了解编译器如何查找扩展方法。

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

编译器如何查找扩展

当您编写 value.Method() 且没有匹配的实例方法时，编译器就会查找扩展方法。但它只会考虑所属命名空间通过 using 指令处于作用域内的扩展。

using 指令将扩展引入作用域

只有导入扩展所在的命名空间后，扩展才可见。如果没有正确的 using，即使该方法已编译到程序集中，也会看起来像不存在一样。

using System;
using MyHelpers; // brings StringExtensions into scope

namespace MyHelpers
{
    public static class StringExtensions
    {
        public static string Reverse(this string s)
        {
            var arr = s.ToCharArray();
            Array.Reverse(arr);
            return new string(arr);
        }
    }
}

public class Program
{
    public static void Main()
    {
        Console.WriteLine("hello".Reverse());
    }
}

先检查实例方法

编译器会分阶段解析调用：首先搜索匹配的实例方法，包括继承的方法。只有没有合适的实例方法时，才会搜索扩展方法。

using System;
using System.Collections.Generic;

public static class ListExt
{
    // Ignored: List<int> already has Add(int)
    public static void Add(this List<int> list, int a, int b)
        => list.Add(a + b);
}

public class Program
{
    public static void Main()
    {
        var list = new List<int>();
        list.Add(5); // the built-in instance Add wins for this signature
        Console.WriteLine(list[0]);
    }
}

优先选择更近的命名空间

如果两个扩展都匹配，则嵌套层级中命名空间更近的扩展胜出。如果编译器无法消除歧义，就会产生编译错误，迫使您明确指定要使用的扩展。

using System;

namespace Outer
{
    public static class A { public static string Tag(this int n) => "A" + n; }

    namespace Inner
    {
        public static class B { public static string Tag(this int n) => "B" + n; }

        public class Program
        {
            public static void Main()
            {
                // B is in the nearer (Inner) namespace, so it is preferred
                Console.WriteLine(7.Tag());
            }
        }
    }
}

使用静态调用消除歧义

当扩展发生冲突或您希望明确指定时，可以使用完整的类名直接调用静态方法。这样会完全绕过扩展解析。

using System;

public static class FormatExt
{
    public static string Bracket(this string s) => "[" + s + "]";
}

public class Program
{
    public static void Main()
    {
        // Explicit static call, no ambiguity possible
        Console.WriteLine(FormatExt.Bracket("x"));
    }
}

扩展之间的重载解析

如果多个扩展方法同名，正常的重载解析会根据参数类型选择最佳匹配，就像普通的方法重载一样。

using System;

public static class PrintExt
{
    public static string Describe(this int n) => "int:" + n;
    public static string Describe(this string s) => "str:" + s;
}

public class Program
{
    public static void Main()
    {
        Console.WriteLine(42.Describe());
        Console.WriteLine("hi".Describe());
    }
}

解析期间的泛型推断

对于泛型扩展，编译器会根据接收对象和参数推断类型参数。如果推断失败，就不会考虑该扩展。

using System;
using System.Collections.Generic;

public static class SeqExt
{
    public static T FirstItem<T>(this IEnumerable<T> source)
    {
        foreach (var item in source) return item;
        throw new InvalidOperationException("empty");
    }
}

public class Program
{
    public static void Main()
    {
        var nums = new List<int> { 5, 6, 7 };
        // T inferred as int from the List<int> receiver
        Console.WriteLine(nums.FirstItem());
    }
}

全局 using 与隐式导入

现代 C# 可以声明 global using 指令，使某个命名空间在整个项目中都处于作用域内。这样，无需重复导入，就能在任何地方使用共享的扩展库。

using System;

// In a real project a separate file might say: global using MyHelpers;
namespace MyHelpers
{
    public static class IntExt { public static int Twice(this int n) => n * 2; }
}

public class Program
{
    public static void Main()
    {
        // Works here because MyHelpers is referenced explicitly
        Console.WriteLine(MyHelpers.IntExt.Twice(8));
    }
}

接收对象类型何时起作用

解析取决于接收对象的静态类型，而不是其运行时类型。即使变量保存的是派生类型的实例，为基类型声明的扩展仍然适用，除非作用域中存在更具体的扩展。

using System;

public class Animal { }
public class Cat : Animal { }

public static class AnimalExt
{
    public static string Kind(this Animal a) => "animal";
}

public class Program
{
    public static void Main()
    {
        Animal a = new Cat();
        // Chosen by static type Animal
        Console.WriteLine(a.Kind());
    }
}

解析过程的思维模型

可以将顺序理解为：(1) 实例方法；然后是 (2) 从导入的命名空间中查找扩展方法，并优先考虑更近的命名空间；最后是 (3) 在候选项之间进行重载解析。了解这个顺序，几乎可以解释所有令人意外的结果。

using System;

public static class Ext
{
    public static string Wrap(this string s) => "<" + s + ">";
}

public class Program
{
    public static void Main()
    {
        // No instance Wrap exists, so the extension is used
        Console.WriteLine("node".Wrap());
    }
}

亲自尝试

在一个命名空间中定义扩展，导入该命名空间，然后调用扩展。接着以静态方法的形式显式调用同一个方法，观察这两种调用路径都能正常工作。

using System;
using Text.Helpers;

namespace Text.Helpers
{
    public static class StringExtensions
    {
        public static int Vowels(this string s)
        {
            int count = 0;
            foreach (var c in s.ToLower())
                if ("aeiou".IndexOf(c) >= 0) count++;
            return count;
        }
    }
}

public class Program
{
    public static void Main()
    {
        Console.WriteLine("education".Vowels());
        Console.WriteLine(Text.Helpers.StringExtensions.Vowels("education"));
    }
}

快速检查

思考是什么让扩展方法变得可见。

回顾

扩展方法解析遵循清晰的顺序。

先尝试实例方法；扩展只负责填补缺失的功能。
只有当扩展所在的命名空间通过 using 或 global using 处于作用域内时，扩展才可见。
更近的命名空间优先；无法解决的平局会导致编译错误。
您始终可以显式调用静态方法来消除歧义。
解析使用接收对象的静态类型。

常见问题解答

「扩展方法解析」课时是免费的吗？

是的 — 「扩展方法解析」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 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