はじめに
structは値型、classは参照型という違いは広く知られていますが、「代入や引き渡しのたびにコピーされる」という性質が、意図しない挙動やパフォーマンス低下を生む場面は多くあります。recordのwith式による非破壊的変更も、コピーが浅い(シャローコピー)という点を知らないと、別のインスタンスと状態を共有してしまいます。本記事では、struct/recordまわりで実務上よく遭遇する3つの落とし穴を扱います。
前提知識 / 用語整理
-
値型: 変数に値そのものを保持する型。代入や引数渡しで中身がコピーされる(
struct、int、DateTimeなど) -
参照型: 変数が実体への参照を保持する型。代入しても参照が複製されるだけで実体は共有される(
class、stringなど) -
ボックス化: 値型を
objectやインターフェース型として扱う際、ヒープ上に包み直す処理。メモリ確保とコピーを伴う -
record/record struct: 値による等価性とwith式を自動生成する型。recordは参照型、record structは値型(C# 10以降) - シャローコピー: オブジェクトのフィールドをそのままコピーすること。フィールドが参照型の場合、参照先は共有される
落とし穴1: 可変structを取り出して変更しても反映されない
再現コード
public struct Counter
{
public int Value;
public void Increment() => Value++;
}
public class Holder
{
public readonly Counter ReadonlyCounter = new();
}
var holder = new Holder();
// ❌ readonlyフィールド上のstructのメソッドを呼ぶ
holder.ReadonlyCounter.Increment();
Console.WriteLine(holder.ReadonlyCounter.Value); // 0のまま
var list = new List<Counter> { new() };
// ❌ コレクションの要素のプロパティを書き換えようとする
list[0].Value = 10; // コンパイルエラー CS1612
// ❌ 取り出して変更しても、コピーを変更しているだけ
var c = list[0];
c.Increment();
Console.WriteLine(list[0].Value); // 0のまま
なぜ起きるか
structは取り出すたびにコピーされます。readonlyフィールドのstructに対してメソッドを呼ぶと、コンパイラは元の値を保護するために「防御的コピー」を作成し、そのコピーに対してメソッドを実行します。結果として、Increment()が実行されても元の値は変化しません。同様に、List<T>のインデクサは値のコピーを返すため、list[0].Value = 10のように書いても元の要素には影響せず、コンパイラがエラー(CS1612)で止めます。エラーにならない形(変数に取り出してから変更する)で書くと、警告なしに「変更したつもりで反映されない」コードになります。
正しい書き方
// ◎ structは不変(readonly struct)にして、変更時は新しい値を作る
public readonly struct Counter
{
public int Value { get; }
public Counter(int value) => Value = value;
public Counter Increment() => new(Value + 1);
}
var list = new List<Counter> { new(0) };
list[0] = list[0].Increment(); // 新しい値で要素を置き換える
readonly structにすると、すべてのフィールドが読み取り専用であることがコンパイラに保証され、防御的コピーも発生しません。可変な状態を持たせたい場合はclassを選ぶのが基本方針です(ただし、小さく不変な値の集まり(座標、金額、範囲など)はreadonly structが適しています)。
落とし穴2: ボックス化と、構造体を辞書キーにする際の比較コスト
再現コード
public struct Point
{
public int X;
public int Y;
}
// ❌ 構造体をobjectやインターフェースとして扱うたびにボックス化される
var points = new List<object>();
for (int i = 0; i < 100_000; i++)
{
points.Add(new Point { X = i, Y = i }); // 毎回ヒープに確保される
}
// ❌ Equals/GetHashCodeを実装せずにDictionaryのキーにしている
var dict = new Dictionary<Point, string>();
dict[new Point { X = 1, Y = 1 }] = "A";
なぜ起きるか
structをobjectや、そのstructが実装するインターフェース型の変数に代入すると、ヒープ上に新しいオブジェクトが作られて値がコピーされます(ボックス化)。ループ内で繰り返すと大量のヒープ確保とGCの負荷になります。また、structがEquals/GetHashCodeをオーバーライドしていない場合、既定の実装(ValueTypeの実装)が使われます。この既定実装は、構造体のレイアウトによってはフィールドをリフレクションで比較する場合があり、Dictionaryのキーとして頻繁に呼ばれる場面で大きなコストになります。
正しい書き方
// ◎ ジェネリクスや具体的な型を使い、ボックス化を避ける
var points = new List<Point>(100_000);
for (int i = 0; i < 100_000; i++)
{
points.Add(new Point { X = i, Y = i }); // ボックス化されない
}
// ◎ record structなら等価性とハッシュ値が自動生成される
public readonly record struct Point(int X, int Y);
var dict = new Dictionary<Point, string>();
dict[new Point(1, 1)] = "A";
record struct(C# 10以降)は、IEquatable<T>を実装したEqualsとGetHashCodeをコンパイラが生成するため、辞書のキーとして適しています。手書きする場合もIEquatable<T>を実装すると、比較時のボックス化を避けられます。ボックス化が発生している箇所を調べるときは、ベンチマーク(BenchmarkDotNet)のメモリ診断やプロファイラのアロケーション計測で確認してください。
落とし穴3: recordのwith式はシャローコピーで、参照型のメンバーを共有する
再現コード
public record Order(int Id, List<string> Items);
var original = new Order(1, new List<string> { "A", "B" });
// ❌ withで「別の注文」を作ったつもり
var copy = original with { Id = 2 };
copy.Items.Add("C");
Console.WriteLine(string.Join(",", original.Items)); // A,B,C(元の注文にも追加されている)
なぜ起きるか
with式は元のインスタンスのフィールドをコピーして新しいインスタンスを作りますが、コピーは浅く、フィールドが参照型の場合は参照だけが複製されます。ItemsはList<string>への参照のため、originalとcopyが同じリストを共有し、一方への変更がもう一方にも見えます。recordは「イミュータブルなデータを表現するもの」と誤解されやすいため、プロパティがList<T>のような可変な参照型であっても不変になるとは限らない点が見落とされます。
正しい書き方
// ◎ 不変なコレクション型(IReadOnlyList / ImmutableList)を使う
public record Order(int Id, IReadOnlyList<string> Items);
var original = new Order(1, new List<string> { "A", "B" });
// 追加したい場合は、新しいリストを作って差し替える
var copy = original with
{
Id = 2,
Items = original.Items.Append("C").ToList()
};
(ただし、IReadOnlyList<T>は読み取り専用のビューであり、元のList<T>への参照を別の場所が持っていれば変更される可能性があります。厳密な不変性が必要な場合はSystem.Collections.ImmutableのImmutableList<T>を使います)。recordの等価性比較(==)も、コレクション型のメンバーは参照比較になる点に注意してください。
ベストプラクティスまとめ
-
structは小さく不変な値に限定し、readonly structとして宣言する -
可変な状態を持つ型は
classにする -
structをobjectやインターフェース型に代入する箇所(ボックス化)を、ホットパスでは避ける -
Dictionary/HashSetのキーに使うstructは、record structかIEquatable<T>の実装で比較を明示する -
recordのプロパティにList<T>などの可変コレクションを持たせない(with式のコピーが浅いため) -
パフォーマンス目的で
structを選ぶ場合は、計測してから判断する
おわりに
structとrecordは便利な反面、「コピーされる」「コピーが浅い」という前提を知らないと、変更が反映されない・意図せず共有されるといった、再現しにくい不具合の原因になります。型を選ぶ際は、不変かどうか、コピーされることで問題が起きないか、の2点を確認する習慣をつけると、これらの落とし穴の大半を避けられます。