value receiver と pointer receiver の違いは何ですか？

Question

Accepted Answer

メソッドの **receiver** は操作対象の値で、メソッド名の前に宣言されます。**value receiver**（コピーで操作）または **pointer receiver**（オリジナルで操作し、変更可能）です。正しく選択することは、正確性（ミューテーション）とパフォーマンスの両方の観点から重要です。

## Value receiver — コピーで操作

```go
type Counter struct { count int }

func (c Counter) Increment() {     // VALUE receiver — c is a COPY
    c.count++                       // modifies the copy, NOT the original
}

c := Counter{}
c.Increment()
fmt.Println(c.count)   // 0 — the original is UNCHANGED (the copy was modified)
```

value receiver は構造体のコピーを受け取るため、変更はオリジナルに影響しません — 読み取り専用メソッドに便利ですが、ミューテーションを意図していた場合はバグです。

## Pointer receiver — オリジナルで操作

```go
func (c *Counter) Increment() {    // POINTER receiver — c points to the original
    c.count++                       // modifies the ACTUAL struct
}

c := Counter{}
c.Increment()          // Go automatically takes &c
fmt.Println(c.count)   // 1 — the original WAS modified
```

pointer receiver は実際の構造体で操作するため、**変更**できます。Go は自動的にアドレスを取得します（`c.Increment()` は値でも機能します）。

## どちらを使うか

```text
Use a POINTER receiver when:
  ✓ The method needs to MODIFY the receiver (mutation)
  ✓ The struct is LARGE (avoid copying it on every call — performance)
  ✓ For CONSISTENCY (see below)

Use a VALUE receiver when:
  ✓ The method only READS, the type is small, and you want copy semantics
  ✓ The type is naturally a value (small structs, basic types)
```

## 一貫性ルール

```go
// ✅ be consistent — if ANY method needs a pointer receiver, use pointer for ALL
func (c *Counter) Increment() { c.count++ }
func (c *Counter) Value() int { return c.count }   // pointer too, for consistency
```

1 つの型で value receiver と pointer receiver を混在させると微妙な問題が生じます — 慣例として 1 つを選択し（通常、メソッドがミューテーションする場合は pointer）、すべてのメソッドで使用します。

## インターフェース満足の微妙さ

```go
type Incrementer interface { Increment() }

// if Increment has a POINTER receiver, only *Counter satisfies the interface, not Counter
var i Incrementer = &Counter{}   // ✅ works
var j Incrementer = Counter{}    // ❌ Counter (value) does NOT satisfy it
```

これは一般的な落とし穴です：pointer receiver メソッドでは、pointer 型だけがインターフェースを満たします。

## なぜ重要なのか

value と pointer receiver の選択は、Go の根本的で頻繁に誤解される決定であり、正確性、パフォーマンス、インターフェース満足に影響します。

もっとも一般的なバグは、**ミューテーション意図時に value receiver を使用** — 変更はサイレントにコピーだけに影響するため、変更が「定着しない」。Pointer receiver はミューテーションに必須で、大きな構造体には推奨されます（毎回の呼び出しで高コストなコピーを避けるため）。

**一貫性ルール**（型のすべてのメソッドで同じ receiver 型を使用）は混乱を避け、**インターフェース満足の微妙さ**（pointer receiver メソッドは pointer 型だけがインターフェースを満たす）は「does not implement interface」エラーを引き起こす古典的な落とし穴です。

これらを理解することは、正確で効率的な Go を書くために必須であり、選択が自明でない結果をもたらすため、最も一般的な実践的およびインタビュー トピックの 1 つです。