🐹 JSON → Go 구조체 생성기 | 태그까지 바로 생성

JSON (객체 또는 객체 배열)

최상위 구조체 이름 (대문자로 시작)

정수로 보이는 숫자의 타입

추론 불가 필드에 쓸 타입

null 이거나 빠진 필드를 포인터(*T)로

모든 태그에 omitempty 넣기

약어를 대문자로 (Id → ID, Url → URL)

생성된 Go 코드

만든 타입-

JSON 값에서 Go 타입을 정하는 규칙

JSON 값	Go 타입	비고
문자열	string	그대로
참·거짓	bool	그대로
소수점 없는 숫자	int · int64	고른 타입
소수점 있는 숫자	float64	그대로
객체	중첩 구조체	키 이름으로 타입 생성
배열	[]요소타입	요소를 합쳐 추론
null	추론 불가	any 또는 interface{}
빈 배열	추론 불가	[]any 로 둠
타입이 섞인 배열	추론 불가	any 로 둠

null·빈 배열·타입이 섞인 배열은 값만 보고 타입을 알 수 없으므로 추론하지 않고 그 자리를 결과 아래에 경로로 적어 준다. 필드 이름은 내보내기 위해 대문자로 시작하게 바꾸고, Go 키워드와 겹치지 않도록 첫 글자를 올린다. 약어를 대문자로 쓰는 것은 Go 커뮤니티 관행이며 규격이 정한 규칙은 아니다.

JSON 응답에서 Go 구조체를 뽑아내기

API 응답을 붙여 넣으면 필드 이름과 타입, json 태그가 붙은 Go 구조체가 바로 만들어진다. 중첩된 객체는 별도 타입으로 떼어 내고, 객체 배열은 모든 요소의 필드를 합쳐서 추론하므로 어떤 요소에만 있는 필드도 빠지지 않는다. 결과는 gofmt 가 정렬한 모양과 같게 맞춰 두었다.

타입은 값의 모양으로 정한다. 소수점이 없는 숫자는 int 나 int64 중에서 고른 타입, 소수점이 있으면 float64 가 된다. 문제는 null·빈 배열·타입이 섞인 배열이다. 이 세 가지는 값만 보고는 타입을 알 수 없어 추론하지 않고, any 또는 interface{} 로 두면서 그 자리를 경로로 적어 준다. 2026년 10월 기준으로 추측해서 채우는 쪽보다 비워 두고 알리는 쪽이 안전하다고 보았다.

필드 이름은 패키지 밖에서 쓰도록 대문자로 시작하게 바꾸고, 같은 이름이 겹치면 뒤에 번호를 붙인다. 약어를 대문자로 쓰는 표기는 Go 커뮤니티 관행이라 선택으로 뒀다. 이 도구는 Go 전용이며 다른 언어의 모델 클래스는 만들지 않는다.

자주 묻는 질문

null 인 필드는 왜 타입을 안 정해 줄까?

null 은 그 값이 무엇이었는지 알려 주지 않기 때문이다. 다만 객체 배열에서 어떤 요소는 null 이고 다른 요소에 값이 있으면 그 값으로 타입을 정하고 포인터로 표시한다.

int 과 int64 중 무엇을 고를까?

JSON 숫자에는 범위 제한이 없으므로 큰 값이 올 수 있는 응답이면 int64 가 안전하다. 시간 값이나 식별자처럼 자릿수가 큰 필드가 있으면 특히 그렇다.

포인터와 omitempty 는 왜 같이 붙일까?

값이 없는 상태와 0·빈 문자열을 구별하려면 포인터가 필요하고, 비어 있을 때 JSON 에서 아예 빼려면 omitempty 가 필요하다. 둘을 같이 써야 왕복이 맞는다.

🐹JSON → Go 구조체(struct) 생성기

JSON 값에서 Go 타입을 정하는 규칙

관련된 도구

JSON 스키마 생성기

JSON 중첩 깊이·크기 분석기

JSON 응답에서 Go 구조체를 뽑아내기

자주 묻는 질문

JSON 값에서 Go 타입을 정하는 규칙

관련된 도구

JSON 스키마 생성기

JSON 중첩 깊이·크기 분석기

JSON 응답에서 Go 구조체를 뽑아내기

자주 묻는 질문

같은 카테고리 도구