Go struct를 JSON으로 변환하세요!

Go(Golang) struct를 입력하면 json 태그대로 예시 JSON을 만듭니다! API 테스트용 요청 본문에.
Go struct
결과
 

Go struct를 JSON으로 변환하세요!

Go struct 정의를 붙여넣으면 encoding/json이 마샬링할 때와 같은 규칙으로 예시 JSON을 만들어 줍니다. json:"..." 태그 이름, -로 숨긴 필드, ,string 옵션, 소문자로 시작하는 비공개 필드, 임베디드 struct 펼치기를 모두 따릅니다.

Gin·Echo·net/http 핸들러가 받는 요청 struct로 curl 테스트 본문을 만들거나, gRPC-Gateway·REST 문서에 넣을 샘플을 준비하거나, 태그를 잘못 적어 키가 어긋난 곳을 찾을 때 유용합니다.

사용 방법

  1. type Xxx struct { ... } 선언을 붙여넣습니다. type ( ... )로 묶은 선언과 여러 struct를 한꺼번에 넣어도 됩니다.
  2. 다른 struct를 필드로 쓰고 있다면 그 정의도 함께 넣어야 내용이 채워집니다. 입력에 없는 외부 패키지 타입(예: decimal.Decimal)은 null이 됩니다.
  3. 별도 옵션은 없습니다. 다른 타입이 참조하지 않는 첫 struct가 최상위 JSON이 되므로, 원하는 struct를 맨 위에 두거나 필요 없는 struct를 빼고 넣으세요.
  4. 결과를 복사해 curl -d, Postman 본문, httptest 기반 핸들러 테스트에 사용합니다.

예시

입력 (Go struct)
type Base struct {
	ID        string    `json:"id"`
	CreatedAt time.Time `json:"created_at"`
}

type Job struct {
	Base
	Queue      string            `json:"queue"`
	Attempts   int               `json:"attempts,string"`
	Labels     map[string]string `json:"labels,omitempty"`
	TimeoutSec *int              `json:"timeout_sec,omitempty"`
	Token      string            `json:"-"`
	Done       bool
	lastErr    error
}
출력 (JSON)
{
  "id": "",
  "created_at": "0001-01-01T00:00:00Z",
  "queue": "",
  "attempts": "0",
  "labels": {
    "key": ""
  },
  "timeout_sec": 0,
  "Done": false
}

임베디드 Base의 id, created_at이 Job 바로 아래로 펼쳐졌고, ,string 옵션이 붙은 Attempts는 숫자 대신 문자열 "0"이 됐습니다. 태그가 -인 Token과 비공개 필드 lastErr는 빠지고, 태그가 없는 Done은 Go 필드 이름 그대로 키가 됩니다. time.Time은 Go의 제로 값 0001-01-01T00:00:00Z로 들어갑니다.

지원 기능

  • json:"name" 태그 이름을 키로 쓰고, 태그가 없으면 필드 이름(대소문자 그대로)을 씁니다.
  • json:"-" 필드와 소문자로 시작하는 비공개 필드는 제외합니다. json:"-,"처럼 쓰면 키 이름이 -인 필드로 남습니다.
  • ,string 옵션이 있는 숫자·불리언 필드는 "0", "false"처럼 문자열로 감쌉니다.
  • 태그 없는 임베디드 struct는 필드를 부모로 펼치며, 이름이 겹치면 바깥 필드가 이깁니다. 태그를 단 임베디드 struct는 그 이름의 객체로 들어갑니다.
  • 포인터(*int, *Profile)는 가리키는 타입의 값으로 채우고, type Status string처럼 정의한 타입은 밑바탕 타입을 따라갑니다.
  • []byte는 Base64 문자열(빈 문자열), map[int]T는 "0" 키, time.Duration은 나노초 정수 0, interface{}·any는 null.
  • Children []Node처럼 자기 자신을 참조하는 struct는 빈 배열에서 멈춥니다. 익명 중첩 struct 필드도 지원합니다.

사용 사례

핸들러 테스트용 요청 본문

c.ShouldBindJSON(&req)로 바인딩하는 요청 struct를 붙여넣어 본문을 만들고, httptest.NewRequest나 curl로 바로 호출해 봅니다. 태그 이름 그대로 키가 나오므로 바인딩이 실패할 일이 줄어듭니다.

태그 실수 찾기

json:"user_id"와 json:"userId"가 섞여 있거나 태그를 빠뜨려 UserID처럼 대문자 키가 나가는 경우를 결과 JSON에서 한눈에 확인할 수 있습니다.

다른 언어 클라이언트와 스키마 공유

Go 서비스의 응답 struct에서 만든 JSON을 프런트엔드나 Python 소비자에게 전달하면, 각자 JSON → TypeScript·Python 같은 도구로 다시 모델을 만들 수 있습니다.

주의사항

  • omitempty 필드도 예시에서는 모두 나옵니다. 실제 마샬링에서는 제로 값일 때 빠진다는 점을 감안하세요.
  • 포인터 필드는 nil일 때 null로 나가지만 예시는 값이 있는 경우로 보여 줍니다.
  • MarshalJSON()을 직접 구현한 타입이나 json.RawMessage의 실제 내용은 알 수 없어 반영하지 않습니다.
  • Go 1.24의 omitzero 같은 새 옵션과 encoding/json/v2 동작은 다루지 않습니다.

자주 묻는 질문

태그를 안 단 필드는 키가 어떻게 되나요?

encoding/json은 내보낸(대문자로 시작하는) 필드 이름을 그대로 키로 씁니다. 그래서 Done bool은 "Done"이 됩니다. 디코딩은 대소문자를 무시하고 매칭하지만, 다른 언어 클라이언트는 그렇지 않으므로 태그를 명시하는 편이 안전합니다.

time.Time이 왜 0001년으로 나오나요?

Go에서 time.Time의 제로 값이 0001-01-01 00:00:00 UTC이고, RFC 3339 형식으로 마샬링하면 0001-01-01T00:00:00Z가 됩니다. 다른 → JSON 페이지의 1970년 값과 다른 이유입니다.

json:",string"은 언제 쓰나요?

JavaScript가 정확히 다루지 못하는 큰 int64 ID를 문자열로 주고받을 때 주로 씁니다. 예시에서도 "0"처럼 문자열로 표시되어 클라이언트가 어떤 타입을 받아야 하는지 알 수 있습니다.

struct 대신 JSON에서 Go struct를 만들고 싶어요.

반대 방향은 JSON → Go struct 페이지에서 할 수 있습니다. 거기서 만든 struct를 다시 이 페이지에 넣으면 왕복 결과가 원래 키와 같은지 확인할 수 있습니다.