[IT-방법] Go 개발환경 튜토리얼: 설치부터 예제까지 – 입문자를 위한 실전 환경 구축 가이드

Go 개발을 시작하기 전 겪게 되는 막막함

야심 차게 Go 프로그래밍을 공부하기로 마음먹고 터미널을 켰는데, “command not found: go”라는 차가운 메시지만 마주한 적이 있나요? 분명 인터넷에서 본 대로 설치한 것 같은데, 왜 내 컴퓨터에서는 아무런 반응이 없는지 답답한 마음이 들기 마련이에요. 환경 변수 설정부터 모듈 관리까지, 첫 단추를 잘못 끼우면 개발을 시작하기도 전에 지쳐버리기 쉽답니다.

최근 클라우드 네이티브 환경과 마이크로서비스 아키텍처가 부상하면서 Go 언어의 인기는 날로 높아지고 있어요. 하지만 입문자들에게는 설치 과정 자체가 커다란 장벽처럼 느껴질 수 있죠. 단순히 설치 파일을 내려받는 것에서 끝나는 게 아니라, 실제 코드가 돌아갈 수 있는 최적의 작업 환경을 만드는 것이 훨씬 중요해요.

이 글은 바로 그런 분들을 위해 준비했어요. 복잡한 이론보다는 지금 당장 내 컴퓨터에서 코드가 실행되는 경험을 하는 데 초점을 맞췄답니다. 튜토리얼을 따라오다 보면 어느새 첫 번째 Go 프로그램을 성공적으로 실행하는 자신을 발견할 수 있을 거예요.

이번 가이드에서는 다음과 같은 핵심 내용들을 아주 구체적으로 다룰 예정이에요.

• 운영체제별 맞춤형 Go 설치 방법
• 코드 작성을 편리하게 돕는 도구(IDE) 선택 기준
• 환경 변수와 모듈 설정을 통한 오류 방지
• 실전 예제로 확인하는 개발 환경 검증

자, 이제 준비가 되었다면 본격적으로 Go의 세계로 떠나볼까요?

설치 전 반드시 확인해야 할 준비물과 기준

무작정 설치 버튼을 누르기 전에, 현재 사용 중인 컴퓨터의 상태를 먼저 점검해야 해요. 운영체제마다 설치 방식이 다르고, 어떤 도구를 선택하느냐에 따라 앞으로의 학습 효율이 완전히 달라지기 때문이죠. 환경 설정은 한 번 해두면 개발 내내 큰 힘이 되지만, 처음부터 제대로 하지 않으면 나중에 수많은 오류를 마주하게 돼요.

운영체제와 하드웨어 체크

대부분의 현대적인 컴퓨터라면 Go를 실행하는 데 큰 문제는 없어요. 다만, 본인이 사용하는 OS가 Windows인지, macOS인지, 혹은 Linux인지에 따라 설치 경로와 명령어 체계가 완전히 달라진다는 점을 기억해야 해요. 특히 M1, M2 칩을 사용하는 Apple Silicon 맥 사용자는 설치 파일 선택 시 아키텍처를 꼭 확인해야 한답니다.

도구 선택의 고민: 어떤 에디터를 쓸까?

코드를 작성할 때 메모장을 쓸 수는 없으니, 전문적인 도구가 필요해요. 입문자라면 기능이 너무 많은 도구보다는 설정이 간편한 것을 추천해요. 아래 표를 통해 나에게 맞는 도구가 무엇인지 비교해 보세요.

마지막으로, 인터넷 연결 상태를 확인해 주세요. 설치 과정에서 패키지 매니저를 사용하거나 외부 라이브러리를 다운로드해야 하는 경우가 많기 때문이에요. 모든 준비가 끝났다면 이제 본격적인 설치 단계로 넘어가 볼게요.

Go 개발환경 완벽 구축 5단계

이제 실제로 Go를 컴퓨터에 심어줄 시간이에요. 이 과정은 단순히 파일을 복사하는 것이 아니라, 컴퓨터에게 “이제부터 Go 언어를 사용할 거야”라고 알려주는 과정이라고 이해하면 쉬워요.

STEP 1. 운영체제별 맞춤 설치 실행하기

가장 먼저 Go 공식 웹사이트에 접속해서 설치 파일을 내려받아야 해요. 하지만 OS마다 방법이 다르니 주의 깊게 살펴봐 주세요.

• Windows 사용자: .msi 설치 파일을 내려받아 실행하세요. 대부분 ‘Next’ 버튼만 누르면 되지만, 설치 경로(보통 C:\Go)를 꼭 기억해 두어야 해요.
• macOS 사용자: .pkg 파일을 사용하거나, 터미널을 다룰 줄 안다면 Homebrew를 사용하는 것이 훨씬 깔끔해요. 터미널에 brew install go라고 입력하면 끝이죠.
• Linux 사용자: 압축 파일을 직접 내려받아 /usr/local에 해제하는 방식이 일반적이에요. 권한 설정이 필요할 수 있으니 주의하세요.

STEP 2. 환경 변수(PATH) 설정으로 길 터주기

설치를 마쳤어도 터미널에서 Go를 인식하지 못한다면, 컴퓨터의 ‘길’을 알려주지 않았기 때문이에요. 이걸 PATH 설정이라고 불러요. Windows는 시스템 환경 변수 편집 메뉴에서, macOS나 Linux는 .zshrc나 .bash_profile 파일에 경로를 추가해야 해요. 이 단계를 건너뛰면 나중에 패키지를 설치할 때마다 엄청난 오류를 마주하게 될 거예요.

STEP 3. Go Modules를 이용한 프로젝트 관리

과거에는 GOPATH라는 특정 폴더 안에서만 코드를 짜야 했지만, 지금은 Go Modules라는 현대적인 방식이 표준이에요. 이제는 여러분이 원하는 아무 폴더에서나 프로젝트를 시작할 수 있어요. 프로젝트 폴더를 만든 뒤 터미널에서 go mod init 프로젝트이름 명령어를 입력하는 것만으로 준비가 끝난답니다.

STEP 4. 첫 번째 코드 작성과 실행 테스트

자, 이제 모든 준비가 끝났으니 실제로 코드가 돌아가는지 확인해 볼까요? 프로젝트 폴더 안에 main.go라는 파일을 만들고 아래 코드를 그대로 적어보세요.

package main

import "fmt"

func main() {
    fmt.Println("Hello, Go World!")
}

코드를 저장했다면 터미널에서 go run main.go라고 입력해 보세요. 화면에 “Hello, Go World!”라는 문구가 뜬다면 여러분은 성공적으로 개발 환경을 구축한 거예요!

STEP 5. 필수 도구와 라이브러리 활용하기

이제 기초 체력은 길러졌으니, 실제 개발에 필요한 도구들을 갖춰야 해요. VS Code를 사용한다면 ‘Go’ 확장 프로그램을 반드시 설치하세요. 자동 완성, 코드 포맷팅, 디버깅 기능을 제공하여 개발 속도를 몇 배는 높여준답니다. 또한, 자주 쓰이는 외부 라이브러리를 관리하는 go get 명령어 사용법도 익혀두면 좋아요.

[실전 학습 일정표: 하루 만에 끝내는 환경 구축]

• 오전 10:00 – 11:00: OS에 맞는 Go 설치 및 버전 확인
• 오전 11:00 – 12:00: VS Code 설치 및 Go 확장 프로그램 설정
• 오후 01:00 – 03:00: Go Modules를 활용한 첫 프로젝트 생성 및 Hello World 실행
• 오후 03:00 – 05:00: 외부 패키지(fmt 등)를 활용한 간단한 계산기 만들기 실습

이 일정대로만 따라오신다면, 오늘 안에 여러분은 당당한 Go 개발자로 첫발을 내딛게 될 거예요.

자주 하는 실수와 해결법

환경 설정 과정은 생각보다 까다로울 수 있어요. 많은 입문자가 공통적으로 겪는 문제들을 정리했으니, 혹시 문제가 생기면 이 부분을 먼저 확인해 보세요.

• ❌ “go: command not found” 오류가 발생해요
  왜 발생하는가: 설치는 되었지만 시스템이 Go가 어디 있는지 모르는 상태예요.
  ✅ 해결법: 환경 변수(PATH)에 Go의 bin 폴더 경로가 제대로 등록되었는지 확인하세요.
• ❌ 패키지를 설치했는데 불러올 수 없다고 나와요
  왜 발생하는가: Go Modules 설정이 제대로 되지 않았거나, go.mod 파일이 없기 때문이에요.
  ✅ 해결법: 프로젝트 루트 폴더에서 go mod init을 실행했는지 확인하세요.
• ❌ 코드를 실행할 때마다 컴파일 속도가 너무 느려요
  왜 발생하는가: 백신 프로그램이 Go의 임시 빌드 폴더를 실시간 감시하고 있을 가능성이 커요.
  ✅ 해결법: 백신 설정에서 Go 작업 디렉토리를 검사 제외 대상으로 등록해 보세요.
• ❌ 버전이 꼬여서 명령어가 안 먹혀요
  왜 발생하는가: 여러 버전의 Go가 중복 설치되어 경로가 충돌하는 경우예요.
  ✅ 해결법: 기존 Go를 완전히 삭제하고, 공식 사이트에서 최신 버전 하나만 깔끔하게 재설치하세요.
• ❌ 맥에서 ARM 아키텍처 관련 오류가 떠요
  왜 발생하는가: Intel용 Go를 설치했기 때문이에요.
  ✅ 해결법: 반드시 Apple Silicon(ARM64)용 설치 파일을 다시 받으세요.

자주 묻는 질문

Q. Go 언어는 배우기 어렵나요?

문법 자체가 아주 간결하고 직관적이라서 다른 언어에 비해 진입 장벽이 낮은 편이에요. 하지만 동시성(Concurrency) 개념을 이해하는 데는 약간의 시간이 필요할 수 있답니다.

Q. Windows와 Mac 중 어떤 환경이 더 좋나요?

사실 어떤 것을 써도 무방해요. 다만, 서버 환경(Linux)과의 유사성이나 개발 도구 지원 면에서는 Mac이 조금 더 편리하다는 평이 많지만, 최근에는 Windows의 WSL2 성능이 좋아져서 큰 차이는 없어요.

Q. Go Modules를 꼭 써야 하나요?

네, 현대적인 Go 개발에서는 선택이 아닌 필수예요. 프로젝트 간의 의존성을 관리하는 가장 안전하고 표준적인 방법이니까요.

Q. IDE 없이 메모장으로도 코딩할 수 있나요?

가능은 하지만, 추천하지 않아요. 자동 완성이나 오류 체크 기능이 없으면 사소한 오타 하나 때문에 몇 시간씩 고생할 수 있거든요.

Q. Go 버전은 항상 최신을 써야 하나요?

일반적으로는 최신 안정 버전(Stable version)을 사용하는 것이 가장 좋아요. 새로운 기능과 보안 패치가 포함되어 있기 때문이죠.

Go 개발자로 나아가기 위한 마무리

지금까지 Go 설치부터 환경 설정, 그리고 첫 실행까지의 전 과정을 함께 살펴보았어요. 처음에는 낯설고 복잡해 보였을 수도 있지만, 차근차근 단계를 밟아온 여러분은 이미 준비가 끝났답니다.

이제 여러분이 해야 할 일은 아주 명확해요. 이론 공부에만 매몰되지 말고, 직접 코드를 치며 에러를 마주하고 해결하는 과정을 즐겨보세요. 그 과정이 쌓여 진짜 실력이 된답니다.

다음 단계로 나아가기

• 오늘 할 일: 설치 완료 후 터미널에서 go version 명령어로 버전 확인하기
• 이번 주 할 일: Go의 기초 문법(변수, 함수, 조건문)을 익히고 간단한 계산기 만들기
• 실행 직전 할 일: 개발 도구(IDE)의 단축키를 익혀 생산성 높이기

실무에서 쓰이는 더 깊이 있는 Go 활용법이 궁금하다면, 실무 체크리스트를 저장해 배포 전에 활용해 보세요. 여러분의 성공적인 개발 여정을 응원할게요!

함께 읽으면 좋은 글: /programming/golang/go-install-setup-complete-guide/ 글과 함께 읽어보시면 더욱 도움이 됩니다.