Go struct 정의를 붙여넣으면 encoding/json이 마샬링할 때와 같은 규칙으로 예시 JSON을 만들어 줍니다. json:"..." 태그 이름, -로 숨긴 필드, ,string 옵션, 소문자로 시작하는 비공개 필드, 임베디드 struct 펼치기를 모두 따릅니다.
Gin·Echo·net/http 핸들러가 받는 요청 struct로 curl 테스트 본문을 만들거나, gRPC-Gateway·REST 문서에 넣을 샘플을 준비하거나, 태그를 잘못 적어 키가 어긋난 곳을 찾을 때 유용합니다.
type Xxx struct { ... } 선언을 붙여넣습니다. type ( ... )로 묶은 선언과 여러 struct를 한꺼번에 넣어도 됩니다.decimal.Decimal)은 null이 됩니다.curl -d, Postman 본문, httptest 기반 핸들러 테스트에 사용합니다.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
}{
"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"처럼 문자열로 감쌉니다.*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의 실제 내용은 알 수 없어 반영하지 않습니다.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"처럼 문자열로 표시되어 클라이언트가 어떤 타입을 받아야 하는지 알 수 있습니다.
반대 방향은 JSON → Go struct 페이지에서 할 수 있습니다. 거기서 만든 struct를 다시 이 페이지에 넣으면 왕복 결과가 원래 키와 같은지 확인할 수 있습니다.