68. encoding/json — JSON を読み込む(Unmarshal)

json.Unmarshal は JSON のバイト列を Go の値に書き込みます。書き込み先は構造体などへのポインタを渡します(&v)。JSON のキーは構造体タグや、大文字小文字を無視したフィールド名照合でマッチします。対応するフィールドがない JSON のキーは単に無視されます。

構造体タグでキー名を対応づけるのが基本です。事前に構造が分からない JSON は map[string]any や any で受けることもできますが、その場合は数値が float64 になるなど型に注意が必要です。Unmarshal もエラーを返すので、必ず確認します。

下の例では JSON 文字列を構造体に読み込みます。入力が固定なので、出力は毎回同じです。

▶ サンプルコードを実行してみよう(自由に書き換えてOK)

package main

import (
	"encoding/json"
	"fmt"
)

type User struct {
	Name string `json:"name"`
	Age  int    `json:"age"`
}

func main() {
	input := `{"name": "Taro", "age": 28, "extra": "無視される"}`

	var u User
	if err := json.Unmarshal([]byte(input), &u); err != nil {
		fmt.Println(err)
		return
	}
	fmt.Printf("%+v\n", u) // {Name:Taro Age:28}
}

公式ドキュメントで詳しく ↗