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、配置类、数据承载结构等场景。
