JSON в Go

Похожие

О JSON в Go: Преобразование JSON в строготипизированную struct Go

Варианты использования

• Разработка бэкенда на Go преобразует JSON ответа REST API в struct, напрямую связывает с параметрами обработчика Gin/Echo/Fiber через json.Unmarshal
• При интеграции фронтенда и бэкенда берет пример JSON ответа из Postman, быстро генерирует модель Go для сокращения ручного ввода полей
• При интеграции сторонних Webhook-обратных вызовов преобразует полезную нагрузку JSON в struct Go для удобного доступа и валидации на уровне полей
• Преобразует конфигурационные файлы JSON из Viper/Consul/Nacos в типы Go, заменяя слаботипизированный доступ map[string]interface{}
• Команды микросервисов унифицируют структуру запросов/ответов для интерфейсов gRPC/HTTP, преобразуют пример JSON в общие типы Go
• Инженеры по тестированию преобразуют JSON fixture в struct Go, используют с testify для тестирования на основе утверждений
• DevOps анализируют строки журналов JSON, собранные ELK/Fluentd, генерируют struct для структурированного анализа программами на Go
• После того как краулеры собрали данные JSON, преобразуют в struct Go, работают с gorm/gen или ent для генерации моделей баз данных
• Данные телеметрии JSON, сообщаемые IoT-устройствами, преобразуются в struct Go, десериализация и фильтрация в программах граничных шлюзов
• Преобразует сообщения JSON, потребляемые из Kafka/NATS/RabbitMQ, в типы Go для реализации потребителей, управляемых событиями
• Разработчики SDK преобразуют пример JSON ответа сервера в struct Go, записывают в пакет types клиентской библиотеки для справки пользователей
• Преобразует пример JSON из документации Swagger/OpenAPI в struct Go как примеры кода документации интерфейса
• Студенты или преподаватели преобразуют пример JSON в struct во время курсов Go, демонстрируют систему типов Go и использование json-тегов
• Скрипты миграции данных преобразуют строки JSON, экспортированные из MySQL/PostgreSQL, в struct Go для сопоставления полей и валидации типов
• JSON конфигурации CI/CD преобразуется в struct Go, удобно для строготипизированного чтения конфигурации в инструментах конвейера, написанных на Go
• Старые проекты рефакторят динамический код чтения JSON на основе map в строготипизированный доступ на основе struct

Как использовать

1. Вставьте содержимое JSON в левом редакторе, или перетащите файлы .json/.txt, или нажмите «Пример» для загрузки встроенных данных.
2. Подождите около 400мс, инструмент автоматически преобразует и отобразит сгенерированный код struct Go справа.
3. Если в JSON есть ошибки, нажмите кнопку «Исправить JSON» для автоматического исправления распространенных ошибок форматирования, затем продолжите генерацию.
4. Проверьте правый вывод, нажмите «Копировать» для вставки в проект Go, или нажмите «Загрузить» для сохранения как файл model.go.

Функции

• Локальная генерация struct Go в браузере: Парсинг JSON и генерация кода Go выполняются в браузере, исходные данные не загружаются на сервер
• Автопреобразование с дебаунсом 400мс: Не нужно вручную нажимать после вставки или изменения, копируемый код Go выводится в реальном времени справа
• Умный вывод типов: строки отображаются в string, булевы значения в bool, целые числа в int64, числа с плавающей точкой в float64, массивы в срезы, объекты в структуры
• Автоматическое раскрытие вложенных объектов: Рекурсивно генерирует независимые типы struct, сохраняя четкую иерархию JSON
• Автогенерация json-тегов: Поля снабжаются тегами `json:"исходное_имя_поля"`, готовыми к использованию с encoding/json
• Исправление ошибок JSON одним кликом: Автоматически обрабатывает конечные запятые, одинарные кавычки, пропущенные кавычки и другие распространенные ошибки форматирования, продолжает генерацию после исправления
• Поддержка ввода вставкой/загрузкой/примером: Перетаскивание для загрузки файлов .json/.txt или загрузка встроенных примеров
• Копирование и загрузка одним кликом: Копирование всего кода Go в буфер обмена или загрузка как файл model.go прямо в проект
• История ввода localStorage: Автоматически сохраняет последние вводы, быстрое восстановление после обновления или случайного закрытия страницы
• Адаптивный редактор с разделенным экраном: Регулируемая ширина левой/правой панели, удобный просмотр ввода/вывода на десктопе и мобильных устройствах

Примеры кода

package main

import (
    "encoding/json"
    "fmt"
)

// 以下代码由 GeekFormat JSON 转 Go 工具生成
type User struct {
    ID      int64    `json:"id"`
    Name    string   `json:"name"`
    Tags    []string `json:"tags"`
    Address Address  `json:"address"`
}

type Address struct {
    City string `json:"city"`
}

func main() {
    data := []byte(`{
        "id": 1,
        "name": "Alice",
        "tags": ["admin", "dev"],
        "address": {"city": "Beijing"}
    }`)

    var u User
    if err := json.Unmarshal(data, &u); err != nil {
        panic(err)
    }

    fmt.Println(u.Name, u.Address.City)
}

package main

import "encoding/json"

// 手动将字段改为指针，缺失时值为 nil
type User struct {
    ID      *int64  `json:"id,omitempty"`
    Name    *string `json:"name,omitempty"`
    Email   *string `json:"email,omitempty"`
}

func main() {
    data := []byte(`{"id": 1, "name": "Bob"}`)
    var u User
    json.Unmarshal(data, &u)
    if u.Email == nil {
        println("Email 字段缺失")
    }
}

Часто задаваемые вопросы

Устранение неполадок

Глоссарий

struct

Составной тип данных Go, используемый для объединения нескольких полей в один тип. Основная часть кода Go, генерируемого этим инструментом, состоит из нескольких определений struct.

slice

Динамический тип массива Go, синтаксис []T. Этот инструмент сопоставляет массивы JSON с соответствующими срезами, например []string, []int64, []UserItem.

json tag

Строка в обратных кавычках после поля struct Go, например `json:"user_name"`, используемая для указания имени поля при сериализации/десериализации encoding/json. Этот инструмент автоматически генерирует этот тег.

interface{}

Пустой тип интерфейса Go, может представлять любое значение. Этот инструмент использует interface{} как безопасный резерв при обнаружении null в JSON или неопределенном типе.

PascalCase

Стиль именования, при котором каждое слово начинается с заглавной буквы, например UserName, AddressCity. Go требует, чтобы экспортируемые поля начинались с заглавной буквы, поэтому этот инструмент автоматически преобразует имена полей JSON в PascalCase.

encoding/json

Пакет кодирования/декодирования JSON в стандартной библиотеке Go. После того как структуры, сгенерированные этим инструментом, сопряжены с json-тегами, json.Unmarshal и json.Marshal можно использовать напрямую.

unmarshal

Процесс парсинга потока байтов JSON в значение Go. После генерации struct наиболее распространенное использование — вызов json.Unmarshal(data, &user).

omitempty

Распространенная опция для json-тега Go, например `json:"name,omitempty"`, означает пропуск вывода, когда поле имеет нулевое значение. Этот инструмент по умолчанию не генерирует omitempty; добавьте вручную при необходимости после генерации.

Шпаргалка сопоставления типов JSON с типами Go

Этот инструмент автоматически выводит соответствующие типы Go на основе типа значения JSON; распространенные сопоставления следующие:

Рекомендации по выбору распространенных числовых типов в Go

Инструмент по умолчанию использует int64 и float64; настройте по мере необходимости в реальных проектах:

Privacy & Security

Вся обработка этого инструмента JSON в Go полностью выполняется локально в вашем браузере: парсинг JSON, вывод типов, генерация кода Go выполняются на стороне клиента через Web Worker; введенное содержимое JSON, загруженные файлы и сгенерированный код Go никогда не загружаются ни на какой сервер, не записываются, не кэшируются и не хранятся в облаке. После закрытия или обновления страницы все входные и выходные данные автоматически очищаются из памяти, только localStorage сохраняет вашу последнюю историю ввода (можно очистить в любое время). Подходит для обработки JSON, содержащего API-ключи, токены, чувствительные бизнес-данные.