Go에서 JSON을 어떻게 인코딩/디코딩하나요?

Question

Accepted Answer

Go의 표준 라이브러리 **`encoding/json`** 패키지는 JSON 직렬화(마샬링)와 역직렬화(언마샬링)를 처리하며, Go 구조체와 JSON 사이를 매핑합니다. **구조체 태그**가 필드 명명을 제어하며, 대부분의 Go 웹 API의 근간입니다.

## 마샬링: Go 구조체 → JSON

```go
type User struct {
    Name    string `json:"name"`              // 태그가 필드를 JSON 키에 매핑
    Email   string `json:"email"`
    Age     int    `json:"age,omitempty"`     // omitempty → 제로/빈 값이면 생략
    private string                             // 비공개 → 직렬화 안 됨(소문자)
}

u := User{Name: "Ann", Email: "ann@x.com", Age: 30}
data, err := json.Marshal(u)
fmt.Println(string(data))   // {"name":"Ann","email":"ann@x.com","age":30}
```

`json.Marshal`은 구조체를 JSON 바이트로 변환합니다. **공개(대문자) 필드만 직렬화됩니다** — 비공개 필드는 건너뜁니다.

## 구조체 태그의 역할

```go
type Product struct {
    ID    int    `json:"id"`                  // → "id"
    Name  string `json:"product_name"`        // → "product_name"(이름 변경)
    Price float64 `json:"price,omitempty"`     // 0이면 생략
    Notes string `json:"-"`                    // "-" → 이 필드를 절대 직렬화 안 함
}
```

태그 없이는 JSON 키가 정확한(대문자) 필드 이름으로 기본 설정됩니다. 태그는 JSON 키 이름 제어, 빈 값 생략(`omitempty`), 필드 전체 제외(`-`)를 가능하게 합니다 — API 관례(예: snake_case JSON)에 맞추는 데 필수적입니다.

## 언마샬링: JSON → Go 구조체

```go
jsonData := []byte(`{"name":"Bob","email":"bob@x.com","age":25}`)

var user User
err := json.Unmarshal(jsonData, &user)   // 채우려면 포인터를 전달
if err != nil { log.Fatal(err) }
fmt.Println(user.Name)   // "Bob"
```

`json.Unmarshal`은 JSON을 구조체로 파싱합니다 — 채울 수 있도록 **포인터**를 전달해야 합니다. 필드는 태그/이름으로 매칭됩니다(대소문자 무시).

## 알 수 없는/동적 JSON 다루기

```go
// 구조를 알 수 없을 때, map 또는 interface{}로 언마샬
var result map[string]interface{}
json.Unmarshal(data, &result)
name := result["name"].(string)        // 값을 타입 단언(JSON 숫자 → float64!)
```

## Encoder/Decoder로 스트리밍(I/O용)

```go
// io.Writer로 직접 인코딩(예: HTTP 응답) — 효율적, 중간 버퍼 없음
json.NewEncoder(w).Encode(user)

// io.Reader에서 직접 디코딩(예: HTTP 요청 본문)
json.NewDecoder(r.Body).Decode(&user)
```

웹 서버의 경우, `Encoder`/`Decoder`는 스트림(요청/응답 본문)과 직접 작동합니다 — 핸들러의 흔한 패턴입니다.

## 왜 중요한가

JSON 인코딩/디코딩은 사실상 모든 Go 웹 개발에 기본입니다 — REST API, 마이크로서비스, 설정 모두 Go 구조체와 JSON 간 변환에 의존합니다.

`encoding/json` 패키지(표준 라이브러리, 의존성 없음)가 표준 도구이며, 이를 잘 이해하는 것은 필수적인 일상 지식입니다: 마샬링/언마샬링의 동작, **공개 필드만 직렬화된다는** 결정적 규칙, 그리고 특히 실세계 API 관례(snake_case 같은)에 맞추는 데 필요한 **구조체 태그**(`json:"..."`로 JSON 키 이름 제어, `omitempty`로 빈 값 생략, `-`로 제외).

`Unmarshal`에 포인터를 전달하고, map/`interface{}`로 동적 JSON을 처리하고(JSON 숫자가 `float64`로 디코딩되는 함정과 함께), HTTP 본문에 스트리밍 `Encoder`/`Decoder`를 쓰는 것을 아는 것은 API 구축의 실무적 필요를 커버합니다.

이는 Go 백엔드 작업의 끊임없는 실무적 부분입니다.