문서가격블로그
문의하기
로그인무료로 가입하기
Back to Tech Articles

Go 코드 생성의 진화: `go:generate`와 제네릭의 상호 작용

11월 04, 2025
# Misc

Daniel Hayes

Full-Stack Engineer · Leapcell

이 게시물은 English, 日本語 및 Deutsch에서도 볼 수 있습니다.
Cover of "Go 코드 생성의 진화: `go:generate`와 제네릭의 상호 작용"

소개

수년 동안 Go 개발자들은 Go 언어의 초기 제네릭 부재를 극복하기 위해 영리한 기법들을 활용해 왔습니다. 한 가지 두드러진 해결책은 소스 파일에서 직접 코드 생성을 가능하게 하는 강력한 지시어인 go:generate였습니다. 이를 통해 반향(reflection)이나 interface{}에 묶인 복잡한 인터페이스에 의존하지 않고도 데이터 구조, 직렬화(serialization), 객체 관계 매핑과 같은 일반적인 패턴에 대해 타입 안전한(type-safe) 솔루션을 만들 수 있었습니다. 그러나 Go 1.18에 제네릭이 도입되면서 Go 개발 환경은 근본적으로 바뀌었습니다. 이 중요한 업데이트는 네이티브 타입 파라미터화를 가져와 go:generate가 이전에 다루었던 많은 문제들을 직접적으로 해결합니다. 이 글은 Go 코드 생성의 현재 상태를 깊이 파고들어, go:generate의 지속적인 관련성을 살펴보고 제네릭이 그 역할을 진정으로 대체하는지 또는 공생 관계가 존재하는지 분석합니다.

Go에서의 코드 생성 기초

이들의 상호 작용을 논하기 전에, 핵심 개념인 go:generate와 Go 제네릭에 대한 명확한 이해를 확립해 봅시다.

go:generate: 코드 생성 오케스트레이터

go:generate 자체는 코드 생성기가 아니라 Go 툴체인에게 외부 명령을 실행하도록 지시하는 지시어입니다. 이 명령, 일반적으로 사용자 정의 스크립트나 전용 코드 생성 도구는 Go 소스 코드 파일을 생성합니다. go:generate의 진정한 힘은 반복적인 작업을 자동화하고 Go의 타입 시스템이 전통적으로 도달할 수 없었던 곳에서 타입 안전성을 보장하는 능력에 있습니다.

일반적인 시나리오를 생각해 봅시다: 사용자 정의 타입에 대한 스레드 안전(thread-safe) 맵을 만드는 것. 제네릭 이전에는 타입 검사(type assertion)를 사용하는 map[interface{}]interface{}(안전하지 않고 느림)를 사용하거나 각 타입마다 사용자 정의 맵을 작성해야 했습니다. go:generate는 절충안을 제공했습니다.

// mypackage/mytype.go
package mypackage

//go:generate stringer -type MyEnum
type MyEnum int

const (
	EnumOne MyEnum = iota
	EnumTwo
	EnumThree
)

type MyData struct {
    ID   string
    Name string
}

이 예에서 go:generate stringer -type MyEnum은 go generate 명령에게 stringer 도구를 실행하도록 지시합니다. stringer는 MyEnum 타입을 읽고 일반적으로 myenum_string.go라는 파일에 해당 타입에 대한 String() 메서드를 자동으로 생성합니다.

// myenum_string.go (stringer에 의해 생성됨)
// "stringer -type MyEnum"에 의해 생성된 코드; 편집하지 마십시오.

package mypackage

import "strconv"

func (i MyEnum) String() string {
	switch i {
	case EnumOne:
		return "EnumOne"
	case EnumTwo:
		return "EnumTwo"
	case EnumThree:
		return "EnumThree"
	default:
		return "MyEnum(" + strconv.FormatInt(int64(i), 10) + ")"
	}
}

이는 반복적인 코드를 깔끔하게 자동화하여 mytype.go를 비즈니스 로직에 집중하도록 유지합니다. 다른 인기 있는 go:generate 도구로는 인터페이스를 위한 mockgen, json-iterator의 코드 생성, API 클라이언트 생성을 위한 다양한 도구 등이 있습니다.

Go 제네릭: 네이티브 타입 파라미터화

Go 1.18에 도입된 제네릭은 코드를 각 타입에 대해 다시 작성할 필요 없이 다양한 타입 인수로 작동하는 함수와 타입을 작성할 수 있는 방법을 제공합니다. 이는 타입 매개변수를 통해 달성됩니다.

스레드 안전 맵 예시로 돌아가 봅시다. 제네릭을 사용하면 이제 모든 키와 값 타입에 대해 작동하는 SafeMap을 정의할 수 있습니다.

// util/safemap.go
package util

import "sync"

type SafeMap[K comparable, V any] struct {
	mu    sync.RWMutex
	items map[K]V
}

func NewSafeMap[K comparable, V any]() *SafeMap[K, V] {
	return &SafeMap[K, V]{
		items: make(map[K]V),
	}
}

func (m *SafeMap[K, V]) Set(key K, value V) {
	m.mu.Lock()
	defer m.mu.Unlock()
	m.items[key] = value
}

func (m *SafeMap[K, V]) Get(key K) (V, bool) {
	m.mu.RLock()
	defer m.mu.RUnlock()
	val, ok := m.items[key]
	return val, ok
}

func (m *SafeMap[K, V]) Delete(key K) {
	m.mu.Lock()
	defer m.mu.Unlock()
	delete(m.items, key)
}

이제 mypackage에서 이 SafeMap을 코드 생성 없이 직접 사용할 수 있습니다.

// mypackage/main.go
package main

import (
	"fmt"
	"mypackage/util" // util이 GOPATH 또는 모듈 경로에 있다고 가정
)

type User struct {
    ID string
    Name string
}

func main() {
    // 문자열 키와 User 값에 대한 SafeMap 생성
    userMap := util.NewSafeMap[string, User]() 
    userMap.Set("1", User{ID: "1", Name: "Alice"})
    userMap.Set("2", User{ID: "2", Name: "Bob"})

    if alice, ok := userMap.Get("1"); ok {
        fmt.Printf("Found user: %s\n", alice.Name)
    }

    // int 키와 float64 값에 대한 SafeMap 생성
    values := util.NewSafeMap[int, float64]()
    values.Set(10, 3.14)
    values.Set(20, 2.71)
}

이는 제네릭이 가져오는 우아함과 타입 안전성을 보여주며, 이 특정 사용 사례에서 go:generate의 필요성을 직접적으로 제거합니다.

go:generate 대 제네릭: 수렴하는 경로인가, 발산하는 경로인가?

제네릭의 도입은 의심할 여지 없이 go:generate가 이전에 사용되었던 문제들의 상당 부분을 해결했습니다. 표준 라이브러리의 constraints, slices, maps와 같은 많은 유틸리티들이 이제 제네릭을 사용하여 제네릭 연산을 타입 안전하게 제공하며, 이는 이전에는 사용자 정의 go:generate 솔루션을 필요로 했을 것입니다.

그러나 제네릭이 go:generate를 완전히 대체하는 것이 아니라는 점을 이해하는 것이 중요합니다. 오히려 그것들은 역할의 정의를 재정의합니다.

제네릭이 탁월하고 go:generate 사용을 줄이는 곳

  1. 제네릭 데이터 구조: SafeMap에서 보았듯이, 제네릭은 리스트, 큐, 스택, 트리, 맵과 같은 타입에 구애받지 않는 데이터 구조를 완전한 타입 안전성으로 구현하는 데 완벽합니다.
  2. 제네릭 알고리즘: 컬렉션(예: Max, Min, Filter, Map, Reduce)을 작동하는 함수는 이제 제네릭을 사용하여 한 번 작성할 수 있으므로 각 특정 타입에 대한 함수를 생성할 필요가 없습니다. 표준 slices 및 maps 패키지가 대표적인 예입니다.
  3. 타입 안전 유틸리티: 다양한 타입을 작동해야 하지만 일관된 논리(예: 비교, 복제 또는 공통 인터페이스 간 변환)를 따르는 모든 유틸리티 함수는 이제 제네릭을 사용하여 구현할 수 있습니다.

이러한 영역에서 제네릭은 go:generate의 필요성을 크게 줄여 더 깨끗하고 읽기 쉬우며 덜 장황한 코드베이스로 이어집니다.

go:generate가 강점을 유지하는 곳

제네릭의 강력함에도 불구하고, go:generate는 제네릭만으로는 해결책을 제공할 수 없는 여러 주요 영역에서 중요성을 유지합니다.

  1. 반향/메타데이터 기반 코드: go:generate는 타입 매개변수뿐만 아니라 구조적 정보(구조 태그, 메서드 시그니처) 또는 외부 메타데이터를 기반으로 코드를 생성해야 할 때 필수적입니다.
    • 직렬화/역직렬화: json-iterator와 같은 도구는 때때로 성능을 위해 구조 태그를 기반으로 최적화된 마샬러/언마샬러를 생성합니다.
    • 데이터베이스 ORM/스캐너: 많은 ORM은 구조 필드와 관련된 데이터베이스 열 매핑을 기반으로 반복적인 SQL 스캐닝 또는 객체 매핑 코드를 생성합니다.
    • API 클라이언트 생성: OpenAPI/Swagger 사양에서 클라이언트 코드를 생성하는 것은 외부 정의를 처리하고 Go 타입 및 함수에 매핑하는 것을 포함합니다.
  2. 타입 동작을 변경하는 반복 코드 (메서드 추가): 제네릭은 주로 기존 타입을 작동하거나 새로운 제네릭 타입/함수를 정의하는 데 중점을 둡니다. go:generate 도구가 할 수 있는 방식과 같이 구체적인 타입의 기본 동작을 직접적으로 주입하는 새로운 메서드를 일반적으로 포함하지는 않습니다. stringer 예시는 여기에 완벽합니다. 제네릭은 int 또는 사용자 정의 열거형(enum) 타입에 String() 메서드를 자동으로 추가할 수 없습니다.
  3. 타사 사양/IDL과의 인터페이스: Protocol Buffers, GraphQL 스키마 또는 기타 인터페이스 정의 언어(Interface Definition Languages)에서 Go 코드를 생성해야 할 때 go:generate가 선호되는 메커니즘입니다. 이러한 도구는 별도의 정의 파일을 읽고 Go 구조체, 인터페이스 및 메서드를 생성합니다.
  4. 모킹(Mocking): mockgen과 같은 도구는 인터페이스를 검사하고 구체적인 mock 구현을 생성하며, 이는 제네릭의 범위를 완전히 벗어나는 작업입니다.

시너지 효과의 미래

경쟁하는 힘으로 보기보다는, go:generate와 제네릭을 상호 보완적인 도구로 보는 것이 더 정확합니다.

  • 제네릭은 '타입에 구애받지 않는 로직' 문제를 처리합니다. 다양한 타입에 적응하는 제네릭 알고리즘과 데이터 구조를 작성할 수 있게 해줍니다.
  • go:generate는 '메타데이터 기반 반복 코드' 문제를 처리합니다. 타입 구조나 외부 정의에 특화된 코드 생성을 자동화하여, 제네릭으로 제공할 수 없는 메서드나 특화된 구현을 추가할 수 있게 해줍니다.

예를 들어, 제네릭을 사용하여 일반적인 Repository 인터페이스를 만들 수 있지만, go:generate는 이 리포지토리를 구현하는 특정 구체적 타입에 대한 SQL 테이블 매핑을 생성하거나 데이터 전송 객체(data transfer object)를 위한 protobuf 메시지 정의를 생성하는 데 사용될 수 있습니다.

// 둘 다 결합한 가상 시나리오:

//go:generate protoc --go_out=. --go_opt=paths=source_relative mydata.proto
// 이는 protobuf 정의에서 Go 구조체를 생성합니다.

// mydata.proto
 syntax "proto3";

 package mypackage;

 message UserProto {
   string id = 1;
   string name = 2;
 }

그런 다음 이러한 protobuf 생성 구조체를 작업하기 위해 제네릭을 사용할 수 있습니다.

package main

import (
	"fmt"
	"mypackage" // 생성된 UserProto 포함
	"mypackage/util" // 우리의 제네릭 SafeMap
)

func main() {
	userMap := util.NewSafeMap[string, *mypackage.UserProto]()
	userMap.Set("1", &mypackage.UserProto{Id: "1", Name: "Alice"})

	if alice, ok := userMap.Get("1"); ok {
		fmt.Printf("Retrieved user from generic map: %s\n", alice.Name)
	}
}

여기서 go:generate는 외부 정의에서 mypackage.UserProto 타입을 생성하고, 제네릭(우리의 SafeMap)은 해당 생성된 타입의 인스턴스를 관리하는 타입 안전한 방법을 제공합니다.

결론

제네릭의 등장은 의심할 여지 없이 go:generate의 필요성을 정교하게 다듬었으며, 제네릭 데이터 구조와 알고리즘에 대한 사용량을 크게 줄였습니다. 그러나 go:generate는 메타데이터, 외부 정의에 의해 구동되는 반복 코드 생성 또는 특화된 메서드를 주입하는 필요성을 자동화하는 데 중요한 역할을 유지합니다. 하나가 다른 하나를 대체하기보다는, 이제 더 성숙하고 구별되는 파트너십을 형성하여 Go 개발자가 작업에 맞는 도구를 선택함으로써 더 깨끗하고 효율적이며 타입 안전한 코드를 작성할 수 있도록 합니다. go:generate는 현대 Go 생태계에서 유물이 아니라 강력한 보완 도구로 남아 있습니다.

Share this article

HackerNews

More Posts from Leapcell

cover

Go의 HTTP 클라이언트 전송 계층 심층 분석

cover

Go 1.21+ slog를 활용한 구조화 로깅 심층 분석 및 마이그레이션 가이드

Popular Posts