[IT-정보] Go 개발환경 완벽 가이드 – 30분 만에 마치는 설치법 – 입문자를 위한 환경 설정부터 코드 실행까지의 실전 과정을 담았어요.

Go 개발환경 구축이 왜 첫 번째 관문일까요?

새로운 프로그래밍 언어를 배우기로 마음먹고 가장 먼저 마주하는 벽은 의외로 문법이 아니에요. 바로 개발 환경을 구성하는 과정이죠. 야심 차게 터미널을 열고 명령어를 입력했는데, 예상치 못한 오류 메시지가 화면을 가득 채울 때의 그 당혹감을 잘 알고 있어요. “go: command not found”라는 문구를 보는 순간, 배움의 의욕이 꺾이기도 해요.

단순히 설치 파일을 실행하는 것만으로 끝난다면 좋겠지만, 실제 개발을 시작하려면 운영체제에 맞는 경로를 지정하고, 에디터와 언어를 연결하는 세밀한 작업이 필요해요. 이 과정을 대충 넘기면 나중에 라이브러리를 설치하거나 프로젝트를 빌드할 때 원인을 알 수 없는 오류 때문에 몇 시간을 허비하게 돼요. 그래서 처음부터 정석대로 환경을 구축하는 것이 무엇보다 중요해요.

이 가이드는 여러분이 시행착오 없이 Go의 세계로 뛰어들 수 있도록 돕기 위해 만들어졌어요. 복잡한 이론보다는 지금 당장 여러분의 컴퓨터에서 동작하는 실전적인 방법을 중심으로 설명할게요. 이 글을 끝까지 따라오시면, 여러분의 컴퓨터는 이미 완벽한 Go 개발 준비를 마친 상태가 될 거예요.

이 글에서 다룰 내용은 다음과 같아요.

• 운영체제별 Go 설치 파일 내려받기 및 설치법
• 환경 변수 설정을 통한 명령어 활성화 방법
• 생산성을 높여주는 VS Code와 Go 확장 프로그램 세팅
• 첫 번째 코드를 작성하고 실행하여 환경 검증하기

본격적인 설치 전 꼭 확인해야 할 준비 사항

무작정 설치 버튼을 누르기 전에, 현재 사용 중인 컴퓨터의 상태를 점검하는 과정이 필요해요. Go는 매우 가볍고 효율적인 언어지만, 설치 과정에서 운영체제의 아키텍처나 권한 설정 문제로 막히는 경우가 종종 있거든요. 준비물을 챙기듯 아래 체크리스트를 먼저 확인해 보세요.

1. 운영체제와 아키텍처 확인하기

가장 먼저 확인해야 할 것은 여러분이 사용하는 OS의 종류와 프로세서의 구조예요. 최근에는 Apple Silicon(M1, M2, M3 등)을 사용하는 Mac 사용자가 많아졌는데, 이때 반드시 ARM64 버전을 선택해야 최상의 성능을 낼 수 있어요. 반면 일반적인 Windows PC나 Intel 기반 Mac은 x86_64 버전을 선택해야 하죠. 이를 잘못 선택하면 설치는 되더라도 실행 단계에서 심각한 성능 저하나 오류가 발생할 수 있어요.

2. 개발 환경 선택 기준

Go 개발을 위해서는 단순한 텍스트 편집기 이상의 도구가 필요해요. 어떤 도구를 선택하느냐에 따라 코드 작성의 편리함이 완전히 달라지거든요. 아래 표를 통해 나에게 맞는 도구와 환경을 비교해 보세요.

3. 필수 용어 정리

설치 과정 중에 나타나는 낯선 용어들에 겁먹을 필요는 없어요. 하지만 다음 세 가지는 반드시 기억해 두는 것이 좋아요.

• GOROOT: Go 언어 자체가 설치된 경로를 의미해요.
• GOPATH: 여러분이 작성한 코드와 다운로드한 라이브러리가 저장되는 작업 공간이에요.
• Go Modules: 현대적인 Go 프로젝트에서 의존성을 관리하는 핵심 기술이에요.

단계별 Go 설치와 개발환경 설정 실전 가이드

이제 모든 준비가 끝났어요. 이제 실제로 컴퓨터에 Go를 심고, 코드를 작성할 수 있는 환경을 만들어볼게요. 운영체제마다 과정이 조금씩 다르니, 본인에게 해당하는 부분을 집중해서 따라와 주세요.

STEP 1. 공식 홈페이지에서 설치 파일 내려받기

가장 안전하고 확실한 방법은 Go 공식 웹사이트를 이용하는 것이에요. 검색 엔진에서 Go official website를 검색하거나 직접 접속하세요. 홈페이지 메인 화면의 ‘Downloads’ 메뉴를 클릭하면 다양한 운영체제용 설치 파일 목록이 나타나요.

여기서 주의할 점은 자신의 운영체제에 딱 맞는 파일을 고르는 것이에요. Windows 사용자라면 .msi 파일을, macOS 사용자라면 .pkg 파일을 선택하세요. Linux 사용자라면 tar.gz 압축 파일을 내려받으면 돼요. 이때 반드시 자신의 CPU 아키텍처(x86_64 또는 ARM64)를 다시 한번 확인하는 습관을 가져야 해요. 잘못된 아키텍처의 파일을 받으면 설치 단계에서부터 오류가 발생하거나, 설치가 되더라도 실행 시 시스템 충돌이 일어날 수 있거든요.

STEP 2. 운영체제별 설치 진행하기

파일을 내려받았다면 이제 설치를 진행할 차례예요. 각 운영체제별로 주의할 점을 정리해 드릴게요.

• Windows 사용자: 내려받은 .msi 파일을 더블 클릭하여 실행하세요. 대부분 ‘Next’ 버튼만 누르면 자동으로 설치가 진행되지만, 설치 경로(Destination Folder)는 가급적 기본값인 C:\Go로 유지하는 것이 나중에 경로 설정할 때 덜 헷갈려요. 설치가 끝나면 반드시 ‘Finish’를 누르기 전에 시스템 재시작이 필요한지 확인하세요.
• macOS 사용자: .pkg 파일을 실행하여 설치 마법사를 따라가세요. 설치 중에 시스템 보안 설정 때문에 설치가 차단될 수 있는데, 이때는 ‘시스템 설정 > 개인정보 보호 및 보안’에서 실행을 허용해 주어야 해요. M1/M2/M3 맥 사용자는 반드시 ARM64 패키지인지 확인하세요.
• Linux 사용자: 터미널을 열고 압축 파일을 적절한 위치(보통 /usr/local)에 해제해야 해요. sudo tar -C /usr/local -xzf go1.xx.x.linux-amd64.tar.gz와 같은 명령어를 사용하게 될 거예요.

STEP 3. 환경 변수(PATH) 설정으로 명령어 활성화하기

설치를 마쳤다고 해서 바로 명령어를 쓸 수 있는 건 아니에요. 컴퓨터에게 “Go라는 명령어가 어디에 있는지” 알려주는 과정, 즉 PATH 환경 변수 설정이 필요해요. 이 과정을 건너뛰면 터미널에서 `go`라고 입력했을 때 명령어를 찾을 수 없다는 오류가 떠요.

Windows의 경우: ‘시스템 환경 변수 편집’ 메뉴로 들어가서 ‘환경 변수’ 버튼을 누르세요. ‘시스템 변수’ 항목 중 ‘Path’를 찾아 편집을 누른 뒤, Go의 bin 폴더 경로(예: C:\Go\bin)를 추가해 주세요. 설정을 마친 후에는 반드시 실행 중인 모든 터미널이나 명령 프롬프트를 껐다가 다시 켜야 적용돼요.

macOS/Linux의 경우: 사용하는 쉘(zsh 또는 bash)의 설정 파일(예: .zshrc 또는 .bash_profile)에 경로를 추가해야 해요. 터미널에 `export PATH=$PATH:/usr/local/go/bin` 문구를 추가하고, `source ~/.zshrc` 명령어를 통해 즉시 적용하세요. 이 작업이 끝나면 터미널에 `go version`을 입력해 보세요. 설치된 버전 정보가 멋지게 출력된다면 성공이에요!

STEP 4. 개발 도구(VS Code)와 Go 확장 프로그램 연결하기

이제 코드를 편하게 작성할 수 있는 에디터를 세팅할 차례예요. 가장 추천하는 조합은 Visual Studio Code(VS Code)와 Go 확장 프로그램이에요. 먼저 VS Code를 설치한 뒤, 왼쪽 사이드바의 확장(Extensions) 아이콘을 클릭하세요. 검색창에 ‘Go’를 입력하고 Google에서 만든 공식 확장 프로그램을 설치해 주세요.

설치가 완료되면 VS Code 내에서 명령 팔레트(Ctrl+Shift+P 또는 Cmd+Shift+P)를 열고 `Go: Install/Update Tools`를 입력하세요. 나타나는 모든 도구 항목을 체크한 뒤 ‘OK’를 누르면, 코드 자동 완성, 정의로 이동, 실시간 오류 검사 등을 도와주는 도구들이 자동으로 설치돼요. 이 과정이 완료되어야 비로소 전문가처럼 코딩할 수 있는 환경이 갖춰지는 거예요.

STEP 5. 첫 번째 Go 프로그램 실행하며 검증하기

모든 설정이 끝났으니 실제로 코드가 돌아가는지 확인해 봐야겠죠? 이제 빈 폴더를 하나 만들고, 그 안에서 터미널을 열어 다음 과정을 수행해 보세요.

1. 프로젝트 초기화: `go mod init hello-world`를 입력하세요. 이 명령은 현재 폴더를 하나의 Go 프로젝트 단위로 만들어줘요.
2. 코드 작성: `main.go`라는 파일을 만들고 아래 코드를 복사해서 붙여넣으세요.

package main

import "fmt"

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

1. 프로그램 실행: 터미널에 `go run main.go`를 입력해 보세요. 화면에 “Hello, Go World!”라는 문구가 출력된다면, 여러분은 방금 완벽하게 Go 개발 환경 구축에 성공한 거예요!

축하드려요! 이제 여러분은 단순한 설치를 넘어, 실제 개발을 위한 모든 기초 공사를 마친 셈이에요. 이 설레는 마음을 가지고 바로 다음 단계인 문법 공부로 넘어가 보셔도 좋아요.

자주 하는 실수와 해결법

설치 과정은 누구에게나 매끄럽지만, 때로는 예상치 못한 변수가 발을 잡기도 해요. 입문자들이 가장 많이 겪는 문제들을 모아 정리했으니, 비슷한 상황이 생기면 당황하지 말고 확인해 보세요.

• ❌ “go: command not found” 오류가 발생해요
  왜 발생할까요? 설치는 되었지만 컴퓨터가 Go 실행 파일의 위치를 모르기 때문이에요.
  ✅ 해결법: 시스템 환경 변수의 PATH 설정에 Go의 bin 폴더 경로가 제대로 포함되어 있는지 다시 확인하고, 반드시 터미널을 완전히 종료한 뒤 새로 열어보세요.
• ❌ 설치 도중 ‘권한 거부(Permission Denied)’가 떠요
  왜 발생할까요? 시스템 폴더에 파일을 쓰려고 할 때 운영체제가 보안을 위해 막는 경우예요.
  ✅ 해결법: macOS나 Linux라면 명령어 앞에 sudo를 붙여 관리자 권한으로 실행하세요. Windows라면 명령 프롬프트를 ‘관리자 권한으로 실행’하여 진행하세요.
• ❌ VS Code에서 자동 완성이 작동하지 않아요
  왜 발생할까요? Go 언어 서버(gopls)가 제대로 설치되지 않았거나 에디터와 연결되지 않았기 때문이에요.
  ✅ 해결법: VS Code 명령 팔레트(Cmd/Ctrl+Shift+P)에서 `Go: Install/Update Tools`를 다시 실행하여 모든 도구를 최신 상태로 업데이트하세요.
• ❌ M1/M2 맥에서 실행 속도가 너무 느려요
  왜 발생할까요? Intel용(x86_64) Go를 설치했기 때문일 가능성이 높아요.
  ✅ 해결법
  기존 Go를 삭제하고, 반드시 ARM64 버전의 설치 파일을 다시 내려받아 설치하세요.
• ❌ 라이브러리를 불러올 때 ‘module not found’가 떠요
  왜 발생할까요? Go Modules 설정이 되어 있지 않거나 초기화되지 않은 상태에서 패키지를 사용하려 했기 때문이에요.
  ✅ 해결법: 프로젝트 폴더에서 `go mod init [프로젝트이름]` 명령어를 실행하여 `go.mod` 파일을 먼저 생성하세요.

자주 묻는 질문

Q. Go를 공부하기 위해 꼭 유료 에디터인 GoLand를 써야 하나요?

아니요, 전혀 그렇지 않아요. VS Code는 무료이면서도 Go 개발에 필요한 거의 모든 기능을 훌륭하게 제공해요. 처음에는 VS Code로 가볍게 시작하시고, 나중에 프로젝트 규모가 커지고 더 강력한 기능이 필요해질 때 GoLand를 고려해 보셔도 충분해요.

Q. GOPATH를 꼭 직접 설정해야 하나요?

최신 Go 개발 방식에서는 Go Modules를 사용하기 때문에, 과거처럼 GOPATH를 복잡하게 관리할 필요가 거의 없어요. 프로젝트마다 독립적인 환경을 유지할 수 있어 훨씬 편리하답니다.

Q. Go 버전은 무조건 최신 버전을 설치해야 하나요?

대체로 그렇습니다. 보안 업데이트와 새로운 기능, 그리고 무엇보다 성능 개선이 최신 버전에 집중되어 있기 때문이에요. 특별한 이유가 없다면 항상 최신 안정 버전을 사용하시는 것을 권장해요.

Q. 윈도우와 맥 중 어떤 환경이 Go 개발에 더 유리한가요?
두 환경 모두 아주 훌륭해요. 다만, 서버 환경은 대부분 리눅스 기반이므로, macOS의 유닉스 계열 터미널 환경이 서버 운영 환경과 더 유사한 느낌을 줄 수는 있어요. 하지만 윈도우에서도 WSL2를 사용하면 리눅스 환경과 거의 동일하게 개발할 수 있으니 걱정하지 마세요.

성공적인 Go 개발을 위한 마지막 체크리스트

긴 여정을 마쳤습니다! 이제 여러분의 컴퓨터는 강력한 Go 개발 도구로 무장되었어요. 다시 한번 제대로 설정되었는지 확인하며 마무리해 볼까요?

환경 설정은 개발의 시작일 뿐, 끝이 아니에요. 이제 막 엔진을 켰으니 본격적으로 달릴 준비를 해야겠죠? 다음 단계로 나아가기 위해 여러분이 오늘, 이번 주에 해야 할 일들을 제안해 드릴게요.

🚀 다음 단계로 나아가기

• 오늘 할 일: 위 가이드의 STEP 5를 따라 Hello World 코드를 직접 실행하고 성공 메시지를 확인하세요.
• 이번 주 할 일: Go의 기본 문법(변수, 함수, 제어문)을 하나씩 따라 하며 작은 예제들을 만들어 보세요.
• 실행 직전 할 일: VS Code의 단축키와 Go 확장 프로그램이 제공하는 자동 완성 기능을 익혀보세요. 생산성이 놀라울 정도로 올라갈 거예요.

Go는 배우기 쉽고 강력한 언어예요. 환경 설정 과정에서 겪은 작은 어려움들은 여러분이 훌륭한 개발자로 성장하는 데 밑거름이 될 거예요. 다음 편에서는 Go의 핵심 문법을 아주 쉽게 풀어내는 실전 코딩 가이드를 다룰 예정이니, 구독을 통해 놓치지 마세요!

관련하여 더 궁금한 점이 있다면, 이전에 작성된 컴퓨터 운영체제 기초 가이드 글을 참고해 보시는 것도 큰 도움이 될 거예요.