[IT-방법] Go 개발환경 시작하기: 설치부터 첫 코드 실행까지 – 입문자가 꼭 알아야 할 환경 설정 가이드

Go 개발환경 시작하기: 왜 지금 Go를 배워야 할까요?

새로운 프로그래밍 언어를 배우기로 마음먹고 가장 먼저 마주하는 벽은 코딩 자체가 아니라 바로 개발 환경을 만드는 일이에요. 코드를 한 줄 적어보고 싶은데, 정작 컴퓨터에 무엇을 설치해야 하는지, 터미널에 뭐라고 입력해야 하는지 몰라 막막했던 경험이 한 번쯤은 있으실 거예요. 특히 Go(Golang)처럼 강력한 언어를 배우려고 할 때, 환경 설정에서부터 오류를 만나면 의욕이 꺾이기 마련이지요.

Go는 구글에서 만든 언어로, 배우기 쉽고 속도가 매우 빨라요. 요즘 클라우드 기술이나 서버 인프라를 다루는 곳에서는 Go 개발환경 시작하기가 선택이 아닌 필수인 시대가 되었어요. 하지만 단순히 설치 파일을 실행한다고 해서 모든 준비가 끝나는 것은 아니에요. 운영체제에 맞는 설정이 필요하고, 코드를 작성할 도구도 준비해야 하거든요.

이 글을 끝까지 읽고 나면 여러분은 자신의 컴퓨터에 완벽한 Go 개발 환경을 갖추게 될 거예요. 더 이상 설치 오류 때문에 인터넷을 헤매지 않아도 돼요. 설치 파일 다운로드부터 VS Code를 활용한 전문적인 개발 환경 구축, 그리고 드디어 첫 번째 코드를 화면에 띄우는 순간까지 모든 과정을 옆에서 알려드리는 것처럼 차근차근 설명해 드릴게요.

이번 가이드에서 우리는 다음 내용들을 차례대로 다뤄볼 거예요.

• Go 설치 파일 선택과 운영체제별 설치 방법
• 환경 변수(PATH)가 무엇인지, 왜 확인해야 하는지
• 개발 효율을 높여주는 VS Code와 Go 확장 도구 설정
• 실제 코드를 작성하고 실행하는 단계별 프로세스

사전 준비: 내 컴퓨터의 상태와 필수 체크리스트

본격적으로 설치를 시작하기 전에, 내 컴퓨터가 Go를 받아들일 준비가 되었는지 확인해야 해요. 무작정 설치 버튼을 누르기보다, 현재 내가 사용하는 운영체제가 무엇인지, 어떤 방식의 설치가 나에게 유리한지 미리 파악하는 것이 시간을 아끼는 지름길이에요.

Go는 요구 사항이 매우 낮은 편이라 아주 오래된 컴퓨터가 아니라면 대부분 문제없이 작동해요. 하지만 컴퓨터의 아키텍처, 즉 CPU의 종류에 따라 설치 파일이 달라진다는 점은 꼭 기억해야 해요. 최근에 나온 맥북처럼 M1, M2 칩을 사용하는 경우에는 ARM 기반 파일을 받아야 하고, 일반적인 윈도우 PC라면 x64 기반 파일을 선택해야 하거든요.

또한, 단순히 언어만 설치한다고 개발이 되는 것은 아니에요. 코드를 편하게 작성할 수 있는 텍스트 에디터와, 설치된 Go가 컴퓨터 어디에서든 호출될 수 있도록 길을 터주는 환경 변수 개념을 이해하고 있어야 해요.

운영체제별 설치 환경 비교

위 표를 보면 알 수 있듯이, 윈도우 사용자는 비교적 설치가 간편하지만, 맥이나 리눅스 사용자는 터미널을 통한 설정이 추가로 필요할 수 있어요. 특히 경로(PATH) 설정은 설치 후 가장 많은 오류가 발생하는 지점이니 주의를 기울여야 해요.

마지막으로 개발 도구인 VS Code(Visual Studio Code)를 미리 설치해 두는 것을 추천해요. Go 언어는 문법이 엄격하기 때문에, 코드를 작성하는 즉시 문법 오류를 잡아주는 똑똑한 에디터가 반드시 필요하기 때문이에요.

핵심 본문: 단계별 Go 개발환경 구축 실전

이제 준비는 끝났어요. 본격적으로 컴퓨터에 Go를 심고, 코드를 작성할 수 있는 완벽한 환경을 만들어 볼까요? 이 과정은 크게 다섯 단계로 나누어 진행할게요. 각 단계를 천천히 따라오시면 됩니다.

STEP 1. 공식 설치 파일 다운로드와 실행

가장 먼저 해야 할 일은 Go의 공식 홈페이지인 go.dev에 접속하는 것이에요. 구글이 관리하는 공식 사이트이기 때문에 여기서 받는 파일이 가장 안전하고 최신 버전을 보장해요.

홈페이지 메인 화면에서 Downloads 메뉴를 클릭하세요. 그러면 운영체제별로 다양한 파일 목록이 보일 거예요. 윈도우 사용자라면 ‘Windows’ 항목 옆의 64-bit 설치 파일을 선택하고, 맥 사용자라면 자신의 칩셋(Intel 또는 Apple Silicon)에 맞는 파일을 고르면 돼요. 파일을 다 받았다면 평소 다른 프로그램을 설치할 때처럼 더블 클릭하여 설치 과정을 진행하세요. 설치 경로는 기본값인 C:\Go 또는 /usr/local/go로 두는 것이 가장 안정적이에요.

STEP 2. 터미널에서 설치 확인하기

설치가 완료되었다면, 이제 컴퓨터가 Go를 제대로 인식하는지 확인해야 해요. 단순히 설치 파일이 끝났다고 해서 끝난 게 아니거든요. 컴퓨터의 명령줄 도구인 터미널(Windows는 명령 프롬프트 또는 PowerShell)을 열어주세요.

터미널 창에 go version이라고 입력하고 엔터를 눌러보세요. 만약 go version go1.xx.x 처럼 버전 정보가 출력된다면 성공이에요! 만약 ‘명령어를 찾을 수 없습니다’라는 메시지가 뜬다면, 설치 과정에서 환경 변수가 제대로 등록되지 않은 것이니 컴퓨터를 재부팅하거나 환경 변수 설정을 수동으로 점검해야 해요.

STEP 3. VS Code와 Go 확장 도구 연동하기

이제 코드를 작성할 쾌적한 작업실을 만들 차례예요. 가장 권장하는 도구는 VS Code예요. VS Code를 실행한 뒤, 왼쪽 사이드바에 있는 확장 프로그램(Extensions) 아이콘을 클릭하세요. 검색창에 ‘Go’를 입력하면 Google에서 제공하는 공식 Go 확장 도구가 나올 거예요. 이를 설치해 주세요.

확장 프로그램을 설치한 후에는 VS Code가 Go 관련 도구들을 더 다운로드하도록 안내할 거예요. 화면 오른쪽 하단에 뜨는 메시지에서 Install All 버튼을 꼭 눌러주세요. 이 과정이 완료되어야 자동 완성, 코드 문법 검사(Linting), 디버깅 같은 강력한 기능들을 사용할 수 있어요. 이 단계가 생략되면 마치 눈을 가리고 타자를 치는 것과 다름없으니 꼭 잊지 마세요.

STEP 4. Go 모듈(Go Modules) 프로젝트 시작하기

과거에는 특정 폴더 구조를 엄격하게 따라야 했지만, 요즘은 Go Modules라는 기능 덕분에 어디서든 자유롭게 프로젝트를 시작할 수 있어요. 개발을 시작할 폴더를 하나 만들고, 그 폴더 안에서 터미널을 여세요. 그다음 아래 명령어를 입력하세요.

go mod init my-first-go라고 입력하면, 해당 폴더에 go.mod라는 파일이 생성돼요. 이 파일은 프로젝트의 이름과 관리할 라이브러리들을 기록하는 아주 중요한 문서예요. 이제 여러분은 공식적인 Go 프로젝트의 틀을 갖추게 된 거예요.

STEP 5. 첫 번째 코드 작성 및 실행하기

드디어 대망의 마지막 단계예요. 이제 코드를 직접 작성해 볼까요? VS Code에서 새 파일을 만들고 이름을 main.go로 저장하세요. 그리고 아래의 내용을 그대로 입력해 보세요.

package main

import "fmt"

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

코드를 한 줄씩 뜯어볼까요? package main은 이 파일이 실행 가능한 프로그램임을 알려줘요. import "fmt"는 화면에 글자를 출력하는 기능을 가진 도구를 가져오겠다는 뜻이에요. 마지막으로 func main()은 프로그램이 시작될 때 가장 먼저 실행되는 지점을 의미해요.

이제 터미널에서 go run main.go를 입력해 보세요. 화면에 Hello, Go World!라는 문구가 나타난다면, 여러분은 드디어 Go 개발자가 된 거예요! 정말 축하드려요!

자주 하는 실수와 해결법

환경 설정을 하다 보면 분명히 매뉴얼대로 했는데 안 되는 경우가 생기기 마련이에요. 당황하지 마세요. 대부분의 문제는 정해진 몇 가지 원인 때문에 발생하거든요.

• ❌ ‘go’ 명령어를 찾을 수 없다는 오류가 떠요
  왜 발생하는가: 설치는 되었지만 컴퓨터가 Go가 어디 있는지 몰라요. 즉, PATH 환경 변수가 등록되지 않은 상태예요.
  ✅ 해결법: 시스템 환경 변수 편집에서 Go의 bin 폴더 경로를 추가하거나, 윈도우의 경우 설치 프로그램을 다시 실행해 보세요.
• ❌ VS Code에서 빨간 줄이 계속 나타나요
  왜 발생하는가: Go 확장 프로그램은 설치했지만, 실제 Go 도구들(gopls 등)이 아직 다운로드되지 않았을 때 발생해요.
  ✅ 해결법: VS Code에서 Ctrl+Shift+P를 누르고 ‘Go: Install/Update Tools’를 검색해 모든 항목을 선택하고 설치를 완료하세요.
• ❌ ‘go.mod’ 파일이 없다는 오류가 생겨요
  왜 발생하는가: 프로젝트 폴더를 만들었지만, Go 모듈을 초기화하지 않았기 때문이에요.
  ✅ 해결법: 터미널에서 go mod init [프로젝트이름] 명령어를 입력해 파일을 생성하세요.
• ❌ 파일을 저장했는데 실행이 안 돼요
  왜 발생하는가: 파일 확장자가 .go가 아니거나, 저장 위치를 잘못 잡았을 확률이 높아요.
  ✅ 해결법: 파일명이 정확히 main.go와 같이 끝나는지 확인하고, 터미널의 현재 위치가 해당 파일이 있는 폴더인지 확인하세요.
• ❌ 맥(macOS)에서 설치 후 실행이 안 돼요
  왜 발생하는가: 새로운 터미널 환경(zsh)에 경로가 반영되지 않았을 수 있어요.
  ✅ 해결법: source ~/.zshrc 명령어를 입력해 설정을 새로고침해 보세요.

자주 묻는 질문

Q. Go를 배우려면 컴퓨터 사양이 좋아야 하나요?

아니요, 전혀 그렇지 않아요. Go는 매우 가볍고 효율적인 언어라서, 5~6년 된 노트북에서도 아주 쾌적하게 돌아가요. 메모리가 8GB 이상이라면 더욱 완벽해요.

Q. 파이썬이나 자바를 배우다가 Go로 넘어와도 괜찮을까요?

당연하죠! 오히려 다른 언어를 경험해 본 분들이 Go의 간결함과 강력한 성능에 더 큰 매력을 느끼는 경우가 많아요. 문법이 단순해서 적응 기간도 짧은 편이에요.

Q. VS Code 말고 다른 에디터는 안 되나요?
(예: IntelliJ, Vim 등)

물론 가능해요. 하지만 입문자에게는 가장 많은 커뮤니티 지원과 편리한 플러그인을 제공하는 VS Code를 가장 추천해 드려요.

Q. 설치할 때 x64와 ARM64 중 무엇을 골라야 할지 모르겠어요.

윈도우 사용자라면 대부분 x64를 선택하면 돼요. 맥 사용자라면 설정의 ‘이 Mac에 관하여’를 눌러 프로세서가 Intel인지 Apple M1/M2인지 확인하고 그에 맞춰 선택하세요.

핵심 요약과 다음 단계

지금까지 Go 개발환경 시작하기의 모든 과정을 살펴보았어요. 처음에는 낯선 용어와 터미널 명령어가 어렵게 느껴질 수 있지만, 한 번 제대로 구축해 두면 앞으로의 개발 여정이 훨씬 즐거워질 거예요.

이제 여러분은 출발선에 섰어요. 오늘 바로 할 일과 이번 주의 목표를 세워보는 건 어떨까요?

• 오늘 할 일: Go 설치를 마치고 터미널에 버전 정보 띄우기
• 이번 주 할 일: 간단한 계산기 프로그램이나 문자열 출력 프로그램 만들어 보기
• 실행 직전 할 일: VS Code의 자동 완성 기능이 제대로 작동하는지 확인하기

막히는 부분이 있거나 궁금한 점이 생기면 언제든 댓글로 남겨 주세요. 여러분의 첫걸음을 진심으로 응원하며, 함께 성장해 나가길 바랄게요!

더 깊이 있는 Go 프로그래밍 지식이 궁금하다면, Go 설치와 환경 설정 완전 정복 가이드 글도 함께 읽어 보시는 것을 추천드려요.