80. 反射与 Assembly

上一章会用反射”看”类型。这章更进一步：把整个程序集（assembly，即编译出的 dll/exe）加载进来，动态创建实例、读取特性。这正是插件系统和依赖注入容器的核心手法。

先打个比方：集装箱里的货物

程序集就像一个个集装箱（.dll / .exe），里面整整齐齐码着各种类型”货物”。平时你只跟自己手上的货打交道；而 Assembly 这把”叉车”能打开任意一个集装箱，把里面所有货物名单一一念出来，还能当场把某件货”造”一个出来用。这就是反射加载程序集的直觉。

程序集 Assembly 是什么

程序集是 .NET 的部署单元，一个 .dll 或 .exe 就是一个程序集，里面装着类型与元数据。通过 Assembly 类，你能列举它包含的所有类型。

namespace CSharpDemo;

using System.Reflection;

class Person
{
    public string Name { get; set; } = "";
}

var asm = typeof(Person).Assembly;
Console.WriteLine($"程序集名：{asm.GetName().Name}");
foreach (var type in asm.GetTypes())
    Console.WriteLine($"包含类型：{type.Name}");

用 Activator 动态创建对象

知道 Type 后，不必在代码里写 new 具体类，而是用 Activator.CreateInstance(Type) 在运行时造对象。这叫”晚绑定（late binding）”。

namespace CSharpDemo;

class Greeter
{
    public void Say() => Console.WriteLine("你好，我是动态创建的");
}

Type t = typeof(Greeter);
object? instance = Activator.CreateInstance(t);

if (instance is Greeter g)
    g.Say();

读取特性：让标签活起来

反射不仅能看成员，还能把贴上去的特性读出来。下面定义一个 [Plugin]，再在运行时扫描谁被标了它。

namespace CSharpDemo;

using System.Reflection;

[Plugin("你好插件")]
class HelloPlugin
{
    public void Run() => Console.WriteLine("插件运行中");
}

Type t = typeof(HelloPlugin);
var attr = t.GetCustomAttribute<PluginAttribute>();
if (attr is not null)
    Console.WriteLine($"发现插件：{attr.Name}");

class PluginAttribute : Attribute
{
    public string Name { get; }
    public PluginAttribute(string name) => Name = name;
}

综合：扫描程序集里的所有插件

把”加载程序集 + 遍历类型 + 读特性 + 动态创建”串起来，就是一个迷你插件框架的骨架。

namespace CSharpDemo;

using System.Reflection;

[Plugin("问候插件")]
class HelloPlugin : IPlugin
{
    public void Run() => Console.WriteLine("Hello from plugin");
}

var asm = Assembly.GetExecutingAssembly();
foreach (var type in asm.GetTypes())
{
    if (type.GetCustomAttribute<PluginAttribute>() is { } pluginAttr
        && typeof(IPlugin).IsAssignableFrom(type))
    {
        Console.WriteLine($"加载插件：{pluginAttr.Name}");
        var instance = (IPlugin?)Activator.CreateInstance(type);
        instance?.Run();
    }
}

interface IPlugin
{
    void Run();
}

class PluginAttribute : Attribute
{
    public string Name { get; }
    public PluginAttribute(string name) => Name = name;
}

插件化思路（简述）

真实项目里，这套机制让你做到：主程序不动，把新功能做成独立的 dll 丢进插件目录，启动时扫描加载。好处是”开后门”式扩展，新增能力不用重新编译主程序。代价是反射有性能开销、且类型错误要运行时才暴露，所以一般只在确需灵活的边界使用。

加载外部程序集

前面用当前程序集演示。真实插件场景是从磁盘加载一个 dll：

namespace CSharpDemo;

using System.Reflection;

// 加载同目录下的插件程序集（示意路径）
Assembly pluginAsm = Assembly.LoadFrom("MyPlugin.dll");
foreach (var type in pluginAsm.GetTypes())
    Console.WriteLine($"插件类型：{type.FullName}");

配合反射调用方法

拿到类型和方法后，用 Invoke 在不知道具体类的情况下执行逻辑——和上一章的调用方式一脉相承。

namespace CSharpDemo;

using System.Reflection;

class Greeter
{
    public void Say(string who) => Console.WriteLine($"你好，{who}");
}

Type t = typeof(Greeter);
object obj = Activator.CreateInstance(t)!;
t.GetMethod("Say")!.Invoke(obj, new object[] { "世界" });

泛型类型的反射

反射同样能处理泛型。typeof(List<int>) 拿到的是”已关闭”的泛型类型；想拿”开放”的 List<>，可写 typeof(List<>)，这在写通用框架时很有用。

namespace CSharpDemo;

Type closed = typeof(List<int>);
Type open = typeof(List<>);
Console.WriteLine($"闭合：{closed.Name}");
Console.WriteLine($"开放：{open.Name}");

常见坑与注意事项

其它易错点：

1. GetTypes 可能抛 ReflectionTypeLoadException：程序集里若有加载失败的类型，整个 GetTypes() 会抛异常。健壮代码应捕获它并从 Exceptions 里取出成功加载的部分。
2. 忘记 IsAssignableFrom：扫描插件时直接 CreateInstance 却不检查是否实现接口，造出的对象可能根本调不了你的方法。先 typeof(IPlugin).IsAssignableFrom(type) 兜底。
3. 滥用反射做高频逻辑：每次都 GetTypes + 遍历很慢，插件目录应在启动时扫一次并缓存结果，别在每个请求里重扫。

安全与性能提醒

反射强大也危险：它能绕过访问修饰符（私有也能读）、性能偏低，且类型错误要运行时才暴露。因此：

从目录批量加载插件（思路）

真实插件系统常把 dll 丢进一个 plugins 文件夹，启动时逐个加载、扫描。下面给出骨架（路径仅为示意）：

namespace CSharpDemo;

using System.Reflection;

string pluginDir = "plugins";
if (Directory.Exists(pluginDir))
{
    foreach (string dll in Directory.GetFiles(pluginDir, "*.dll"))
    {
        try
        {
            Assembly asm = Assembly.LoadFrom(dll);
            foreach (var type in asm.GetTypes())
            {
                if (typeof(IPlugin).IsAssignableFrom(type))
                {
                    var instance = (IPlugin?)Activator.CreateInstance(type);
                    instance?.Run();
                }
            }
        }
        catch (Exception ex)
        {
            Console.WriteLine($"加载 {dll} 失败：{ex.Message}");
        }
    }
}

interface IPlugin
{
    void Run();
}

读特性后做”配置化”动作

把”读特性”再推一步：框架扫描到 [Plugin] 后，不只要运行，还能读出特性里的元数据（名称、版本、优先级），据此决定加载顺序或是否启用。这就是”元数据驱动行为”的精髓——逻辑写在标签里，主程序只负责读标签、按标签办事。

配置驱动的思路雏形

把”类型名写在配置文件里，运行时反射加载”组合起来，就是配置驱动（config-driven）的雏形：改配置就能换实现，不必改代码重编译。很多框架的”按配置装配”正是这套思路。

小结

程序集是类型的容器，用 Assembly.GetTypes() 可枚举类型；Activator.CreateInstance(Type) 在运行时造对象；GetCustomAttribute<T>() 把特性读成可行动的数据。三者结合就是插件与 DI 容器的雏形。到这一章，C# 语言核心的”高级探照灯”——反射，你已初步掌握。

---