如何为第三方库的数据容器类动态创建包装类？

算力阿峰

2026-5-26

嘿，这个需求我太懂了——手动写10个几乎一样的数据容器包装类，简直是重复劳动到崩溃！咱们来聊聊几个能帮你省大把力气的方案，完全不用手动敲每个类和字段：

方案1：代码生成工具（最推荐的静态方案）

这种方式能帮你自动生成编译好的包装类代码，既没有运行时性能损耗，又能完全隔离第三方库的依赖，完美匹配你的需求。

T4 模板（Visual Studio 内置支持）：你可以写一个T4模板，遍历第三方库中那10个容器类的元数据（用反射或者Roslyn分析），然后自动生成对应的包装类代码。每个包装类内部持有一个第三方类的实例，所有属性/字段都做转发，对外暴露的是你自己的类型，客户端完全看不到第三方库的痕迹。
举个简化的T4片段示例：

<#@ template debug="false" hostspecific="true" language="C#" #>
<#@ assembly name="System.Core" #>
<#@ import namespace="System.Reflection" #>
<#
    var thirdPartyAssembly = Assembly.LoadFrom(@"路径\第三方库.dll");
    var containerTypes = thirdPartyAssembly.GetTypes().Where(t => t.Name.Contains("Container")); // 根据你的实际情况筛选
#>
namespace YourLibrary.Wrappers {
<# foreach (var type in containerTypes) { #>
    public class <#= type.Name #>Wrapper {
        private readonly <#= type.FullName #> _innerInstance;

        public <#= type.Name #>Wrapper(<#= type.FullName #> innerInstance) {
            _innerInstance = innerInstance;
        }

<# foreach (var prop in type.GetProperties(BindingFlags.Public | BindingFlags.Instance)) { #>
        public <#= prop.PropertyType.FullName #> <#= prop.Name #> {
            get => _innerInstance.<#= prop.Name #>;
            set => _innerInstance.<#= prop.Name #> = value;
        }
<# } #>
    }
<# } #>
}

只要运行这个模板，就能一键生成所有包装类，后续第三方类有更新，重新运行模板就行。

Roslyn 代码生成器：如果需要更灵活的逻辑（比如处理特殊属性、添加自定义逻辑），可以写一个Roslyn源代码生成器，在编译时自动生成包装类。这种方式比T4更集成化，适合长期维护的项目。

方案2：动态代理（运行时包装，适合快速验证）

如果不想提前生成代码，也可以用动态代理在运行时创建包装类。不过要注意，这种方式会有一点点运行时性能损耗，适合对性能要求不高的场景。

比如用Castle DynamicProxy：你可以定义一个和第三方容器类成员一致的接口，然后动态生成实现类，把所有调用转发到第三方实例上。客户端只需要依赖你定义的接口，完全不用接触第三方库。

不过这里有个前提：如果第三方类没有实现接口，你得自己先定义对应的接口（这一步还是要手动，但只需要写接口，不用写实现），然后动态代理帮你生成实现代码。

关于你初步想的“继承”方案的坑

先给你提个醒：继承第三方类的话，你的包装类的基类是第三方库的类型，客户端编译你的类库时，还是需要引用第三方库的dll——这就违背了你“客户端无需声明依赖”的初衷！而且如果第三方类是密封类，继承这条路直接走不通。另外，继承会把第三方类的所有公共成员都暴露给客户端，万一第三方类有你不想暴露的方法，也没法控制。所以继承方案基本不适合你的场景。

额外小提示

如果第三方的容器类有构造函数，代码生成的时候记得自动生成对应的构造函数，把参数传递给内部的第三方实例；如果是不可变的数据类（比如C#的record），可以只生成只读属性的转发逻辑。

内容的提问来源于stack exchange，提问作者bw872