[Go] 형식지정자 Format 정리(%v,%s,%d 등)

 

Go의 형식 지정자(format verbs) 는 fmt 패키지(fmt.Printf, fmt.Sprintf, fmt.Errorf 등)에서 문자열 출력 시 매우 중요합니다.
이 부분은 디버깅, 로깅, 문자열 포매팅 모두에 영향을 주기 때문에 실무에서도 정확히 이해해두면 좋습니다.

Go 형식 지정자 완전 정리

fmt 패키지의 주요 함수들:

함수	설명
fmt.Printf()	콘솔에 형식화된 출력
fmt.Sprintf()	형식화된 문자열 반환
fmt.Fprintf()	writer(io.Writer)에 형식화된 출력
fmt.Errorf()	형식화된 에러 문자열 생성

이 함수들은 모두 "%" 로 시작하는 format verb(형식 지정자)를 사용합니다.

주요 형식 지정자 (기본형)

형식	설명	예시	출력
%v	기본 형식으로 출력	fmt.Printf("%v", 123)	123
%+v	구조체 필드명 포함 출력	fmt.Printf("%+v", user)	{Name:Alice Age:30}
%#v	Go 코드 형태로 표현	fmt.Printf("%#v", user)	main.User{Name:"Alice", Age:30}
%T	값의 타입 출력	fmt.Printf("%T", 123)	int
%%	% 문자 자체 출력	fmt.Printf("%%")	%

정수 타입

형식	설명	예시	출력
%d	10진수	fmt.Printf("%d", 255)	255
%b	2진수	fmt.Printf("%b", 255)	11111111
%o	8진수	fmt.Printf("%o", 255)	377
%x	16진수(소문자)	fmt.Printf("%x", 255)	ff
%X	16진수(대문자)	fmt.Printf("%X", 255)	FF
%c	Unicode 코드 포인트를 문자로 출력	fmt.Printf("%c", 65)	A
%U	Unicode 형식으로 출력	fmt.Printf("%U", 65)	U+0041

문자열 및 바이트

형식	설명	예시	출력
%s	문자열 그대로 출력	fmt.Printf("%s", "GoLang")	GoLang
%q	따옴표 포함 문자열	fmt.Printf("%q", "GoLang")	"GoLang"
%x	바이트 슬라이스를 16진수로 출력	fmt.Printf("%x", "Go")	476f
%X	대문자 16진수	fmt.Printf("%X", "Go")	476F

부동소수점 (float, double)

형식	설명	예시	출력
%f	고정 소수점	fmt.Printf("%f", 3.14159)	3.141590
%.2f	소수점 둘째 자리까지	fmt.Printf("%.2f", 3.14159)	3.14
%e	지수형(소문자 e)	fmt.Printf("%e", 3.14159)	3.141590e+00
%E	지수형(대문자 E)	fmt.Printf("%E", 3.14159)	3.141590E+00
%g	자동형식 (짧은 쪽 선택)	fmt.Printf("%g", 3.14159)	3.14159
%G	자동형식 (대문자)	fmt.Printf("%G", 3.14159)	3.14159

포인터

fmt.Printf("%p", &x)	// 0xc0000140a8

 

복합 타입

타입	예시	출력
[]int{1,2,3}	%v	[1 2 3]
map[string]int{"a":1,"b":2}	%v	map[a:1 b:2]
struct{Name string}	%+v	{Name:Go}

폭(width)과 정렬 옵션

형식 지정자 앞에 폭(width)과 정렬 옵션을 지정할 수 있습니다.

예시	설명	출력
%6d	최소 폭 6칸 확보	123
%-6d	왼쪽 정렬	123
%06d	0으로 채움	000123
%10s	문자열 오른쪽 정렬	" Go"

 

주의사항

상황	주의점
타입 불일치	%d로 float이나 string을 출력하면 panic 발생
사용하지 않는 import	fmt를 import했지만 사용하지 않으면 빌드 에러
%v vs %+v 혼동	구조체 로깅 시 %+v를 써야 필드명 표시
실수 포맷	%f는 항상 6자리 소수점 출력 (자동 자르지 않음)
성능 고려	고빈도 로깅에서는 fmt.Sprintf보다 strconv.Itoa 등 직접 변환이 빠름

 

자주 쓰이는 조합 (실무 예시)

log.Printf("Request: %+v", req)          // 구조체 필드명 포함 출력
log.Printf("Response: %#v", resp)         // Go 코드 형태로 출력
fmt.Printf("User ID: %d, Name: %s\n", id, name)
fmt.Printf("Latency: %.3fms\n", latency)
fmt.Printf("Pointer: %p\n", &user)
fmt.Printf("Type: %T, Value: %v\n", v, v)

 

 

요약

범주	형식	설명
일반	%v, %+v, %#v, %T, %%	기본, 필드명 포함, Go문법, 타입
정수	%d, %b, %o, %x, %X, %c, %U	십진, 2진, 8진, 16진, 문자
실수	%f, %e, %E, %g, %G	고정소수, 지수, 자동
문자열	%s, %q, %x, %X	문자열, 인용, hex
포인터	%p	메모리 주소