Golang 변수: var, :=, 제로 값, 섀도잉

Go에서 변수를 선언하는 방법은 두 가지입니다. 어디서나 쓸 수 있는 var, 그리고 함수 안에서만 쓸 수 있고 타입을 추론하는 짧은 형태 :=입니다.

package main

import "fmt"

func main() {
	var city string = "Lisbon" // explicit type and value
	var year = 2026            // type inferred as int
	var score int              // no value: zero value 0
	name := "Ana"              // short declaration, inferred string

	fmt.Println(city, year, score, name)
	fmt.Printf("%T %T %T %T\n", city, year, score, name)
}

모든 변수는 컴파일 타임에 정해지는 고정된 타입을 가집니다. 값을 주면 Go가 그 값에서 타입을 추론하므로, 타입까지 적는 것(var city string = "Lisbon")은 문법상 맞지만 중복입니다.

var와 :=

함수 안에서의 관용적인 선택:

• 시작 값이 있으면 x := value.
• 제로 값을 원하면 var x T. "일부러 비워 둔 것"이라는 신호가 됩니다: var buf bytes.Buffer, var total int.
• 추론되는 타입이 원하는 타입이 아니면 var x T = value. 예를 들어 var ratio float64 = 1 (그냥 ratio := 1이라고 쓰면 int가 됩니다).

함수 밖의 :=는 문법 오류입니다:

./main.go:5:1: syntax error: non-declaration statement outside function body

제로 값

값 없이 선언된 변수에 쓰레기 값이 들어 있는 일은 없습니다. 그 타입의 제로 값을 가집니다:

package main

import "fmt"

type Point struct {
	X, Y int
}

func main() {
	var i int
	var f float64
	var b bool
	var s string
	var p *int
	var sl []int
	var m map[string]int
	var pt Point

	fmt.Println(i, f, b, s == "", p, sl == nil, m == nil, pt)
	fmt.Println(len(sl), len(m), m["missing"])
}

좋은 Go API는 제로 값이 쓸모 있도록 설계됩니다. 제로 값 sync.Mutex는 잠기지 않은 상태이고, 제로 값 bytes.Buffer는 비어 있으며 바로 쓸 수 있고, len, range, append는 모두 nil 슬라이스에서 동작합니다. 주의할 것은 맵입니다. nil 맵을 읽으면 제로 값이 나오지만, 쓰면 패닉이 납니다. 값을 저장하기 전에 make나 리터럴로 맵을 만드세요.

변수 여러 개 선언하기

package main

import "fmt"

var (
	appName = "inventory"
	version = "1.4.0"
	debug   bool
)

func main() {
	var width, height int = 1920, 1080
	x, y := 3, 4
	first, count := "widget", 12

	fmt.Println(appName, version, debug)
	fmt.Println(width, height, x, y, first, count)

	// swap without a temporary variable
	x, y = y, x
	fmt.Println("after swap:", x, y)
}

var ( ... ) 블록은 관련된 패키지 수준 변수를 묶습니다. x, y = y, x 같은 다중 대입에서는 대입하기 전에 오른쪽 표현식을 모두 평가하므로 값 교환이 동작합니다.

이름이 여럿인 :=는 왼쪽 이름 중 하나 이상이 새 이름이면 문제없이 동작합니다. 같은 스코프에 이미 있는 이름에는 그냥 대입됩니다. 그래서 err를 재사용할 수 있습니다:

f, err := os.Open("a.txt")   // declares f and err
g, err := os.Open("b.txt")   // declares g, assigns to the existing err

새 이름이 하나도 없으면 오류입니다:

./main.go:7:4: no new variables on left side of :=

이미 있는 변수에 대입할 때는 그냥 =를 쓰세요.

사용하지 않는 변수는 오류다

선언만 하고 한 번도 읽지 않는 지역 변수가 있으면 빌드가 멈춥니다:

./main.go:9:2: declared and not used: x

끌 수 있는 경고가 아닙니다. 변수를 지우거나, 사용하거나, 디버깅 중이라면 빈 식별자로 조용히 만드세요: _ = x. 빈 식별자는 필요 없는 반환 값을 버릴 때도 씁니다: _, err := fmt.Println("hi").

패키지 수준 변수와 함수 매개변수는 이 규칙에서 예외입니다.

스코프와 섀도잉

변수는 선언된 지점부터 감싸는 블록({ ... })의 끝까지 존재합니다. 안쪽 블록의 :=는 바깥에 같은 이름의 변수가 있어도 새 변수를 만듭니다. 바깥 변수는 바뀌지 않고 가려집니다:

package main

import (
	"fmt"
	"strconv"
)

func main() {
	count := 0
	input := "42"

	if input != "" {
		count, err := strconv.Atoi(input) // new count, only inside this block
		if err != nil {
			fmt.Println("error:", err)
			return
		}
		fmt.Println("inside:", count)
	}

	fmt.Println("outside:", count) // still 0
}

이 프로그램은 inside: 42를 출력한 다음 outside: 0을 출력합니다. if 안의 :=는 count와 err를 모두 안쪽 블록의 새 변수로 선언했습니다. 둘 다 그 블록에는 아직 없었기 때문입니다. 깔끔하게 컴파일되며, "내 값이 사라졌다" 버그의 전형적인 원인입니다.

해결책은 err를 먼저 선언하고 =로 대입하는 것입니다:

var err error
count, err = strconv.Atoi(input)

go vet은 기본적으로 섀도잉을 보고하지 않습니다. 별도의 shadow 분석기가 보고하며, golangci-lint 같은 린터에서 켤 수 있습니다.

이름 짓기

• camelCase를 씁니다: maxRetries, userID. max_retries는 쓰지 않습니다.
• 약어는 대소문자를 통일합니다: userID, httpClient, parseURL. userId는 쓰지 않습니다.
• 스코프가 짧으면 이름도 짧게: 반복문의 i, 리더의 r, 오류의 err. 패키지 수준 변수에는 길고 설명적인 이름을 씁니다.
• 패키지 수준의 대문자 이름(var Timeout)은 다른 패키지로 공개됩니다. 패키지와 import 페이지를 참고하세요.

패키지 수준 변수

함수 밖에서 선언된 변수는 프로그램 전체 기간 동안 살아 있고, main이 실행되기 전에 의존성 순서대로 초기화됩니다. 설정이나 캐시에 편리하며, 모든 고루틴이 공유합니다. 둘 이상의 고루틴이 같은 변수에 쓴다면 뮤텍스로 보호하거나 sync/atomic을 쓰세요. 그렇지 않으면 데이터 레이스가 생깁니다.

바뀌지 않는 값에는 상수를 쓰세요. const는 실수로 수정될 수 없고 런타임 비용도 없습니다.