JSON을 Go로

관련 추천

JSON을 Go로: JSON을 Go의 강한 타입 struct로 변환하기

사용 사례

• Go 백엔드 개발에서 REST API 응답 JSON을 struct로 변환하여 json.Unmarshal로 Gin/Echo/Fiber 핸들러의 매개변수에 직접 바인딩
• 프론트엔드-백엔드 연동 시 Postman의 예제 응답 JSON을 가져와 Go 모델을 빠르게 생성하여 수동 필드 입력을 줄임
• 서드파티 Webhook 콜백을 연동할 때 페이로드 JSON을 Go struct로 변환하여 필드 단위 접근과 검증을 편리하게 함
• Viper/Consul/Nacos의 JSON 설정 파일을 Go 타입으로 변환하여 약한 타입의 map[string]interface{} 접근을 대체
• 마이크로서비스 팀이 gRPC/HTTP 인터페이스의 요청/응답 구조를 통일하고 예제 JSON을 공유 Go 타입으로 변환
• 테스트 엔지니어가 JSON 픽스처를 Go struct로 변환하고 testify와 함께 사용하여 어설션 기반 테스트를 수행
• DevOps가 ELK/Fluentd가 수집한 JSON 로그 라인을 파싱하고 Go 프로그램으로 구조화된 분석을 하기 위해 struct를 생성
• 크롤러가 JSON 데이터를 스크래핑한 후 Go struct로 변환하고 gorm/gen이나 ent로 데이터베이스 모델을 생성
• IoT 디바이스가 보고한 JSON 원격 측정 데이터를 Go struct로 변환하여 에지 게이트웨이 프로그램에서 역직렬화와 필터링을 수행
• Kafka/NATS/RabbitMQ에서 소비한 JSON 메시지를 Go 타입으로 변환하여 이벤트 기반 컨슈머를 구현
• SDK 개발자가 서버 예제 응답 JSON을 Go struct로 변환하여 클라이언트 라이브러리의 types 패키지에 작성하여 사용자가 참조하도록 함
• Swagger/OpenAPI 문서의 예제 JSON을 Go struct로 변환하여 인터페이스 문서 코드 예제로 사용
• 학생이나 강사가 Go 강의에서 예제 JSON을 struct로 변환하여 Go의 타입 시스템과 json 태그 사용법을 시연
• 데이터 마이그레이션 스크립트가 MySQL/PostgreSQL에서 내보낸 JSON 행을 Go struct로 변환하여 필드 매핑과 타입 검증을 수행
• CI/CD 설정 JSON을 Go struct로 변환하여 Go로 작성된 파이프라인 도구에서 강한 타입의 설정 읽기를 편리하게 함
• 레거시 프로젝트에서 map 기반 동적 JSON 읽기 코드를 struct 기반 강한 타입 접근으로 리팩토링

이용 방법

1. 왼쪽 편집기에 JSON 내용을 붙여넣거나 .json/.txt 파일을 드래그 앤 드롭하여 업로드하거나 '예제'를 클릭하여 내장 데이터를 로드합니다.
2. 약 400ms를 기다리면 도구가 자동으로 변환하여 오른쪽에 생성된 Go struct 코드를 표시합니다.
3. JSON에 오류가 있으면 'JSON 수정' 버튼을 클릭하여 일반적인 형식 오류를 자동으로 수정한 후 생성을 계속합니다.
4. 오른쪽 출력을 확인하고 '복사'를 클릭하여 Go 프로젝트에 붙여넣거나 '다운로드'를 클릭하여 model.go 파일로 저장합니다.

주요 기능

• 브라우저 로컬 Go struct 생성: JSON 파싱과 Go 코드 생성이 브라우저 내에서 완료되며 원본 데이터는 서버에 업로드되지 않습니다
• 400ms 디바운스 자동 변환: 붙여넣거나 수정한 후 수동으로 클릭할 필요 없이 오른쪽에 복사 가능한 Go 코드가 실시간으로 출력됩니다
• 스마트 타입 추론: 문자열은 string, 불리언은 bool, 정수는 int64, 부동소수점은 float64, 배열은 슬라이스, 객체는 struct로 매핑됩니다
• 중첩 객체 자동 확장: 재귀적으로 독립적인 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

Go struct 필드 뒤의 백틱 문자열로, 예를 들어 `json:"user_name"`과 같습니다. encoding/json 직렬화/역직렬화 시 필드 이름을 지정하는 데 사용됩니다. 이 도구는 이 태그를 자동으로 생성합니다.

interface{}

Go의 빈 인터페이스 타입으로 모든 값을 표현할 수 있습니다. 이 도구는 JSON null이나 타입을 결정할 수 없을 때 interface{}를 안전한 폴백으로 사용합니다.

PascalCase

각 단어가 대문자로 시작하는 명명 스타일로, 예를 들어 UserName, AddressCity와 같습니다. Go는 내보낸 필드가 대문자로 시작해야 하므로 이 도구는 JSON 필드 이름을 자동으로 PascalCase로 변환합니다.

encoding/json

Go 표준 라이브러리의 JSON 인코딩/디코딩 패키지입니다. 이 도구가 생성한 struct에 json 태그를 붙이면 json.Unmarshal과 json.Marshal을 직접 사용할 수 있습니다.

unmarshal

JSON 바이트 스트림을 Go 값으로 파싱하는 과정입니다. struct를 생성한 후 가장 흔한 사용법은 json.Unmarshal(data, &user)를 호출하는 것입니다.

omitempty

Go json 태그의 일반적인 옵션으로, 예를 들어 `json:"name,omitempty"`는 필드가 제로 값일 때 출력을 생략함을 의미합니다. 이 도구는 기본적으로 omitempty를 생성하지 않으며 생성 후 필요에 따라 수동으로 추가합니다.

JSON 타입에서 Go 타입으로의 매핑 치트 시트

이 도구는 JSON 값의 타입에 따라 해당하는 Go 타입을 자동으로 추론합니다. 일반적인 매핑은 다음과 같습니다:

일반적인 Go 숫자 타입 선택 권장 사항

도구는 기본적으로 int64와 float64를 사용합니다. 실제 프로젝트에서 필요에 따라 조정하세요:

Privacy & Security

이 JSON to Go 도구의 모든 처리는 귀하의 브라우저에서 완전히 로컬로 완료됩니다: JSON 파싱, 타입 추론, Go 코드 생성이 모두 Web Worker를 통해 클라이언트 측에서 실행됩니다. 입력한 JSON 내용, 업로드한 파일, 생성된 Go 코드는 어떤 서버에도 업로드되지 않으며 클라우드에 기록, 캐시, 저장되지 않습니다. 페이지를 닫거나 새로고침하면 모든 입력과 출력 내용이 메모리에서 자동으로 지워지며 localStorage는 최근 입력 기록만 유지합니다(언제든지 지울 수 있음). API 키, 토큰, 민감한 비즈니스 데이터가 포함된 JSON 처리에 적합합니다.