JSON в структуру данных

Пример вывода

Для:

{ "first_name": "Alice", "age": 30, "email": null, "tags": ["admin"] }

Результат:

type User struct {
    FirstName string   `json:"first_name"`
    Age       int      `json:"age"`
    Email     *string  `json:"email"`
    Tags      []string `json:"tags"`
}

Маппинг типов

Идиомы именования, которым следует генератор

• Инициалы пишутся заглавными буквами: id → ID, url → URL, api_key → APIKey. Это соответствует рекомендуемому стилю языка Go (а также правилам go vet и staticcheck).
• Поле в формате snake_case в JSON преобразуется в PascalCase: first_name → FirstName.
• Однословные акронимы сохраняются: IP остаётся IP, HTTP остаётся HTTP.
• Тег JSON: json:"first_name" сохраняет исходный ключ, что обеспечивает чистое кодирование в обе стороны.

Необязательные поля: указатель или omitempty?

По умолчанию генератор использует указатель + omitempty для значений, которые интерпретируются как нулевые; настройка осуществляется в соответствии с вашими требованиями к семантике данных.

Типичные ошибки

• Использование int, когда целое число из JSON превышает MaxInt32 на 32-битной платформе. Для заведомо больших значений используйте int64.
• Повторное кодирование с потерей порядка ключей. encoding/json выдаёт ключи в порядке объявления полей, а не в исходном порядке JSON. Если нужен канонический вывод, отсортируйте вручную.
• Массивы смешанной формы. []interface{} теряет типобезопасность. Вместо этого рассмотрите типы-объединения с полем-дискриминатором type.
• Забытый omitempty у необязательных полей. Без него необязательные поля сериализуются как "foo": null, а не опускаются.