구조체에 바인딩하기
설정 언마샬링하기
구조체에 바인딩하기은(는) CoddyKit의 무료 Go Academy 강의입니다. 이것은 4개 중 4번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 Go Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. Go Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
느슨한 키에서 구조체로
모든 곳에서 GetString을 호출하면 문자열 키가 코드 곳곳에 흩어집니다. 구성을 형식이 지정된 구조체로 디코딩하면 컴파일 시점에 필드 이름을 확인할 수 있고 구조를 한곳에서 파악할 수 있습니다.
구성 구조체 정의하기
Viper가 각 구성 키를 해당 필드에 매핑할 수 있도록 필드에 mapstructure 태그가 있는 구조체를 선언합니다. 각 필드 뒤에는 실제 Go 소스에서 역따옴표 사이에 작성하는 mapstructure:"host"와 같은 태그가 옵니다.
type ServerConfig struct {
Host string // tag: mapstructure host
Port int // tag: mapstructure port
}
type Config struct {
Server ServerConfig // tag: mapstructure server
Debug bool // tag: mapstructure debug
}Unmarshal 호출하기
구성을 읽은 후 구조체로 디코딩합니다.
var cfg Config
if err := viper.Unmarshal(&cfg); err != nil {
log.Fatalf("unable to decode config: %v", err)
}
fmt.Println(cfg.Server.Port)json이 아닌 mapstructure를 사용하는 이유
Viper는 구성이 JSON뿐 아니라 여러 형식(YAML, 환경 변수, TOML)에서 올 수 있으므로 mapstructure 라이브러리를 사용합니다. mapstructure 태그는 형식에 구애받지 않으며 일반 맵에서 값을 디코딩합니다.
단일 하위 트리 디코딩하기
UnmarshalKey를 사용하면 한 섹션만 디코딩할 수 있습니다.
var sc ServerConfig
viper.UnmarshalKey("server", &sc)
fmt.Println(sc.Host, sc.Port)중첩 필드와 슬라이스 필드
mapstructure는 중첩과 슬라이스를 자동으로 처리합니다.
- 중첩 구조체는 중첩된 구성 섹션에 매핑됩니다
[]string필드는 YAML/JSON 배열에 매핑됩니다
슬라이스 필드에는 실제 소스에서 역따옴표 사이에 작성하는 mapstructure:"hosts" 태그가 붙습니다.
type Config struct {
Hosts []string // tag: mapstructure hosts
}필드 기본값
키가 없고 기본값도 설정하지 않으면 필드는 Go의 영값(0, 빈 문자열, false)을 사용합니다. 구조체 바인딩과 SetDefault를 함께 사용해 합리적인 값을 보장하십시오.
디코딩한 구조체 검증하기
디코딩한 후에는 검증하십시오. 일반적인 방식은 포트가 0이거나 호스트가 비어 있는 경우처럼 불가능한 조합에 대해 오류를 반환하는 Validate() 메서드를 작성하는 것입니다.
func (c Config) Validate() error {
if c.Server.Port == 0 {
return fmt.Errorf("server.port is required")
}
return nil
}디코딩 오류는 형식이 지정됩니다
값이 필드 형식에 맞지 않으면(예상한 int 대신 문자열이 오는 경우처럼) 디코딩에서 해당 필드를 설명하는 오류를 반환합니다. 오류를 무시하지 말고 항상 확인하여 사용자에게 표시하십시오.
encoding/json에서도 같은 방식 사용
표준 라이브러리에서도 같은 방식으로 JSON을 디코딩할 수 있습니다. 명시적인 구조체 태그를 사용하면 형식이 지정된 필드를 채우고, 맵을 사용하면 일반적인 방식으로 접근할 수 있습니다. 아래 실행 가능한 예제는 구조체 태그 없이 실행할 수 있도록 중첩 맵을 사용합니다.
실행 예제: 중첩 구성 디코딩
이 독립 실행형 프로그램은 중첩된 JSON 구성을 일반 맵으로 디코딩하고 중첩된 필드를 읽습니다. 이는 Unmarshal이 구조체를 채우는 방식과 같습니다.
package main
import (
"encoding/json"
"fmt"
)
func main() {
raw := "{\"server\":{\"host\":\"localhost\",\"port\":8080},\"debug\":true}"
var c map[string]any
if err := json.Unmarshal([]byte(raw), &c); err != nil {
panic(err)
}
srv := c["server"].(map[string]any)
fmt.Printf("%v:%v debug=%v\n", srv["host"], srv["port"], c["debug"])
}빠른 확인
구성을 구조체에 바인딩하는 방법을 제대로 이해했는지 확인해 보십시오.
복습
구성을 구조체에 바인딩하는 방법을 배웠습니다:
mapstructure태그와viper.Unmarshal(&cfg)를 사용합니다UnmarshalKey는 하나의 하위 트리를 디코딩합니다- 중첩 구조체와 슬라이스는 자동으로 디코딩됩니다
Validate()메서드를 추가하여 잘못된 조합을 일찍 찾아냅니다
자주 묻는 질문
“구조체에 바인딩하기” 강의는 무료인가요?
네 — “구조체에 바인딩하기” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 Go Academy 강의 전체를 잠금 해제할 수 있습니다. Go Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
“구조체에 바인딩하기”에서 뭘 배우나요?
설정 언마샬링하기 브라우저에서 직접 실행하는 실습 코드로 Go Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.
Go Academy을(를) 시작하는 데 경험이 필요한가요?
사전 경험은 필요하지 않습니다. CoddyKit의 Go Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 4번째 강의입니다.
“구조체에 바인딩하기” 강의는 얼마나 걸리나요?
대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.
이 Go Academy 강의에서 코드를 작성하고 실행할 수 있나요?
네. 모든 Go Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.