C#如何使用Primary Constructors C# 12主构造函数详解_网络技术

发布时间 - 2026-01-21 00:00:00 点击率：次

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

C# 12 的主构造函数（Primary Constructors）不是“给类加一个新构造函数”，而是把构造参数直接声明在类/结构体头部，让参数自动成为类型定义的一部分——它简化了参数捕获、字段初始化和只读属性生成的样板代码。

语法非常简洁：在类或结构体名称后紧跟括号，里面写参数列表。这些参数默认是

作用域仅限于类型体内的局部变量，但可配合 readonly 字段、init 属性或 field 关键字来持久化使用。

主构造参数本身不能直接在外部访问，必须通过字段、属性或方法显式暴露。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、配置类、数据承载结构等场景。