C# 10 record struct：轻量级值类型记录详解

1. 什么是record struct？

record struct是C# 10中引入的一种新的值类型记录类型。它结合了record的简洁声明语法和struct的值类型特性，为开发者提供了一种轻量级的数据封装方式。

在C# 9中，record被引入作为一种引用类型，主要用于不可变数据的建模。而C# 10扩展了这一概念，允许record也可以是值类型。这意味着我们现在可以创建具有record特性的struct，获得两者的优势。

注意：record struct与普通的struct不同，它默认是不可变的，并且自动实现了值相等性比较。

2. record struct的核心特性

2.1 简洁的声明语法

record struct的声明语法极其简洁。例如，定义一个表示二维点的record struct：

csharp复制public readonly record struct Point(double X, double Y);

这一行代码就完成了以下工作：

• 定义了一个名为Point的值类型
• 声明了两个公共属性X和Y
• 自动生成了构造函数
• 实现了值相等性比较
• 重写了ToString()方法

2.2 默认不可变性

record struct默认是不可变的，这意味着一旦创建，其值就不能更改。这与普通的struct不同，后者默认是可变的。这种设计选择有助于减少错误，特别是在多线程环境中。

csharp复制var p1 = new Point(1.0, 2.0);
// p1.X = 3.0; // 编译错误：record struct默认是只读的

2.3 自动实现的值相等性

record struct自动实现了基于值的相等性比较，而不是引用比较。这意味着两个record struct实例如果包含相同的值，它们就被认为是相等的。

csharp复制var p1 = new Point(1.0, 2.0);
var p2 = new Point(1.0, 2.0);
Console.WriteLine(p1 == p2); // 输出：True

2.4 解构功能

与record class一样，record struct也支持解构操作，可以方便地将属性值提取到单独的变量中：

csharp复制var (x, y) = new Point(1.0, 2.0);
Console.WriteLine($"X: {x}, Y: {y}"); // 输出：X: 1, Y: 2

3. record struct与相关类型的比较

3.1 record struct vs record class

3.2 record struct vs 普通struct

4. record struct的适用场景

4.1 小型数据封装

record struct非常适合封装小型数据集，特别是那些需要频繁创建和比较的轻量级数据结构。例如：

csharp复制public readonly record struct Color(byte R, byte G, byte B);

4.2 高性能场景

由于record struct是值类型，避免了堆分配和垃圾回收的开销，因此在性能敏感的场景下特别有用。例如在游戏开发中表示向量、坐标等。

csharp复制public readonly record struct Vector3(float X, float Y, float Z);

4.3 作为方法返回值

record struct非常适合作为方法的复合返回值，替代out参数或Tuple，使代码更清晰：

csharp复制public record struct MinMaxResult(int Min, int Max);

public MinMaxResult FindMinMax(int[] numbers)
{
    // 实现查找逻辑
    return new(numbers[0], numbers[1]);
}

5. record struct的高级用法

5.1 自定义行为

虽然record struct提供了很多自动实现的功能，但你仍然可以自定义其行为：

csharp复制public record struct Person(string FirstName, string LastName)
{
    public string FullName => $"{FirstName} {LastName}";
    
    public void Deconstruct(out string firstName, out string lastName, out string fullName)
    {
        firstName = FirstName;
        lastName = LastName;
        fullName = FullName;
    }
}

5.2 可变record struct

虽然record struct默认是不可变的，但你可以显式声明为可变的：

csharp复制public record struct MutablePoint
{
    public double X { get; set; }
    public double Y { get; set; }
    
    public MutablePoint(double x, double y)
    {
        X = x;
        Y = y;
    }
}

5.3 与模式匹配结合使用

record struct与C#的模式匹配功能配合使用非常强大：

csharp复制public double CalculateArea(object shape) => shape switch
{
    Circle c => Math.PI * c.Radius * c.Radius,
    Rectangle r => r.Width * r.Height,
    _ => throw new ArgumentException("Unknown shape type")
};

public record struct Circle(double Radius);
public record struct Rectangle(double Width, double Height);

6. 性能考虑与最佳实践

6.1 何时使用record struct

• 当数据类型很小（通常小于16字节）时
• 当需要频繁创建和销毁实例时
• 当值相等性语义很重要时
• 当需要不可变性时

6.2 何时避免使用record struct

• 当数据类型较大时（可能导致复制开销）
• 当需要频繁装箱时（record struct是值类型）
• 当需要null语义时

6.3 性能优化技巧

1. 对于频繁传递的record struct，考虑使用in参数：

csharp复制public double CalculateDistance(in Point a, in Point b)
{
    // 计算逻辑
}

2. 避免大型record struct，因为它们会带来复制开销。

3. 考虑将readonly record struct用于完全不可变的场景，这可以给编译器更多优化机会。

7. 实际应用案例

7.1 图形处理应用

在图形处理中，record struct非常适合表示各种几何图形和颜色：

csharp复制public readonly record struct RgbColor(byte R, byte G, byte B);
public readonly record struct HsvColor(double H, double S, double V);

public static class ColorConverter
{
    public static HsvColor RgbToHsv(RgbColor rgb)
    {
        // 转换逻辑
        return new HsvColor(h, s, v);
    }
}

7.2 游戏开发

在游戏开发中，record struct可以高效地表示各种游戏实体属性：

csharp复制public readonly record struct Vector2(float X, float Y);
public readonly record struct Transform(Vector2 Position, Vector2 Scale, float Rotation);

public class GameObject
{
    public Transform Transform { get; set; }
    // 其他属性
}

7.3 数据分析

在数据分析场景中，record struct可以清晰地表示数据点和统计结果：

csharp复制public readonly record struct DataPoint(DateTime Timestamp, double Value);
public readonly record struct Statistics(double Mean, double Median, double StdDev);

public Statistics CalculateStats(DataPoint[] points)
{
    // 计算逻辑
    return new(mean, median, stdDev);
}

8. 常见问题与解决方案

8.1 如何实现深拷贝？

record struct本身就是值类型，赋值时会自动创建副本，不需要特殊处理：

csharp复制var original = new Point(1, 2);
var copy = original; // 自动创建副本

8.2 如何序列化record struct？

record struct可以像普通类型一样被序列化：

csharp复制[Serializable]
public record struct SerializablePoint(double X, double Y);

// 使用Json.NET序列化
var json = JsonConvert.SerializeObject(new SerializablePoint(1, 2));

8.3 如何处理大型record struct？

对于较大的record struct，考虑以下方法：

1. 拆分为更小的record struct
2. 使用ref struct（如果适用）
3. 改为使用record class

8.4 如何实现自定义相等性比较？

虽然record struct自动实现了相等性比较，但你仍然可以重写：

csharp复制public record struct CustomEqualityRecord(int Value)
{
    public bool Equals(CustomEqualityRecord other) => Value % 10 == other.Value % 10;
    public override int GetHashCode() => (Value % 10).GetHashCode();
}

9. 与C#新特性的结合使用

9.1 与全局using结合

C# 10的全局using指令可以与record struct很好地配合：

csharp复制// GlobalUsings.cs
global using Point = Geometry.RecordStructs.Point;

// RecordStructs.cs
namespace Geometry.RecordStructs
{
    public readonly record struct Point(double X, double Y);
}

9.2 与文件范围的namespace结合

record struct可以与文件范围的namespace声明一起使用，使代码更简洁：

csharp复制namespace Geometry;

public readonly record struct Point(double X, double Y);

9.3 与接口实现结合

record struct可以实现接口，增加了灵活性：

csharp复制public interface IDrawable
{
    void Draw();
}

public record struct DrawablePoint(double X, double Y) : IDrawable
{
    public void Draw() => Console.WriteLine($"Drawing point at ({X}, {Y})");
}

10. 设计考量与未来展望

record struct的设计体现了C#语言对现代编程需求的响应。它解决了以下问题：

1. 提供了一种简洁的方式来声明值类型数据结构
2. 默认不可变性有助于编写更安全的代码
3. 自动实现的相等性比较减少了样板代码
4. 解构功能提高了代码的可读性

在实际项目中，我发现record struct特别适合以下场景：

• DTO（数据传输对象）
• 配置参数
• 数学和几何相关的数据结构
• 性能敏感的小型数据结构

随着C#语言的演进，record struct可能会获得更多功能，比如：

• 更丰富的模式匹配支持
• 与Span更好的集成
• 更高级的不可变性控制

我在多个项目中使用record struct后，发现它确实提高了代码的简洁性和安全性。特别是在处理大量小型数据结构时，性能提升非常明显。一个实用的建议是：对于频繁创建和比较的小型数据结构，优先考虑使用record struct而不是class。