init访问器是C# 9引入的特性,用于定义只能在对象初始化时赋值的属性。它使属性具备“初始化可设、之后只读”的行为,支持不可变性、与record类型协同、比私有set更灵活,并兼容现代序列化库,提升代码安全性和简洁性。

在C# 9 及更高版本中,init访问器是一种特殊的属性设置器,它允许属性在对象初始化时被赋值,但一旦对象创建完成,就不能再修改。这使得属性具有“初始化时可设,之后只读”的特性。
什么是 init 访问器?
init 是 initialize 的缩写,是 set 访问器的变体。和 set 不同的是,init 只能在对象初始化期间使用(例如使用对象初始化器时),之后无法再通过赋值更改该属性。
这特别适合用于构建不可变对象,同时又希望保持代码简洁。
如何创建只在初始化时可设置的属性?
使用 init 访问器即可实现。下面是一个示例:
public class Person
{
public string Name { get; init; }
public int Age { get; init; }
}
你可以这样初始化对象:
var person = new Person
{
Name = "Alice",
Age = 30
};
但以下代码会编译错误:
person.Name = "Bob"; // 错误:init-only 属性只能在初始化时设置
init 的使用场景和优势
- 支持不可变性:对象创建后属性不能更改,有助于线程安全和数据一致性
- 与记录类型(record)配合良好:C# 的 record 默认使用 init 访问器
- 比私有 set 更灵活:允许外部在构造时赋值,而不是完全封闭
- 序列化友好:大多数现代序列化库(如 System.Text.Json)支持 init 成员
例如,使用 record 时,属性默认就是 init-only:
public record Point(int X, int Y);
// 等价于:
// public class Point
// {
// public int X { get; init; }
// public int Y { get; init; }
// }
基本上就这些。init 让你在保持对象不可变的同时,还能享受对象初始化器的便利语法。不复杂但很实用。










