C#如何使用扩展方法_C#为已有类型动态添加自定义方法【核心】

扩展方法本质上是编译器玩的一出“偷梁换柱”：你以为在调用字符串实例的方法，实际上编译器悄悄把 `s.WordCount()` 翻译成了 `StringExtension.WordCount(s)`。它并不是真的给类型加了成员，只是在调用点做了个语法糖转换。只要可见性、命名空间导入和静态类约束都满足，就能用；但别指望它能访问私有字段或绕过封装。

---

先说说硬性要求：扩展方法必须定义在一个非嵌套的静态类中。这是编译器的铁律，不守规矩直接报 `CS1106: Extension method must be defined in a static class`。常见的翻车姿势包括：把方法写在普通类、泛型类或嵌套类里（比如 `class Outer { static class Inner { ... } }`）；忘了加 `static` 修饰符，哪怕类名带了 `Extensions` 后缀也不行；或者类用了 `internal` 但调用方在另一个程序集，却没有配 `[InternalsVisibleTo]`。 正确写法长这样：

namespace MyLib
{
    public static class StringExtensions  // 必须 public + static + 非嵌套
    {
        public static int WordCount(this string s)
        {
            return string.IsNullOrEmpty(s) ? 0 : s.Split(' ', '.', '?').Length;
        }
    }
}

调用时另一个容易踩的坑：就算你已经引用了扩展方法所在的类库，没写 `using MyLib;`，IntelliSense 里根本看不到这个方法，编译也会报 `CS1061`。关键点是 `using` 命名空间，而不是 `using` 类名。另外，如果多个命名空间里定义了同名扩展方法，编译器会抱怨歧义，这时候只能老老实实走静态方法调用。.NET SDK 项目默认不会自动导入自定义命名空间，别指望“全局 using”能帮你省事。

---

换到 C# 14 的新语法，`extension` 块写起来更紧凑，但约束也更严格。老写法用 `this string s`，新写法用 `extension(string s)` 块来组织多个成员，不过有几个容易漏掉的细节：块内方法不能带 `this` 参数，参数名必须和 `extension` 声明的参数名一致（比如 `extension(string str)` → 方法里直接使用 `str`）；块只能定义在非泛型静态类中，且一个类里只能有一个 `extension` 块对应一种类型。IDE 对新语法的智能提示支持可能还不完善，遇到补全失效，先确认是否升级到 .NET 9+ SDK 和最新版 VS / Rider。 合法示例：

namespace MyLib
{
    public static class StringExtensions
    {
        extension(string s)
        {
            public int WordCount() => s.Split(' ').Length;
            public bool IsLong() => s.Length > 100;
        }
    }
}

---

最后，必须说清楚一个常见误解：扩展方法本质上还是静态方法，运行时和原类型完全解耦，所以它拿不到目标的私有、内部成员（除非用 `[InternalsVisibleTo]` 显式授权）。不能读写 `private` 字段，不能调用 `internal` 方法，也不能重载运算符或覆盖虚方法。如果需求是深度集成，优先考虑继承（对可继承类型）或包装器模式，而不是强行用扩展方法模拟实例行为。 真正需要侵入式增强的场景，比如给 `HttpClient` 加统一日志或重试逻辑，用装饰器或工厂封装更合适，堆一堆扩展方法反而容易制造混乱。