required 关键字仅对 init 属性生效,强制在对象初始化器或 new() 中赋值,不作用于 set 属性,不提供运行时保障,且在反射、序列化、DI 等场景下失效。

required 关键字在 C# 11+ 中确实能强制对象初始化时设置特定属性,但它只对 init 属性生效,且必须配合 new() 或对象初始化器使用 —— 单纯加 required 不会阻止默认构造函数创建未赋值对象。
required 只作用于 init-only 属性,不是普通 set 属性
如果你给一个带 set 的属性加 required,编译器直接报错:CS8954: A required member cannot be declared on a property with a setter。它只允许修饰 init 属性(或 init 字段)。
-
init表示“仅初始化阶段可写”,之后不可变,语义上更接近只读 + 构造期注入 - 若你仍需运行时修改,
required就不适用;得换用构造函数参数 + 私有字段 + 公共只读属性组合 - 常见误写:
public string Name { get; set; } = required;→ 错误;正确是:public string Name { get; init; } = required;
不使用对象初始化器时,required 失效
required 的约束发生在编译期检查初始化表达式,而不是实例化过程本身。这意味着:
-
var obj = new Person();→ 编译失败(缺少 required 成员) -
var obj = new Person { Name = "Alice" };→ 通过 -
var obj = new Person(); obj.Name = "Alice";→ 编译通过(绕过 required 检查),但Name是init属性,运行时报CS0191: Cannot assign to property or indexer 'Person.Name' because it is read-only - 反射、序列化(如 System.Text.Json 默认行为)、反序列化构造等场景完全绕过
required检查 —— 它不提供运行时保障
与构造函数参数配合才能覆盖更多初始化路径
单靠 required 无法约束所有构造方式。例如继承、工厂方法、依赖注入容器创建实例时,往往不走对象初始化器。此时建议:
- 把
required属性和主构造函数参数对齐:public class Person(string name) { public string Name { get; init; } = required; - 同时在构造函数里显式赋值:
public string Name { get; init; } = name;,既满足required要求,又让构造函数路径受控 - 注意:如果类有多个构造函数,每个都得确保 required 成员被赋值,否则编译失败;没写构造函数时,编译器生成的默认构造函数不包含任何赋值逻辑,所以必须用对象初始化器补全
真正难处理的是跨程序集场景:引用方用了 C# 11+,但定义 required 的类编译在旧版本目标框架下(如 net6.0),或者被反序列化库忽略初始化上下文 —— 这时候 required 形同虚设。别把它当成运行时契约,它只是编译器帮你盯住初始化语法糖的一道眼。


















