如何规范规避传递主构造函数参数给基类时的CS9107警告

问题描述 #

在C# 12普通类的主构造函数特性使用中，如下代码会触发CS9107警告：

new Derived("XXX").Test();

public class Base(string name)
{
    protected void Log() => Console.WriteLine("Base: " + name);
}

public class Derived(string name) : Base(name)
{
    public void Test()
    {
        base.Log();
        Console.WriteLine("Derived: " + name);
    }
}

警告内容：

Program.cs(8,42): Warning CS9107 : Parameter 'string name' is captured into the state of the enclosing type and its value is also passed to the base constructor. The value might be captured by the base class as well.

警告原因分析 #

CS9107的核心问题是：Derived的主构造函数参数name既被编译器自动捕获为Derived的实例状态，又被传递给Base的主构造函数；而Base的主构造函数也会自动捕获该参数作为自身的实例状态。这会导致内存中存储两份完全相同的name值，既造成内存冗余，也可能引发潜在的一致性风险（比如Base若修改捕获的参数值，Derived的副本不会同步）。

合理规避方案（不建议禁用警告） #

直接用编译指令禁用警告是下策，会掩盖设计层面的冗余问题。以下是更优的解决方式：

方案1：子类不捕获主构造函数参数，复用基类成员 #

修改Derived类，让其主构造函数的name仅用于传递给Base，不在Derived的方法中直接引用该参数，而是通过Base暴露的成员访问值：

new Derived("XXX").Test();

public class Base(string name)
{
    // 暴露protected成员供子类访问
    protected string Name => name;
    protected void Log() => Console.WriteLine("Base: " + name);
}

public class Derived(string name) : Base(name)
{
    public void Test()
    {
        base.Log();
        // 直接访问Base的成员，而非自身的主构造函数参数
        Console.WriteLine("Derived: " + base.Name);
    }
}

此时Derived的主构造函数参数未被捕获为实例状态，编译器不会触发警告，同时避免了重复存储。

方案2：基类显式存储参数，避免自动捕获 #

修改Base类，将主构造函数参数显式存储为protected字段，而非依赖编译器自动捕获：

new Derived("XXX").Test();

public class Base(string name)
{
    // 显式存储为只读字段，替代编译器自动捕获的参数
    protected readonly string Name = name;
    protected void Log() => Console.WriteLine("Base: " + Name);
}

public class Derived(string name) : Base(name)
{
    public void Test()
    {
        base.Log();
        Console.WriteLine("Derived: " + base.Name);
    }
}

这种方式让子类明确复用基类的字段，同样避免了重复存储，符合清晰的设计意图。

当前代码写法的问题 #

你提供的初始代码存在冗余存储的问题：编译器会为Derived自动生成一个存储name的字段，同时Base也会生成一个存储name的字段，同一个值被存储两次，这正是CS9107警告要提示的不合理设计。

传统构造函数方案的定位 #

你提到的放弃主构造函数、改用传统构造函数的写法，确实能解决警告，因为它显式让Derived复用Base的_name字段，避免了重复存储。但如果想保留C#12主构造函数的简洁性，上述两种方案更适合，无需放弃新特性。

针对多层配置类场景的专业建议 #

在基于Microsoft.Extensions.Configuration的复杂类层次结构中，配置对象通常是只读且全局共享的，推荐采用基类持有配置对象，子类通过基类暴露的成员访问的模式：

public class BaseConfigured(IConfiguration config)
{
    protected IConfiguration Config => config;
}

public class MiddleConfigured(IConfiguration config) : BaseConfigured(config)
{
    // 封装特定配置项，供子类直接使用
    protected string DatabaseConnectionString => Config["ConnectionStrings:Database"];
}

public class DerivedConfigured(IConfiguration config) : MiddleConfigured(config)
{
    public void UseConfiguration()
    {
        // 直接复用基类的配置对象或封装的配置项
        Console.WriteLine(Config["AppName"]);
        Console.WriteLine(DatabaseConnectionString);
    }
}

这种模式下，每个子类的主构造函数参数仅用于传递给父类，自身不捕获，既不会触发CS9107警告，又能让整个类层次结构共享一份配置对象引用，兼顾简洁性与性能。

内容的提问来源于stack exchange，提问作者Lasse V. Karlsen