설정 파일 읽기
YAML, JSON, TOML 불러오기
설정 파일 읽기은(는) CoddyKit의 무료 Go Academy 강의입니다. 이것은 4개 중 1번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 Go Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. Go Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
구성은 코드 외부에 존재합니다
포트, 호스트 이름, 시간 초과 같은 값을 Go 프로그램에 하드코딩하면 취약해집니다. Viper는 Go의 사실상 표준 구성 라이브러리로, 파일, 환경 변수, 플래그, 원격 저장소에서 설정을 읽습니다.
이 레슨에서는 디스크의 파일에서 구성을 불러옵니다.
Viper가 읽는 형식
Viper는 기본적으로 다양한 형식을 지원합니다.
- YAML (
.yaml/.yml) - JSON (
.json) - TOML (
.toml) - HCL, INI 및 Java 속성 파일
SetConfigType으로 형식을 지정하거나, Viper가 파일 확장자에서 형식을 추론하도록 할 수 있습니다.
Viper 설치 및 가져오기
모듈에 Viper를 추가하고 가져옵니다.
go get github.com/spf13/viperimport "github.com/spf13/viper"
Viper는 외부 의존성이므로, 이 레슨 실행기에서는 Viper를 가져오는 코드 조각을 실행할 수 없습니다. 가능한 경우 표준 라이브러리로 동작을 시뮬레이션합니다.
import "github.com/spf13/viper"Viper에 검색 위치 알려 주기
읽기 전에 파일 이름, 형식, 검색 경로를 구성합니다.
viper.SetConfigName("config")은 확장자를 제외한 기본 이름을 설정합니다viper.SetConfigType("yaml")은 형식을 설정합니다viper.AddConfigPath(".")은 검색할 디렉터리를 추가합니다
viper.SetConfigName("config")
viper.SetConfigType("yaml")
viper.AddConfigPath(".")
viper.AddConfigPath("/etc/myapp")파일 읽기
viper.ReadInConfig()을 호출해 파일을 불러옵니다. 이 함수는 반드시 확인해야 하는 오류를 반환합니다.
- 파일이 없으면
ConfigFileNotFoundError를 반환합니다 - 파일 형식이 잘못되었으면 구문 분석 오류를 반환합니다
if err := viper.ReadInConfig(); err != nil {
log.Fatalf("failed to read config: %v", err)
}YAML 구성 예시
다음과 같은 config.yaml이 있다고 생각해 보십시오. Viper는 중첩된 키를 점으로 평탄화하므로 포트는 server.port가 됩니다.
server:
port: 8080
host: "localhost"
debug: true형식별 값 가져오기
Viper는 형식별 값 조회 함수를 제공하므로 수동 변환을 피할 수 있습니다.
viper.GetInt("server.port")viper.GetString("server.host")viper.GetBool("debug")
port := viper.GetInt("server.port")
host := viper.GetString("server.host")
debug := viper.GetBool("debug")
fmt.Println(host, port, debug)JSON도 같은 방식으로 작동합니다
JSON으로 전환할 때는 파일 내용과 구성 형식만 변경하면 됩니다. 같은 키 경로와 값 조회 함수를 사용할 수 있습니다. 이러한 이식성 때문에 Viper가 널리 사용됩니다. 운영팀이 어떤 형식을 선택했는지 코드가 신경 쓸 필요가 없습니다.
{
"server": { "port": 8080, "host": "localhost" },
"debug": true
}TOML도 지원됩니다
TOML은 Go 생태계에서 흔히 사용됩니다. 많은 명령줄 도구가 TOML을 사용합니다. 같은 중첩 키가 점으로 구분된 경로에 매핑됩니다.
[server]
port = 8080
host = "localhost"
debug = true표준 라이브러리로 JSON 구문 분석하기
이 아이디어가 실제로 작동하는 모습을 확인하기 위해, Viper 없이 encoding/json만 사용해 맵으로 JSON 구성을 구문 분석하는 일반 Go 코드를 살펴보겠습니다. Viper도 내부적으로는 일반 맵을 사용합니다.
package main
import (
"encoding/json"
"fmt"
)
func main() {
raw := "{\"port\":8080,\"host\":\"localhost\"}"
var c map[string]any
if err := json.Unmarshal([]byte(raw), &c); err != nil {
panic(err)
}
fmt.Printf("%v:%v\n", c["host"], c["port"])
}실행 가능 예제: 맵으로 읽기
이 독립 실행형 프로그램은 JSON 구성을 일반 맵으로 구문 분석하고 값을 출력하여 Viper가 JSON에 대해 내부적으로 수행하는 동작을 재현합니다.
package main
import (
"encoding/json"
"fmt"
)
func main() {
raw := "{\"port\":8080,\"host\":\"localhost\"}"
var m map[string]any
json.Unmarshal([]byte(raw), &m)
fmt.Println("host:", m["host"])
fmt.Println("port:", m["port"])
}빠른 확인
Viper로 구성 파일을 읽는 방법에 대한 이해도를 확인해 보십시오.
복습
Viper가 구성 파일을 읽는 방법을 배웠습니다.
- YAML, JSON 및 TOML을 투명하게 지원합니다
SetConfigName,SetConfigType,AddConfigPath로 구성합니다ReadInConfig()은 파일을 불러오고 오류를 반환합니다GetInt및GetString과 같은 형식별 조회 함수로 점으로 구분된 키의 값을 읽습니다
다음 주제: 환경 변수로 구성을 덮어쓰기
AI 튜터와 함께 Go을(를) 배우세요 — 무료
브라우저에서 실제 코드를 작성하고 실행하며, 24/7 AI 튜터로부터 즉각적인 도움을 받고, 웹이나 앱에서 중단한 부분부터 계속 학습하세요.
- 코스
- 51
- 레슨
- 203
자주 묻는 질문
“설정 파일 읽기” 강의는 무료인가요?
네 — “설정 파일 읽기” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 Go Academy 강의 전체를 잠금 해제할 수 있습니다. Go Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
“설정 파일 읽기”에서 뭘 배우나요?
YAML, JSON, TOML 불러오기 브라우저에서 직접 실행하는 실습 코드로 Go Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.
Go Academy을(를) 시작하는 데 경험이 필요한가요?
사전 경험은 필요하지 않습니다. CoddyKit의 Go Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 1번째 강의입니다.
“설정 파일 읽기” 강의는 얼마나 걸리나요?
대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.
이 Go Academy 강의에서 코드를 작성하고 실행할 수 있나요?
네. 모든 Go Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.
이 강의의 모든 강의
- 설정 파일 읽기
- 환경 변수
- 기본값과 감시
- 구조체에 바인딩하기