JSON 태그
마샬링 제어하기
JSON 태그은(는) CoddyKit의 무료 Go Academy 강의입니다. 이것은 4개 중 2번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 Go Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. Go Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
JSON 태그로 마셜링 제어하기
encoding/json 패키지는 json 태그를 사용하여 구조체를 JSON으로 변환하거나 JSON에서 변환할 때 키 이름과 규칙을 결정합니다.
기본 필드 이름
태그가 없으면 JSON 키는 대소문자를 포함하여 내보낸 필드 이름과 정확히 일치합니다.
package main
import (
"encoding/json"
"fmt"
)
type User struct {
Name string
Age int
}
func main() {
b, _ := json.Marshal(User{"Ann", 30})
fmt.Println(string(b))
}키 이름 바꾸기
json 태그를 사용하면 출력의 키 이름을 변경할 수 있습니다. 여기서는 필드 이름이 소문자 이름으로 바뀝니다.
package main
import (
"encoding/json"
"fmt"
)
type User struct {
Name string "json:\"name\""
Age int "json:\"age\""
}
func main() {
b, _ := json.Marshal(User{"Ann", 30})
fmt.Println(string(b))
}omitempty 옵션
,omitempty를 추가하면 필드에 제로 값(빈 문자열, 0, nil 등)이 들어 있을 때 출력에서 해당 필드를 생략합니다.
package main
import (
"encoding/json"
"fmt"
)
type User struct {
Name string "json:\"name\""
Email string "json:\"email,omitempty\""
}
func main() {
b, _ := json.Marshal(User{Name: "Ann"})
fmt.Println(string(b))
}필드 무시하기
- 태그는 인코더가 필드를 완전히 건너뛰도록 지시하며, 비밀번호와 같은 비밀 정보를 숨길 때 유용합니다.
package main
import (
"encoding/json"
"fmt"
)
type User struct {
Name string "json:\"name\""
Password string "json:\"-\""
}
func main() {
b, _ := json.Marshal(User{"Ann", "secret"})
fmt.Println(string(b))
}태그를 사용한 언마셜링
태그는 양방향으로 작동합니다. JSON을 디코딩할 때 태그는 어떤 JSON 키가 어떤 필드에 값을 채울지 알려 줍니다.
package main
import (
"encoding/json"
"fmt"
)
type User struct {
Name string "json:\"name\""
}
func main() {
var u User
json.Unmarshal([]byte("{\"name\":\"Bob\"}"), &u)
fmt.Println(u.Name)
}대소문자를 구분하지 않는 일치
언마셜링할 때 Go는 대체 방식으로 JSON 키와 태그를 대소문자를 구분하지 않고 일치시킵니다. 그래도 태그를 명시적으로 정의하는 것이 안전하고 명확한 방법입니다.
문자열 옵션
,string 옵션을 사용하면 숫자 또는 불리언 필드를 JSON 문자열로 인코딩합니다. 숫자를 따옴표로 묶어야 하는 시스템에서 유용합니다.
package main
import (
"encoding/json"
"fmt"
)
type Item struct {
ID int "json:\"id,string\""
}
func main() {
b, _ := json.Marshal(Item{ID: 42})
fmt.Println(string(b))
}옵션 조합하기
이름과 옵션을 함께 사용할 수 있습니다: json:"email,omitempty". 이름을 먼저 쓰고, 그 뒤에 쉼표로 구분한 옵션을 씁니다.
내보내지 않은 필드는 건너뜁니다
내보낸 필드(대문자로 시작하는 필드)만 마셜링됩니다. 소문자로 시작하는 필드는 태그가 무엇이든 encoding/json에서 보이지 않습니다.
package main
import (
"encoding/json"
"fmt"
)
type User struct {
Name string "json:\"name\""
age int
}
func main() {
b, _ := json.Marshal(User{Name: "Ann", age: 30})
fmt.Println(string(b))
}보기 좋은 출력
json.MarshalIndent는 JSON을 들여쓰기하여 형식화하므로 태그를 적용하면서도 읽기 쉬운 로그를 만드는 데 유용합니다.
package main
import (
"encoding/json"
"fmt"
)
type User struct {
Name string "json:\"name\""
}
func main() {
b, _ := json.MarshalIndent(User{"Ann"}, "", " ")
fmt.Println(string(b))
}빠른 확인
json 태그의 ,omitempty 옵션은 무엇을 수행합니까?
복습
JSON 태그는 마샬링을 제어합니다.
json:"name"으로 키 이름을 변경합니다,omitempty는 0값을 건너뜁니다-는 필드를 무시하고,,string은 숫자를 문자열로 감쌉니다- 내보낸 필드만 인코딩됩니다
자주 묻는 질문
“JSON 태그” 강의는 무료인가요?
네 — “JSON 태그” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 Go Academy 강의 전체를 잠금 해제할 수 있습니다. Go Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
“JSON 태그”에서 뭘 배우나요?
마샬링 제어하기 브라우저에서 직접 실행하는 실습 코드로 Go Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.
Go Academy을(를) 시작하는 데 경험이 필요한가요?
사전 경험은 필요하지 않습니다. CoddyKit의 Go Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 2번째 강의입니다.
“JSON 태그” 강의는 얼마나 걸리나요?
대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.
이 Go Academy 강의에서 코드를 작성하고 실행할 수 있나요?
네. 모든 Go Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.