DocsPricingBlog
Contact Us
Log inSign up for FREE
Back to Tech Articles

Go의 타입 어설션과 타입 스위치 이해하기

Sep 07, 2025
# Go

James Reed

Infrastructure Engineer · Leapcell

This post is also available in English, 日本語, and Deutsch
Cover of "Go의 타입 어설션과 타입 스위치 이해하기"

Go의 인터페이스 시스템은 다형성과 유연한 코드 설계를 가능하게 하는 강력한 기능입니다. 그러나 때로는 인터페이스에 저장된 값의 근본적인 구체적인 타입을 이해하기 위해 더 깊이 파고들어야 할 때가 있습니다. 이때 **타입 어설션(Type Assertion)**과 **타입 스위치(Type Switch)**가 등장합니다. 둘 다 인터페이스 값의 구체적인 타입을 검사하는 데 사용되지만, 목적이 다르고 사용되는 시나리오도 다릅니다.

Go의 인터페이스: 간단한 복습

타입 어설션과 타입 스위치로 들어가기 전에 Go의 인터페이스를 간단히 다시 살펴보겠습니다. Go에서 인터페이스는 메서드 시그니처 집합입니다. 어떤 타입이 인터페이스에 선언된 모든 메서드를 구현하면 해당 인터페이스를 만족합니다. Go의 인터페이스 구현은 암시적입니다. implements 키워드가 없습니다.

package main

import "fmt"

// Greeter는 Greet() string 메서드 하나를 정의하는 인터페이스입니다.
type Greeter interface {
	Greet() string
}

// EnglishSpeaker는 Greeter 인터페이스를 구현하는 구체적인 타입입니다.
type EnglishSpeaker struct {
	Name string
}

func (es EnglishSpeaker) Greet() string {
	return "Hello, " + es.Name
}

// FrenchSpeaker는 Greeter 인터페이스를 구현하는 또 다른 구체적인 타입입니다.
type FrenchSpeaker struct {
	Name string
}

func (fs FrenchSpeaker) Greet() string {
	return "Bonjour, " + fs.Name
}

func main() {
	var g Greeter // g는 인터페이스 변수입니다.

	g = EnglishSpeaker{Name: "Alice"}
	fmt.Println(g.Greet()) // 출력: Hello, Alice

	g = FrenchSpeaker{Name: "Bob"}
	fmt.Println(g.Greet()) // 출력: Bonjour, Bob
}

위 예제에서 g는 다른 구체적인 타입의 값을 보유하지만, g에서 Greeter 인터페이스에 정의된 메서드만 호출할 수 있습니다. 만약 EnglishSpeaker 또는 FrenchSpeaker에만 있는 필드나 메서드에 접근해야 한다면 어떻게 할까요? 이때 타입 어설션이 사용됩니다.

타입 어설션: 내부 들여다보기

타입 어설션은 Go에서 인터페이스 값에서 근본적인 구체적인 값을 추출하여 타입을 단언하는 메커니즘입니다. 인터페이스 값의 동적 타입이 지정된 타입과 일치하는지 확인하고, 일치하면 해당 타입의 근본적인 값을 반환합니다.

타입 어설션의 구문은 i.(T)이며, 여기서 i는 인터페이스 값이고 T는 단언하려는 타입입니다.

타입 어설션에는 두 가지 형태가 있습니다.

1. 단일 값 타입 어설션 (패닉 형태)

이 형태는 T 타입의 근본적인 값을 반환하거나, 근본적인 타입이 T가 아니면 패닉을 발생시킵니다.

package main

import "fmt"

type Greeter interface {
	Greet() string
}

type EnglishSpeaker struct {
	Name string
	Language string
}

func (es EnglishSpeaker) Greet() string {
	return "Hello, " + es.Name
}

func (es EnglishSpeaker) GetLanguage() string {
	return es.Language
}

func main() {
	var g Greeter
	g = EnglishSpeaker{Name: "Alice", Language: "English"}

	// g가 EnglishSpeaker를 보유하고 있다고 단언합니다.
	englishSpeaker := g.(EnglishSpeaker)
	fmt.Printf("Name: %s, Language: %s\n", englishSpeaker.Name, englishSpeaker.GetLanguage())

	// 만약 단언이 실패하면, 패닉이 발생합니다.
	// var otherG Greeter
	// otherSpeaker := otherG.(EnglishSpeaker) // 여기서 패닉 발생: "interface conversion: interface {} is nil, not main.EnglishSpeaker"
}

단일 값 형태는 주의해서 사용해야 하며, 주로 근본적인 타입을 절대적으로 확신할 때 사용됩니다. 의심의 여지가 있다면 두 값 형태가 더 안전합니다.

2. 두 값 타입 어설션 (Comma-OK 관용구)

이것은 선호되는 더 안전한 타입 어설션 형태입니다. 성공하면 근본적인 값과 단언의 성공 여부를 나타내는 불리언 값, 두 가지를 반환합니다. 이를 통해 패닉 없이 타입 불일치를 우아하게 처리할 수 있습니다.

package main

import "fmt"

type Greeter interface {
	Greet() string
}

type EnglishSpeaker struct {
	Name string
	Language string
}

func (es EnglishSpeaker) Greet() string {
	return "Hello, " + es.Name
}

func (es EnglishSpeaker) GetLanguage() string {
	return es.Language
}

type FrenchSpeaker struct {
	Name string
	Country string
}

func (fs FrenchSpeaker) Greet() string {
	return "Bonjour, " + fs.Name
}

func (fs FrenchSpeaker) GetCountry() string {
	return fs.Country
}

func main() {
	speakers := []Greeter{
		EnglishSpeaker{Name: "Alice", Language: "English"},
		FrenchSpeaker{Name: "Bob", Country: "France"},
		EnglishSpeaker{Name: "Charlie", Language: "English"},
	}

	for _, g := range speakers {
		if es, ok := g.(EnglishSpeaker); ok {
			fmt.Printf("%s says '%s' in %s\n", es.Name, es.Greet(), es.GetLanguage())
		} else if fs, ok := g.(FrenchSpeaker); ok {
			fmt.Printf("%s says '%s' from %s\n", fs.Name, fs.Greet(), fs.GetCountry())
		} else {
			fmt.Println("Unknown speaker type.")
		}
	}
}

이 예제에서는 Greeter 인터페이스 슬라이스를 순회합니다. 각 요소에 대해 EnglishSpeaker인지 FrenchSpeaker인지 단언하려고 시도합니다. ok 변수는 단언이 성공했는지 여부를 알려주어 타입별 작업을 수행할 수 있습니다.

타입 어설션에 대한 중요 고려 사항:

  • nil 인터페이스 값: 인터페이스 값이 nil인 경우, 단일 값 형태는 여전히 패닉을 발생시키며, 두 값 형태의 경우 ok 값은 false가 됩니다.
  • 정적 vs. 동적 타입: 타입 어설션은 인터페이스 변수 자체의 정적 타입이 아닌, 인터페이스가 보유한 값의 동적 타입을 검사합니다.
  • 인터페이스 대상 인터페이스 어설션: 인터페이스 타입에서 다른 인터페이스 타입으로 단언할 수도 있습니다. 근본적인 구체 타입이 대상 인터페이스를 구현하면 단언이 성공합니다. 
    type Talker interface {
	Talk() string
}

func (es EnglishSpeaker) Talk() string {
	return es.Greet() + " (Talk)"
}

var g Greeter = EnglishSpeaker{Name: "Alice"}
if t, ok := g.(Talker); ok {
	fmt.Println(t.Talk()) // 출력: Hello, Alice (Talk)
}

타입 스위치: 여러 타입을 우아하게 처리하기

인터페이스 값에 대해 여러 가지 가능한 구체 타입을 처리해야 할 때, 타입 어설션을 사용한 일련의 if-else if 문을 사용하는 것은 번거롭고 덜 읽기 쉬울 수 있습니다. 이때 타입 스위치가 유용합니다.

타입 스위치를 사용하면 인터페이스 값의 동적 타입에 직접 스위치할 수 있습니다. 이는 타입에 따른 작업을 수행하는 더 우아하고 구조화된 방법을 제공합니다.

타입 스위치의 구문은 switch v := i.(type) { ... }이며, 여기서 i는 인터페이스 값입니다. case 블록 안에서 v는 해당 case에서 단언된 타입을 갖게 됩니다.

package main

import "fmt"

type Shape interface {
	Area() float64
}

type Circle struct {
	Radius float64
}

func (c Circle) Area() float64 {
	return 3.14159 * c.Radius * c.Radius
}

func (c Circle) Circumference() float64 {
	return 2 * 3.14159 * c.Radius
}

type Rectangle struct {
	Width, Height float64
}

func (r Rectangle) Area() float64 {
	return r.Width * r.Height
}

func (r Rectangle) Perimeter() float64 {
	return 2 * (r.Width + r.Height)
}

func DescribeShape(s Shape) {
	switch v := s.(type) {
	case Circle:
		fmt.Printf("This is a Circle with Radius %.2f. Area: %.2f, Circumference: %.2f\n", v.Radius, v.Area(), v.Circumference())
	case Rectangle:
		fmt.Printf("This is a Rectangle with Width %.2f, Height %.2f. Area: %.2f, Perimeter: %.2f\n", v.Width, v.Height, v.Area(), v.Perimeter())
	case nil:
		fmt.Println("This is a nil shape.")
	default:
		fmt.Printf("Unknown shape type: %T\n", v) // %T는 v의 타입을 출력합니다.
	}
}

func main() {
	shapes := []Shape{
		Circle{Radius: 5},
		Rectangle{Width: 4, Height: 6},
		Circle{Radius: 10},
		nil, // nil 인터페이스 값을 나타냅니다.
		// Shape가 interface{}였다면 여기에 문자열을 넣을 수도 있고, 기본 케이스로 빠질 것입니다.
		// Shape (메서드가 있는 경우)의 경우, Shape를 구현하는 타입만 할당할 수 있습니다.
	}

	for _, s := range shapes {
		DescribeShape(s)
	}
}

DescribeShape 함수에서 switch s.(type) 문을 사용하면 구체적인 타입에 따라 다른 모양을 처리할 수 있습니다. 각 case 블록 안에서 변수 v는 자동으로 단언된 타입을 보유하므로 해당 타입별 필드 및 메서드에 직접 액세스할 수 있습니다.

타입 스위치의 주요 기능:

  • 포괄적인 검사: 명시적으로 다루지 않은 타입을 처리하기 위해 default 케이스를 포함하는 것이 좋습니다.
  • nil 케이스: case nil:을 사용하여 nil 인터페이스 값을 명시적으로 처리할 수 있습니다.
  • 타입 결정: case T: 안에서 변수(v 예제)는 자동으로 T 타입이 되므로 해당 블록 내에서 추가 타입 어설션이 필요하지 않습니다.
  • Fallthrough 없음: Go의 일반 switch 문과 마찬가지로 타입 스위치에는 암시적인 fallthrough가 없습니다.
  • 순서: 인터페이스 타입이 다른 인터페이스 타입의 부분 집합인 경우(이는 구체적인 타입에서는 덜 일반적이지만)를 제외하고 case 절의 순서는 일반적으로 중요하지 않습니다.

언제 무엇을 사용해야 할까?

타입 어설션과 타입 스위치 사이의 선택은 특정 요구 사항에 따라 달라집니다.

  • 단일 값 타입 어설션 (i.(T)) 사용

    • 근본적인 타입을 절대적으로 확신하고 패닉이 허용되는 실패 모드인 경우(예: 사전 조건이 보장되는 내부 라이브러리 함수).
    • 일반적으로 애플리케이션 코드에서는 이 형태를 덜 선호합니다.

  • 두 값 타입 어설션 (v, ok := i.(T)) 사용

    • 인터페이스 값이 특정 경우에는 예상되지만, 그렇지 않을 때 우아하게 처리해야 하는 경우.
    • 데이터를 파싱하거나 이기종 컬렉션을 처리할 때 일반적입니다.
    • 하나 또는 두 개의 특정 타입만 확인하려는 경우.

  • 타입 스위치 (switch v := i.(type) { ... }) 사용

    • 인터페이스 값에 대해 여러 개의 서로 다른 구체 타입을 처리해야 하는 경우.
    • 타입에 따라 로직을 디스패치하는 깔끔하고 읽기 쉬우며 구조화된 방법을 제공합니다.
    • 기본 타입에 따라 다른 작업을 수행하거나 타입별 필드/메서드에 액세스하려는 경우.
    • 모든 Go 값을 보유할 수 있는 interface{}(빈 인터페이스)를 다룰 때, 타입 스위치는 임의의 데이터를 검사하는 강력한 도구입니다.

모범 사례 및 고려 사항

  • 다형성을 위한 인터페이스, 타입 검색을 위한 인터페이스가 아님: 타입 어설션과 타입 스위치를 통해 동적 타입을 검사할 수는 있지만, 인터페이스의 주요 목적은 다형성을 가능하게 하는 것입니다. 즉, 구체적인 구현과 상관없이 인터페이스를 만족하는 모든 타입으로 작동하는 코드를 작성하는 것입니다. 타입 어설션/스위치에 지나치게 의존하는 것은 인터페이스 설계를 개선해야 한다는 신호일 수 있습니다.
  • 덕 타이핑(Duck Typing) 선호: Go의 암시적 인터페이스 구현은 "덕 타이핑"("오리처럼 걷고 오리처럼 꽥꽥거린다면 그것은 오리다")을 장려합니다. 모든 필요한 동작을 포착하는 인터페이스를 설계하여 타입별 검사의 필요성을 최소화하려고 노력하세요.
  • 런타임 오버헤드: 타입 어설션과 타입 스위치에는 동적 타입 정보를 조회해야 하므로 약간의 런타임 오버헤드가 수반됩니다. 대부분의 애플리케이션에서는 이는 사소합니다.
  • 정적 vs. 동적 타입 오류: 단일 값 형태의 타입 어설션 실패는 런타임 패닉(동적 오류)을 발생시킵니다. 타입 스위치와 두 값 어설션을 사용하면 타입 불일치를 우아하게 처리하여 잠재적인 런타임 패닉을 제어된 로직 경로로 전환할 수 있습니다.
  • 빈 인터페이스 interface{}: 빈 인터페이스는 모든 값을 보유할 수 있습니다. 타입 어설션과 타입 스위치는 JSON 디코딩, 리플렉션 또는 제네릭 데이터 구조와 같은 컨텍스트에서 널리 사용되는 interface{}를 다룰 때 특히 중요합니다.
package main

import (
	"encoding/json"
	"fmt"
)

func main() {
	// interface{}와 JSON 데이터에 대한 타입 스위치 예제
	jsonString := `{"name": "Go", "version": 1.22, "stable": true, "features": ["generics", "modules"]}`

	var data map[string]interface{}
	err := json.Unmarshal([]byte(jsonString), &data)
	if err != nil {
		panic(err)
	}

	for key, value := range data {
		fmt.Printf("Key: %s, Value: %v, Type (before switch): %T\n", key, value, value)
		switch v := value.(type) {
		case string:
			fmt.Printf("  -> This is a string: \"%s\"\n", v)
		case float64: // JSON 숫자는 기본적으로 float64로 언마샬됩니다.
			fmt.Printf("  -> This is a number: %.2f\n", v)
		case bool:
			fmt.Printf("  -> This is a boolean: %t\n", v)
		case []interface{}: // JSON 배열은 []interface{}로 언마샬됩니다.
			fmt.Printf("  -> This is an array of length %d. Elements:\n", len(v))
			for i, elem := range v {
				fmt.Printf("    [%d]: %v (Type: %T)\n", i, elem, elem)
			}
		default:
			fmt.Printf("  -> Unknown type for %s: %T\n", key, v)
		}
		fmt.Println("---")
	}
}

이 예제는 interface{}가 널리 사용되는 JSON과 같은 동적 타입 데이터 구조를 다룰 때 타입 스위치가 얼마나 유용할 수 있는지 보여줍니다.

결론

타입 어설션과 타입 스위치는 Go에서 인터페이스 값과 더 깊이 상호 작용하기 위한 기본 기능입니다. 이를 통해 인터페이스에 저장된 값의 구체적인 타입을 검사하고 타입별 작업을 수행할 수 있습니다. 이러한 메커니즘을 효과적으로 사용하는 방법을 이해하는 것은 특히 다형성 또는 이기종 데이터를 다룰 때 강력하고 유연하며 유지보수 가능한 Go 프로그램을 작성하는 데 중요합니다. 강력하지만, 설계를 통해 구체적인 타입을 살펴봐야 할 필요가 있는지, 아니면 더 추상적인 인터페이스 기반 접근 방식이 명시적인 타입 검사 없이 원하는 유연성을 달성할 수 있는지 항상 고려해야 합니다.

Share this article

HackerNews

More Posts from Leapcell

Popular Posts