Goでは、JSONをどのようにエンコード/デコードしますか?

Question

Accepted Answer

Goの標準ライブラリの**`encoding/json`**パッケージは、JSONのシリアライゼーション(マーシャリング)とデシリアライゼーション(アンマーシャリング)を処理し、GoのstructとJSONの間をマッピングします。**Struct tags**はフィールドの命名を制御し、ほとんどのGo web APIのバックボーンです。

## なぜ重要なのか

```go
type User struct {
    Name    string `json:"name"`              // tag maps the field to a JSON key
    Email   string `json:"email"`
    Age     int    `json:"age,omitempty"`     // omitempty → skip if zero/empty
    private string                             // unexported → NOT serialized (lowercase)
}

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`はstructをJSONバイトに変換します。**エクスポートされた(大文字で始まる)フィールドのみがシリアライズされます** — エクスポートされていないフィールドはスキップされます。

## Struct tagsの役割

```go
type Product struct {
    ID    int    `json:"id"`                  // → "id"
    Name  string `json:"product_name"`        // → "product_name" (rename)
    Price float64 `json:"price,omitempty"`     // omit if 0
    Notes string `json:"-"`                    // "-" → NEVER serialize this field
}
```

タグがない場合、JSONキーは正確なフィールド名(大文字で始まる)にデフォルト設定されます。タグを使用すると、JSONキー名を制御でき、空の値を省略(`omitempty`)でき、フィールドを完全に除外(`-`)できます — API規約(例えば snake_case JSON)に対応するために不可欠です。

## アンマーシャリング: JSON → Go struct

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

var user User
err := json.Unmarshal(jsonData, &user)   // pass a POINTER to populate it
if err != nil { log.Fatal(err) }
fmt.Println(user.Name)   // "Bob"
```

`json.Unmarshal`はJSONをstructにパースします — structを補完できるように**ポインタ**を渡す必要があります。フィールドはタグ/名前によってマッチされます(大文字小文字を区別しません)。

## 未知の/動的なJSONの操作

```go
// when the structure is unknown, unmarshal into a map or interface{}
var result map[string]interface{}
json.Unmarshal(data, &result)
name := result["name"].(string)        // type-assert the value (JSON numbers → float64!)
```

## Encoder/Decoderによるストリーミング(I/O用)

```go
// encode directly to an io.Writer (e.g. an HTTP response) — efficient, no intermediate buffer
json.NewEncoder(w).Encode(user)

// decode directly from an io.Reader (e.g. an HTTP request body)
json.NewDecoder(r.Body).Decode(&user)
```

webサーバーの場合、`Encoder`/`Decoder`はストリーム(リクエスト/レスポンスボディ)と直接操作します — ハンドラーの一般的なパターンです。

## なぜ重要なのか

JSONエンコード/デコードは、事実上すべてのGo web開発の基本です — REST API、マイクロサービス、設定はすべてGoのstructとJSONの間の変換に依存しています。

`encoding/json`パッケージ(標準ライブラリ、依存関係なし)は標準ツールであり、それをよく理解することは必須の日常知識です: マーシャリング/アンマーシャリングの仕組み、**エクスポートされたフィールドのみがシリアライズされる**という重要なルール、そして特に**struct tags**(JSONキー名を`json:"..."`で制御し、`omitempty`で空の値をスキップし、`-`で除外)は実世界のAPI規約(例えば snake_case)に対応するために必要です。

`Unmarshal`にポインタを渡す必要があることを知ること、マップ/`interface{}`経由で動的JSONを処理する方法(JSONの数値が`float64`にデコードされるという落とし穴があります)、そしてHTTPボディに対してストリーミング`Encoder`/`Decoder`を使用することは、APIを構築するための実用的なニーズをカバーしています。

これはGo バックエンド作業の継続的で実用的な部分です。