값 리시버와 포인터 리시버의 차이는 무엇인가요?

Question

Accepted Answer

메서드의 **리시버(receiver)**는 메서드가 동작하는 값으로, 메서드 이름 앞에 선언됩니다. **값 리시버**(복사본에 동작)이거나 **포인터 리시버**(원본에 동작하며 수정 가능)일 수 있습니다. 올바른 선택은 정확성(변경)과 성능 모두에 중요합니다.

## 값 리시버 — 복사본에 동작

```go
type Counter struct { count int }

func (c Counter) Increment() {     // 값 리시버 — c는 복사본
    c.count++                       // 복사본을 수정, 원본 아님
}

c := Counter{}
c.Increment()
fmt.Println(c.count)   // 0 — 원본은 불변(복사본이 수정됨)
```

값 리시버는 구조체의 복사본을 받으므로 수정이 원본에 영향을 주지 않습니다 — 읽기 전용 메서드에 유용하지만, 변경하려 했다면 버그입니다.

## 포인터 리시버 — 원본에 동작

```go
func (c *Counter) Increment() {    // 포인터 리시버 — c는 원본을 가리킴
    c.count++                       // 실제 구조체를 수정
}

c := Counter{}
c.Increment()          // Go가 자동으로 &c를 취함
fmt.Println(c.count)   // 1 — 원본이 수정됨
```

포인터 리시버는 실제 구조체에 동작하므로 그것을 **수정**할 수 있습니다. Go가 자동으로 주소를 취합니다(`c.Increment()`는 값에서도 동작).

## 언제 어느 것을 쓸까

```text
포인터 리시버를 쓸 때:
  ✓ 메서드가 리시버를 수정해야 할 때(변경)
  ✓ 구조체가 클 때(호출마다 복사 방지 — 성능)
  ✓ 일관성을 위해(아래 참조)

값 리시버를 쓸 때:
  ✓ 메서드가 읽기만 하고, 타입이 작으며, 복사 의미론을 원할 때
  ✓ 타입이 본질적으로 값일 때(작은 구조체, 기본 타입)
```

## 일관성 규칙

```go
// ✅ 일관성 유지 — 어떤 메서드든 포인터 리시버가 필요하면, 모든 메서드에 포인터 사용
func (c *Counter) Increment() { c.count++ }
func (c *Counter) Value() int { return c.count }   // 일관성을 위해 포인터도
```

한 타입에 값과 포인터 리시버를 섞으면 미묘한 문제가 생깁니다 — 관례는 하나를 고르고(보통 어떤 메서드든 변경하면 포인터) 모든 메서드에 사용하는 것입니다.

## interface 충족의 미묘함

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

// Increment가 포인터 리시버면, *Counter만 interface를 충족, Counter는 아님
var i Incrementer = &Counter{}   // ✅ 동작
var j Incrementer = Counter{}    // ❌ Counter(값)는 충족하지 않음
```

이는 흔한 함정입니다: 포인터 리시버 메서드에서는 포인터 타입만 interface를 충족합니다.

## 왜 중요한가

값 vs 포인터 리시버 선택은 정확성, 성능, interface 충족에 영향을 주는 기본적이고 자주 오해받는 Go 결정입니다.

가장 흔한 버그는 변경하려 했는데 **값 리시버를 쓰는 것**입니다 — 수정이 복사본에만 조용히 적용되어 변경이 "반영되지 않습니다". 포인터 리시버는 변경에 필수이며 큰 구조체(호출마다 비싼 복사 방지)에 권장됩니다.

**일관성 규칙**(타입의 메서드 전반에 같은 리시버 타입 사용)은 혼란을 피하고, **interface 충족의 미묘함**(포인터 리시버 메서드는 포인터 타입만 interface 충족)은 "interface를 구현하지 않음" 오류를 일으키는 고전적 함정입니다.

이것들을 이해하는 것은 올바르고 효율적인 Go 작성에 필수적이며, 선택이 명백하지 않은 결과를 갖기에 가장 흔한 실무 및 면접 주제 중 하나입니다.