[IT-정보] Go 변수 실수 모음과 해결법 – 입문자가 놓치기 쉬운 문법 가이드

왜 Go 변수 선언에서 자꾸 에러가 날까요

코드를 한 줄 적었는데 화면이 온통 빨간색으로 변한 적이 있나요? 분명히 문법 책에서 본 대로 변수를 선언했는데, 컴파일러는 “unused variable”이라며 화를 내고 실행조차 되지 않는 상황 말이에요. Go 언어를 처음 접하는 개발자라면 누구나 한 번쯤 겪게 되는 아주 당혹스러운 순간이에요.

Go는 다른 언어에 비해 매우 엄격한 규칙을 가지고 있어요. 파이썬이나 자바스크립트처럼 대충 적고 넘어가 주는 너그러움이 없죠. 선언만 하고 쓰지 않은 변수가 하나라도 있으면 프로그램은 시작조차 하지 않아요. 이런 엄격함은 초기 학습 단계에서는 마치 거대한 벽처럼 느껴질 수 있지만, 사실은 더 큰 버그를 미리 막아주는 아주 고마운 방어 기제예요.

이 글을 끝까지 읽고 나면, 단순한 문법 암기를 넘어 Go가 왜 이런 방식을 채택했는지 이해하게 될 거예요. 또한, 실제 프로젝트를 진행하면서 마주칠 수 있는 변수 쉐도잉(Shadowing) 문제나 상수 사용 시의 실수들을 완벽하게 피하는 법을 배우게 돼요. 단순히 에러를 고치는 법이 아니라, Go답게 코드를 짜는 감각을 익히는 것이 이 글의 목표예요.

본격적인 코딩 전, 변수와 상수의 기초 체력 기르기

Go 프로그래밍을 시작하기 전에 반드시 머릿속에 넣어두어야 할 개념들이 있어요. 변수는 값이 변할 수 있는 저장 공간이고, 상수는 한 번 정하면 절대로 바꿀 수 없는 값을 의미해요. 하지만 Go에서는 이 둘을 다루는 방식이 매우 정교하게 설계되어 있어요. 무턱대고 코드를 치기 전에, 어떤 상황에서 어떤 도구를 꺼내 써야 할지 기준을 세워두는 것이 중요해요.

특히 Zero Value(제로 값) 개념은 반드시 숙지해야 해요. Go는 변수를 선언할 때 초기값을 주지 않아도 메모리를 깨끗하게 비워진 상태로 만들어줘요. 이를 통해 쓰레기 값이 들어있어 발생하는 예측 불가능한 오류를 원천 차단하죠. 하지만 이 제로 값이 무엇인지 정확히 모른다면, 나중에 로직이 꼬이는 원인이 될 수 있어요.

선언 방식에 따른 선택 기준

어떤 상황에서 var를 쓰고, 어떤 상황에서 :=(단축 선언)을 써야 할까요? 이 기준만 명확히 세워도 코드의 가독성이 확연히 달라져요. 아래 표를 통해 상황별 최적의 선택지를 확인해 보세요.

이 표를 보면 알 수 있듯이, 모든 곳에서 :=(단축 선언)을 쓸 수는 없어요. 패키지 수준(함수 밖)에서는 반드시 var를 사용해야 한다는 점을 꼭 기억하세요. 이 규칙을 어기면 컴파일러가 즉시 오류를 뱉어낼 거예요.

실전! Go 변수와 상수 활용의 5단계 마스터 플랜

이제 이론을 넘어 실제 코드로 어떻게 적용하는지 살펴볼게요. Go의 변수 시스템은 단순해 보이지만, 깊게 들어갈수록 정교한 규칙들이 숨어 있어요. 단계별로 차근차근 따라오며 감각을 익혀보세요.

STEP 1. 선언 스타일의 완벽한 구분

가장 먼저 마주하는 관문은 var와 :=의 차이를 이해하는 거예요. var는 가장 정석적인 방법이에요. 타입을 명시할 수도 있고, 초기값 없이 선언하여 제로 값으로 시작할 수도 있죠. 반면 :=는 코드를 아주 간결하게 만들어줘요. 하지만 이 강력한 도구에는 제약이 있어요.

첫째, :=는 오직 함수 내부에서만 사용할 수 있어요. 함수 밖에서 전역 변수를 선언할 때는 무조건 var를 써야 해요. 둘째, :=를 사용할 때는 반드시 왼쪽에 최소한 하나의 새로운 변수가 있어야 해요. 이미 선언된 변수만으로는 단축 선언을 할 수 없거든요. 이 차이를 모르면 엉뚱한 곳에서 컴파일 에러를 마주하게 돼요.

STEP 2. 타입 추론과 명시적 타입 지정의 균형

Go는 매우 강력한 타입 시스템을 가지고 있어요. x := 10이라고 적으면 Go는 자동으로 int 타입으로 간주해요. 하지만 때로는 명확하게 var x int64 = 10처럼 타입을 지정해야 할 때가 있어요. 특히 숫자 계산을 할 때 int와 float64, 혹은 int32와 int64 사이의 연산은 Go에서 허용되지 않아요.

자바스크립트처럼 숫자를 대충 섞어서 계산할 수 있다고 생각하면 큰 오산이에요. 타입이 다르면 컴파일러는 이를 다른 존재로 인식해요. 따라서 데이터의 크기나 정밀도가 중요한 금융 서비스나 시스템 프로그래밍을 할 때는 처음부터 타입을 아주 엄격하게 관리하는 습관을 들여야 해요.

STEP 3. 제로 값(Zero Value)을 활용한 안전한 설계

Go의 가장 큰 장점 중 하나는 변수를 선언하자마자 안전한 상태가 된다는 점이에요. int는 0, string은 빈 문자열(“”), bool은 false로 초기화돼요. 이를 활용하면 초기화 로직을 단순화할 수 있어요.

예를 들어, 사용자 정보를 담는 구조체를 만들었을 때, 별도의 초기화 함수 없이도 각 필드는 Go가 정한 기본값으로 채워져 있어요. 이는 메모리 오염을 막아주는 아주 훌륭한 기능이죠. 하지만 포인터 타입의 경우 제로 값이 nil이라는 점을 주의해야 해요. nil 상태인 포인터에 접근하려 하면 프로그램이 즉시 중단(panic)될 수 있으니까요.

STEP 4. 상수를 통한 불변성 유지하기

프로그램 전체에서 변하지 않는 설정값, 예를 들어 API의 타임아웃 시간이나 최대 접속자 수 같은 값들은 반드시 const로 선언해야 해요. 상수를 사용하면 코드 중간에 실수로 값이 바뀌는 것을 방지할 수 있고, 코드를 읽는 사람에게도 “이 값은 절대 변하지 않아”라는 강력한 메시지를 전달할 수 있어요.

여기서 한 가지 재미있는 점은 Go의 상수가 untyped constant(타입이 없는 상수)로 존재할 수 있다는 거예요. 상수를 선언할 때 타입을 명시하지 않으면, 상수는 사용되는 맥락에 따라 유연하게 타입을 결정해요. 이 덕분에 상수와 변수 간의 타입 계산이 다른 언어보다 훨씬 매끄럽게 이루어지는 마법을 경험할 수 있어요.

STEP 5. 변수 쉐도잉(Shadowing) 함정 피하기

입문자가 가장 많이 빠지는 늪이 바로 변수 쉐도잉이에요. 이는 상위 스코프에 있는 변수와 동일한 이름의 변수를 하위 스코프(예: if문이나 for문 내부)에서 다시 선언할 때 발생해요. 겉으로 보기에는 변수의 값이 바뀌는 것처럼 보이지만, 실제로는 새로운 변수가 만들어져 기존 변수를 가리고 있는 상태인 거죠.

이 문제는 런타임에 매우 찾기 힘든 버그를 만들어내요. 분명히 값을 변경했는데, 함수가 끝나고 나니 원래 변수의 값은 그대로인 황당한 상황이 벌어지는 이유가 바로 이것 때문이에요. 이를 방지하기 위해서는 변수 이름을 짓을 때 지나치게 일반적인 단어(예: err, data)를 남발하지 않거나, 스코프의 범위를 명확히 인지하는 습관이 필요해요.

자주 하는 실수와 해결법 및 FAQ

코딩을 하다 보면 머리로는 이해했는데 손이 꼬이는 순간이 있죠. Go 개발자들이 가장 자주 저지르는 실수들을 모아봤어요. 에러 메시지를 만났을 때 당황하지 말고 이 리스트를 확인해 보세요.

자주 하는 실수와 해결법

❌ 선언만 하고 사용하지 않은 변수
왜 발생하는가: Go 컴파일러는 사용되지 않는 변수를 허용하지 않아요. 이는 메모리 낭비와 잠재적 버그를 방지하기 위함이에요.
✅ 해결법: 변수가 정말 필요한지 확인하고, 필요 없다면 즉시 삭제하세요. 디버깅 중이라면 잠시 fmt.Println(variable)을 사용해 강제로 사용 흔적을 남기세요.

❌ 함수 밖에서 := 사용하기
왜 발생하는가: 단축 선언은 반드시 함수 블록 내부에서만 동작하도록 설계되어 있어요.
✅ 해결법: 패키지 레벨의 변수는 반드시 var 키워드를 사용하여 선언하세요.

❌ 타입이 다른 변수 간의 직접 연산
왜 발생하는가: Go는 암시적 타입 변환(Implicit Conversion)을 지원하지 않아요. int와 int64는 엄연히 다른 타입이에요.
✅ 해결법: int64(myInt) + myInt64와 같이 명시적으로 타입을 변환하여 연산하세요.

❌ 변수 쉐도잉으로 인한 값 누락
왜 발생하는가: if나 for문 안에서 :=를 써서 기존 변수를 덮어쓰는 새로운 변수를 만들었기 때문이에요.
✅ 해결법: 새로운 변수를 선언하는 대신, 이미 선언된 변수에 값을 할당할 때는 = 연산자만 사용하세요.

❌ 상수(const)에 값 재할당 시도
왜 발생하는가: 상수는 컴파일 타임에 값이 결정되며, 런타임 중에 변경할 수 없어요.
✅ 해결법: 값이 바뀌어야 한다면 상수가 아닌 변수(var)로 선언을 변경하세요.

자주 묻는 질문

Q. Go에서 변수를 선언할 때 왜 타입을 꼭 써야 하는 경우가 있나요?

A. 기본적으로는 타입 추론이 가능하지만, 특정 정밀도(예: int64)가 필요하거나 제로 값으로 초기화하여 나중에 값을 넣으려는 경우에는 타입을 명시적으로 지정해 주는 것이 훨씬 안전하고 명확해요.

Q. var와 := 중 무엇이 성능상 더 유리한가요?

A. 성능 차이는 거의 없다고 보셔도 무방해요. 성능보다는 코드의 가독성과 선언 위치(함수 내부냐 외부냐)라는 문법적 규칙에 따라 선택하는 것이 올바른 접근 방식이에요.

Q. 상수를 선언할 때 타입을 생략하면 어떤 장점이 있나요?

A. 상수가 타입이 없는 상태로 있으면, 연산 시점에 맞춰 유연하게 타입을 결정할 수 있어요. 예를 들어 const Pi = 3.14라고 적으면, 이 상수는 상황에 따라 float32가 될 수도, float64가 될 수도 있어 연산이 편리해져요.

Q. Unused variable 에러가 너무 자주 나는데, 어떻게 관리하면 좋을까요?

A. 처음 배우는 단계라면 로직을 완성하기 전까지는 변수 선언을 뒤로 미루는 것도 방법이에요. 혹은 VS Code 같은 에디터에서 제공하는 자동 완성 및 정리 기능을 활용해 사용하지 않는 코드를 바로바로 지워주는 습관을 들이세요.

실수 없는 Go 코딩을 위한 마지막 체크리스트

지금까지 Go의 변수와 상수 사용법, 그리고 입문자들이 자주 빠지는 함정들을 살펴보았어요. Go의 엄격함은 여러분을 괴롭히기 위한 것이 아니라, 더 견고하고 안전한 소프트웨어를 만들기 위한 약속이라는 점을 꼭 기억해 주세요. 오늘 배운 내용을 바탕으로 다시 한번 여러분의 코드를 점검해 볼까요?

이제 이론은 충분해요. 백문이 불여일견이죠! 지금 바로 여러분의 터미널을 열고, 오늘 배운 내용들을 직접 코드로 쳐보며 에러를 마주해 보세요. 에러를 해결하는 그 과정이 여러분을 진정한 Go 개발자로 만들어줄 거예요.

🚀 다음 단계로 넘어가기
- 오늘 할 일: 방금 배운 쉐도잉 오류를 일부러 만들어보고 직접 해결해 보기
- 이번 주 할 일: 프로젝트 코드 내에서 모든 var와 :=의 사용처를 검토하고 정리하기
- 실행 직전 할 일: Go Playground에서 예제 코드를 클론해 직접 실행해 보기

더 깊이 있는 Go 프로그래밍 지식이 궁금하다면 Go 변수와 상수 완벽 가이드 글도 함께 읽어보시는 것을 추천드려요.