C# 12 主构造函数将参数直接声明在类/结构体头部,简化参数捕获与初始化;语法为class C(p1, p2),参数默认为类型体内局部变量,需配合readonly字段、init属性等持久化使用。

C# 12 的主构造函数(Primary Constructors)不是“给类加一个新构造函数”,而是把构造参数直接声明在类/结构体头部,让参数自动成为类型定义的一部分——它简化了参数捕获、字段初始化和只读属性生成的样板代码。
主构造函数的基本写法
语法非常简洁:在类或结构体名称后紧跟括号,里面写参数列表。这些参数默认是 作用域仅限于类型体内 的局部变量,但可配合 readonly 字段、init 属性或 field 关键字来持久化使用。
- 类定义示例:
public class Person(string name, int age);—— 这行就完成了声明,无需再写显式构造函数 - 结构体同样支持:
public struct Point(double x, double y); - 参数可以带默认值:
class Config(string path, bool autoSave = true);
如何访问和使用主构造参数
主构造参数本身不能直接在外部访问,必须通过字段、属性或方法显式暴露。C# 12 提供了几种常用方式:
- 用
readonly字段捕获:class Person(string name, int age) { public readonly string Name = name; public readonly int Age = age; } - 用
init或get属性封装:public string Name { get; init; } = name;(注意:需在属性初始化器中引用name) - 用
field关键字自动生成私有后备字段:public string Name => _name; private readonly string _name = name;(需手动写,但field不是关键字,只是常见命名习惯) - 也可在方法或属性 getter 中直接使用参数名(只要没被遮蔽):
public override string ToString() => $"{name} ({age})";
主构造函数与基类构造调用
如果类继承自另一个类,主构造函数会自动尝试调用基类的无参构造函数。若基类没有无参构造,就必须显式指定调用哪个基类构造:
- 写法:
class Student(string name, int age) : Person(name, age + 1) { }—— 尾部的: Person(...)是基类构造调用 - 此时主构造参数
name和age可直接用于基类调用表达式中 - 不能同时存在主构造函数和显式的实例构造函数(除非你放弃主构造,改用传统写法)
注意事项和限制
主构造函数很轻量,但也有些容易踩的坑:
- 不支持
ref、out、params参数 - 不能和传统的实例构造函数共存(即不能既有
class C(int x),又写public C(int x) { ... }) - 静态构造函数、静态字段初始化不受影响,仍按原有规则执行
- 记录(record)类型本来就支持紧凑语法,主构造函数对
record class和record struct同样有效,且能自然融合with行为
基本上就这些。主构造函数不是银弹,但它让简单类型的定义更紧凑、意图更清晰,尤其适合 DTO、配置类、数据承载结构等场景。







