17370845950

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 不是关键字，只是常见命名习惯）
• 也可在方法或属性 g

  

  etter 中直接使用参数名（只要没被遮蔽）：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、配置类、数据承载结构等场景。