Go 개발환경 직접 구현을 시작하며
터미널에 go version을 입력했는데 ‘command not found’라는 차가운 메시지만 돌아올 때의 당혹감을 잘 알고 있어요. 분명히 설치 버튼을 눌렀는데 왜 내 컴퓨터는 Go가 어디 있는지 모르는 걸까요? 이런 문제는 입문 개발자들이 가장 먼저 마주하는 높은 벽 중 하나예요.
단순히 설치 프로그램을 실행하는 것만으로 모든 것이 끝나지는 않아요. 운영체제의 경로(PATH)를 이해하고, 에디터가 Go 언어를 제대로 인식하도록 연결해 주는 과정이 필요해요. 이 과정을 대충 넘기면 나중에 패키지를 설치하거나 디버깅을 할 때 원인을 알 수 없는 오류 때문에 밤을 지새우게 될지도 몰라요.
오늘 우리는 단순히 ‘설치’만 하는 게 아니에요. Go 개발환경 직접 구현이라는 목표 아래, 밑바닥부터 탄탄하게 환경을 구축하는 법을 배울 거예요. 시스템의 원리를 이해하며 설정하면, 나중에 어떤 환경에서도 당황하지 않는 진정한 개발자로 성장할 수 있어요.
이 글을 끝까지 읽고 나면 다음과 같은 것들을 완벽하게 할 수 있어요.
- 내 운영체제에 딱 맞는 Go 바이너리 설치하기
- 터미널 어디서든 Go 명령어를 사용할 수 있도록 환경 변수 설정하기
- VS Code를 Go 전용 개발 도구로 변신시키기
- 모듈 시스템을 활용한 첫 프로젝트 구조 잡기
준비해야 할 환경과 핵심 용어
본격적인 실습에 들어가기 전에, 현재 여러분의 컴퓨터 상태를 점검해야 해요. 무작정 설치부터 시작하기보다는 내가 어떤 환경에서 싸워야 하는지 파악하는 것이 먼저예요.
가장 먼저 결정해야 할 것은 운영체제(OS)예요. Windows, macOS, Linux 중 무엇을 사용하느냐에 따라 환경 변수를 설정하는 방법과 사용하는 터미널이 완전히 달라지거든요. 또한, 코드를 작성할 에디터도 미리 정해두는 것이 좋아요. 가장 추천하는 조합은 VS Code(Visual Studio Code)예요. 가볍고 Go 관련 확장 프로그램이 매우 강력하기 때문이죠.
설치 전 반드시 이해하고 넘어가야 할 용어들이 있어요. 이 용어들을 모르면 나중에 가이드의 설명을 들어도 외계어처럼 느껴질 수 있어요.
GOPATH: Go 프로젝트와 다운로드한 패키지들이 저장되는 작업 공간이에요.
GOBIN: Go로 빌드한 실행 파일들이 저장되는 특정 폴더예요.
PATH: 운영체제가 명령어를 찾을 때 뒤져보는 폴더들의 목록이에요. 여기에 Go 폴더를 등록해야 명령어를 바로 쓸 수 있어요.
아래 표를 보고 현재 여러분의 환경을 체크해 보세요.
| 구분 | Windows 사용자 | macOS/Linux 사용자 |
|---|---|---|
| 기본 터미널 | PowerShell 또는 CMD | zsh 또는 bash |
| 환경 변수 설정 | ‘시스템 환경 변수 편집’ 메뉴 이용 | ~/.zshrc 또는 ~/.bash_profile 파일 수정 |
| 패키지 관리 | Go Modules 사용 권장 | Go Modules 사용 권장 |
준비가 되셨나요? 이제 본격적으로 Go 설치와 개발환경 설정의 핵심 과정으로 들어가 볼게요.
단계별로 따라 하는 Go 개발환경 구축
이제 이론은 접어두고 직접 손을 움직여 볼 시간이에요. 이 과정은 크게 5단계로 나누어 진행할 거예요. 각 단계를 하나씩 차근차근 따라와 주세요.
STEP 1. 공식 바이너리 설치하기
가장 먼저 Go 언어 자체를 컴퓨터에 심어줘야 해요. 가장 안전하고 확실한 방법은 Go 공식 웹사이트를 이용하는 것이에요. 구글링을 통해 golang.org에 접속하세요.
사이트에 접속하면 메인 화면에 바로 다운로드 버튼이 보일 거예요. 여기서 주의할 점이 있어요. 자신의 컴퓨터 아키텍처를 정확히 알아야 한다는 점이에요. 만약 Apple Silicon(M1, M2, M3 칩)을 사용하는 Mac이라면 ARM64 버전을 선택해야 하고, 일반적인 Windows나 Intel Mac을 사용한다면 x86-64 버전을 선택해야 해요. 잘못된 버전을 설치하면 실행 속도가 현저히 느려지거나 아예 실행되지 않을 수 있어요.
다운로드가 완료되었다면 설치 파일을 실행하세요. 대부분의 경우 ‘Next’ 버튼만 누르면 기본 경로에 설치가 완료돼요. 하지만 우리는 ‘직접 구현’하는 관점에서 설치 경로를 눈여겨봐야 해요. 보통 Windows는 C:\Go에, macOS/Linux는 /usr/local/go에 설치되곤 해요.
STEP 2. 환경 변수(PATH) 수동 설정하기
설치가 끝났다고 해서 바로 명령어를 쓸 수 있는 건 아니에요. 컴퓨터에게 “Go라는 명령어가 들어있는 폴더는 여기야!”라고 알려주는 과정이 필요한데, 이게 바로 환경 변수 설정이에요.
Windows 사용자라면:
1. 시작 메뉴에서 ‘시스템 환경 변수 편집’을 검색해 실행하세요.
2. [환경 변수] 버튼을 누르고 ‘시스템 변수’ 목록에서 ‘Path’를 찾아 선택한 뒤 [편집]을 누르세요.
3. [새로 만들기]를 누르고 Go가 설치된 경로(예: C:\Go\bin)를 추가하세요.
4. 모든 창에서 [확인]을 눌러 저장하세요.
macOS/Linux 사용자라면:
1. 터미널을 열고 사용 중인 쉘 설정 파일을 확인하세요(보통 nano ~/.zshrc).
2. 파일 맨 아래에 export PATH=$PATH:/usr/local/go/bin 문구를 추가하세요.
3. Ctrl+O로 저장하고 Ctrl+X로 빠져나오세요.
4. source ~/.zshrc 명령어를 입력해 설정을 즉시 반영하세요.
환경 변수를 수정한 후에는 반드시 사용 중이던 터미널이나 명령 프롬프트를 완전히 종료했다가 다시 열어야 해요. 그래야 변경된 설정이 새 프로세스에 적용됩니다.
STEP 3. 에디터 및 확장 프로그램 세팅
이제 코드를 쓸 도구를 준비할 차례예요. 우리는 VS Code를 사용할 거예요. VS Code를 설치했다면, 왼쪽 사이드바의 확장 프로그램(Extensions) 아이콘을 클릭하세요.
검색창에 Go를 입력하고, Google에서 만든 공식 Go 확장 프로그램을 설치하세요. 설치가 완료되면 오른쪽 하단에 ‘Analysis Tools Missing’이라는 메시지가 뜰 수 있어요. 당황하지 마세요! 이건 Go 개발에 필요한 보조 도구(Linter, Debugger 등)가 아직 없다는 뜻이에요. Command Palette(Ctrl+Shift+P 또는 Cmd+Shift+P)를 열고 Go: Install/Update Tools를 입력하세요. 나타나는 모든 체크박스를 선택하고 [OK]를 누르면 필요한 도구들이 자동으로 설치됩니다.
STEP 4. 모듈 시스템(Go Modules) 이해와 실습
과거에는 프로젝트를 반드시 특정 폴더(GOPATH) 안에 만들어야 했지만, 지금은 Go Modules 덕분에 어디서든 자유롭게 프로젝트를 만들 수 있어요. 이것이 현대적인 Go 개발의 표준이에요.
새로운 프로젝트를 만드는 시나리오를 따라 해 볼까요?
- 터미널에서 프로젝트를 만들 폴더로 이동하세요:
mkdir my-go-app && cd my-go-app - 모듈을 초기화하세요:
go mod init my-go-app
이 명령어를 실행하면 폴더에 go.mod라는 파일이 생겨요. 이 파일은 프로젝트의 이름과 사용 중인 Go 버전, 그리고 나중에 설치하게 될 외부 라이브러리들의 목록을 관리하는 아주 중요한 역할을 해요. 이제 여러분은 현대적인 방식으로 개발할 준비가 된 거예요.
STEP 5. 첫 번째 Hello World와 검증
마지막으로 모든 설정이 잘 되었는지 확인하기 위해 아주 간단한 코드를 작성해 볼게요. main.go 파일을 만들고 아래 코드를 입력해 보세요.
package main
import "fmt"
func main() {
fmt.Println("Hello, Go World!")
}
이제 터미널에서 go run main.go를 입력하세요. 화면에 Hello, Go World!이라는 문구가 뜬다면, 여러분의 Go 개발환경 구축은 대성공이에요!
자주 하는 실수와 해결법 + FAQ
자주 하는 실수와 해결법
환경을 설정하다 보면 누구나 한 번쯤은 실수를 해요. 하지만 그 실수가 반복되지 않도록 미리 알고 있다면 훨씬 빠르게 문제를 해결할 수 있어요.
- ❌ ‘go: command not found’ 오류 발생
왜 발생하는가: 환경 변수(PATH) 설정이 제대로 되지 않았거나, 설정 후 터미널을 재시작하지 않았기 때문이에요.
✅ 해결법: PATH에 Go의 bin 폴더 경로가 정확히 추가되었는지 확인하고, 반드시 터미널을 완전히 껐다 켜보세요. - ❌ Mac에서 M1/M2 칩을 쓰는데 실행이 안 됨
왜 발생하는가: Intel용(x86-64) 바이너리를 설치했기 때문이에요.
✅ 해결법: 반드시 ARM64용 설치 파일을 다시 다운로드하여 설치해 주세요. - ❌ VS Code에서 코드 자동 완성이 안 됨
왜 발생하는가: Go 확장 프로그램이 설치되었지만, 내부 도구(gopls 등)가 설치되지 않았기 때문이에요.
✅ 해결법: Command Palette에서 ‘Go: Install/Update Tools’를 실행해 모든 도구를 설치하세요. - ❌ go.mod 파일 없이 패키지를 가져오려 할 때 오류 발생
왜 발생하는가: 모듈 시스템이 활성화되지 않은 폴더에서 외부 라이브러리를 사용하려 했기 때문이에요.
✅ 해결법: 프로젝트 루트 폴더에서go mod init [이름]명령어를 먼저 실행하세요. - ❌ 권한 문제(Permission Denied) 발생
왜 발생하는가: 시스템 폴더에 파일을 쓰려고 하거나, 설치 경로에 대한 접근 권한이 없기 때문이에요.
✅ 해결법: macOS/Linux라면sudo를 신중하게 사용하거나, 사용자 홈 디렉토리 내에서 작업하는 것을 권장해요.
자주 묻는 질문
Q. Go를 설치할 때 GOPATH를 꼭 설정해야 하나요?
아니요, 예전에는 필수였지만 지금은 Go Modules를 사용하기 때문에 직접 설정하지 않아도 대부분의 작업이 가능해요. 다만, 도구들이 설치되는 위치를 관리하고 싶다면 알아두는 것이 좋아요.
Q. Windows에서 PowerShell이 불편한데 다른 걸 써도 되나요?
네, 당연하죠! Git Bash나 WSL(Windows Subsystem for Linux)을 사용하면 리눅스와 유사한 환경에서 훨씬 편리하게 개발할 수 있어요. 많은 실무 개발자들이 WSL을 선호한답니다.
Q. Go 버전을 업데이트하려면 어떻게 하나요?
기존 버전을 삭제하고 새 버전의 설치 파일을 내려받아 다시 설치하는 것이 가장 깔끔해요. 설치 후 go version으로 확인하면 돼요.
Q. VS Code 말고 다른 에디터는 어떤 게 있나요?
JetBrains에서 만든 GoLand라는 유료 IDE가 있어요. 매우 강력한 기능을 제공하지만, 입문자에게는 무료이면서 커뮤니티가 큰 VS Code를 먼저 추천해요.
마치며: 안정적인 개발을 위한 다음 단계
드디어 Go 개발 환경을 밑바닥부터 직접 구축해 보셨군요! 이 과정은 단순히 프로그램을 설치하는 것을 넘어, 여러분의 컴퓨터가 어떻게 명령어를 처리하고 언어를 실행하는지 이해하는 아주 값진 경험이었을 거예요.
이제 도구는 준비되었습니다. 이제 여러분이 할 일은 이 강력한 도구를 사용해 멋진 프로그램을 만들어내는 것이에요. 처음에는 문법이 낯설 수 있지만, Go 특유의 간결함과 속도에 매료될 준비를 하세요.
- 공식 사이트에서 OS 아키텍처(ARM64 vs x86-64)에 맞는 바이너리 설치하기
- 환경 변수(PATH)에 Go bin 폴더 경로를 반드시 추가하기
- VS Code 설치 후 Go 확장 프로그램과 내부 도구 모두 업데이트하기
- 프로젝트 시작 시
go mod init으로 모듈 환경 만들기 - 설치 후
go version으로 정상 작동 확인하기
성장을 위한 실행 계획
- 오늘 할 일: 설치한 환경에서 간단한 계산기 프로그램 만들어 보기
- 이번 주 할 일: Go 표준 라이브러리(fmt, net/http) 기초 공부하기
- 실행 직전 할 일: 실무에서 쓰이는 프로젝트 폴더 구조(Layout) 살펴보기
실무에서 바로 써먹을 수 있는 환경 구성 팁이 더 궁금하다면, 아래의 가이드를 함께 읽어보세요. 여러분의 개발 여정을 응원할게요!
함께 읽으면 좋은 글: /programming/golang/go-install-setup-complete-guide/
