Go 개발의 첫걸음, 왜 환경 설정이 중요한가요
새로운 프로그래밍 언어를 배우기로 결심하고 설레는 마음으로 터미널을 열었을 때, 갑자기 command not found: go라는 차가운 메시지를 마주한 적이 있으신가요? 분명 설치 버튼을 눌렀는데 왜 컴퓨터는 내 명령을 알아듣지 못하는 걸까요? 이런 상황은 입문 개발자들이 가장 흔하게 겪는 당혹스러운 순간 중 하나예요.
단순히 설치 파일을 실행하는 것만으로는 개발 준비가 끝난 것이 아니에요. 컴퓨터가 Go 언어의 위치를 정확히 알 수 있도록 길을 만들어주는 환경 변수 설정 과정이 반드시 필요하거든요. 이 기초 공사가 흔들리면 나중에 라이브러리를 가져오거나 복잡한 프로젝트를 진행할 때 원인을 알 수 없는 에러 메시지 때문에 밤을 지새우게 될지도 몰라요.
Go 언어는 매우 심플하고 강력하지만, 그 심플함을 제대로 누리려면 처음에 제대로 된 환경을 갖춰두어야 해요. 이 글에서는 시행착오를 줄이고 여러분이 바로 코드를 작성할 수 있도록 Go 개발환경 치트시트를 준비했어요. 복잡한 이론보다는 지금 당장 내 컴퓨터에서 작동하게 만드는 실전적인 방법 위주로 정리했으니 차근차근 따라와 주세요.
- 운영체제별 Go 설치 및 최적화 방법
- GOPATH와 GOROOT의 명확한 차이와 설정법
- 생산성을 높여주는 VS Code와 도구 세팅
- 현대적인 프로젝트 관리 도구인 Go Modules 활용법
설치 전 꼭 확인해야 할 필수 체크리스트
무턱대고 설치 파일을 내려받기 전에, 현재 사용 중인 환경을 먼저 점검하는 것이 현명해요. 운영체제마다 설정 방식이 다르고, 어떤 도구를 선택하느냐에 따라 앞으로의 개발 경험이 크게 달라질 수 있거든요. 준비 단계에서 아래의 기준들을 미리 살펴보면 나중에 설정을 뒤엎어야 하는 번거로움을 피할 수 있어요.
먼저 여러분이 사용할 터미널 환경을 결정해야 해요. Windows 사용자라면 PowerShell이나 Git Bash가 익숙할 것이고, macOS나 Linux 사용자라면 Zsh나 Bash를 주로 사용하게 될 거예요. 또한, Go는 단순한 언어를 넘어 시스템 레벨의 동작을 많이 다루기 때문에, 운영체제의 아키텍처(x86_64 또는 ARM64)를 정확히 아는 것도 중요해요. 특히 최신 Apple Silicon(M1, M2, M3)을 사용하는 macOS 사용자라면 반드시 ARM64 버전을 선택해야 성능 저하 없이 쾌적하게 개발할 수 있어요.
다음은 설치 방식의 선택이에요. 공식 홈페이지에서 제공하는 설치 파일을 사용하는 것이 가장 표준적이지만, 여러 버전을 번갈아 가며 사용해야 하는 숙련된 개발자라면 버전 관리 도구를 사용하는 것이 훨씬 유리해요. 아래 표를 통해 나에게 맞는 설치 방식을 비교해 보세요.
| 설치 방식 | 장점 | 단점 | 추천 대상 |
|---|---|---|---|
| 공식 설치 파일 (MSI/PKG) | 가장 쉽고 안정적임 | 버전 변경이 번거로움 | 입문자, 단일 버전 사용자 |
| 패키지 매니저 (Homebrew 등) | 업데이트가 간편함 | 관리 도구 의존성 발생 | macOS 사용자, 라이브러리 관리 중시 |
| 버전 관리 도구 (asdf, gvm) | 여러 버전 전환이 매우 쉬움 | 초기 설정이 복잡함 | 전문 개발자, 다중 프로젝트 환경 |
마지막으로 기억해야 할 개념은 GOROOT와 GOPATH예요. GOROOT는 Go 언어 자체가 설치된 경로를 의미하고, GOPATH는 여러분이 만든 코드와 외부에서 가져온 패키지들이 저장되는 작업 공간을 의미해요. 현대적인 Go 개발에서는 Go Modules 덕분에 GOPATH의 제약이 많이 사라졌지만, 이 두 개념의 차이를 명확히 이해하고 있어야 환경 변수 설정 시 혼란을 겪지 않아요.
설치 과정에서 관리자 권한(Administrator/sudo)이 필요할 수 있으니, 설치 전에 계정 권한을 미리 확인해 두는 것이 좋아요.
실전! Go 개발 환경 구축 단계별 가이드
이제 본격적으로 여러분의 컴퓨터를 Go 개발을 위한 멋진 워크스테이션으로 만들어 볼 시간이에요. 이 단계는 단순히 프로그램을 깔고 끝내는 것이 아니라, 코드가 원활하게 컴파일되고 실행될 수 있는 탄탄한 토대를 만드는 과정이에요.
STEP 1. 운영체제별 Go 설치하기
가장 먼저 해야 할 일은 Golang 공식 홈페이지에서 설치 파일을 내려받는 것이에요. 운영체제에 따라 가장 효율적인 방법이 다르니 주의 깊게 확인해 주세요.
- Windows: 공식 사이트에서 .msi 파일을 내려받아 실행하세요. 설치 과정에서 제공되는 옵션들은 대부분 기본값으로 두어도 무방하지만, 설치 경로가 너무 복잡하거나 한글이 포함된 폴더가 되지 않도록 주의하세요.
- macOS: .pkg 파일을 내려받아 설치하거나, 이미 Homebrew를 사용 중이라면 터미널에
brew install go를 입력하는 것이 훨씬 깔끔해요. 특히 Apple Silicon 사용자는 ARM64 버전인지 다시 한번 확인하세요. - Linux: tar.gz 압축 파일을 내려받아 /usr/local 디렉토리에 압축을 푸는 방식이 일반적이에요. 설치 후에는 반드시 환경 변수 설정을 수동으로 진행해 주어야 해요.
설치가 완료되었다면 터미널(또는 PowerShell)을 열고 go version 명령어를 입력해 보세요. 설치된 버전 정보가 출력된다면 일단 절반은 성공한 거예요!
STEP 2. 환경 변수와 경로 설정의 마법
많은 입문자가 여기서 좌절하곤 해요. 설치는 했는데 터미널이 Go를 못 찾는다면, 바로 PATH 설정 문제예요. 컴퓨터에게 “Go 실행 파일은 여기 있어!”라고 알려주는 과정이죠.
Windows에서는 ‘시스템 환경 변수 편집’ 메뉴를 통해 Go의 bin 폴더 경로를 PATH에 추가해야 해요. macOS나 Linux는 사용 중인 쉘의 설정 파일(예: .zshrc 또는 .bashrc) 끝에 export PATH=$PATH:/usr/local/go/bin과 같은 문구를 추가해 주어야 해요. 설정을 마친 뒤에는 반드시 터미널을 껐다 켜야 변경 사항이 적용된다는 점을 잊지 마세요.
최근 Go 개발의 핵심인 Go Modules 환경에서는 과거처럼 GOPATH 안에 코드를 억지로 넣을 필요가 없어요. 여러분이 원하는 어떤 디렉토리에서든 자유롭게 프로젝트를 시작할 수 있답니다.
STEP 3. 최고의 파트너, VS Code 세팅하기
코드를 작성할 때 메모장을 쓸 수는 없겠죠? 전 세계 개발자들이 가장 사랑하는 도구 중 하나인 Visual Studio Code(VS Code)를 활용해 보세요. 하지만 VS Code만 깔았다고 끝이 아니에요. Go 개발을 위한 강력한 날개를 달아줘야 합니다.
- VS Code를 설치하고 왼쪽의 확장(Extensions) 아이콘을 클릭하세요.
- 검색창에 Go를 입력하고 Google에서 만든 공식 확장을 설치하세요.
- 확장을 설치한 후, 명령 팔레트(Ctrl+Shift+P 또는 Cmd+Shift+P)를 열어
Go: Install/Update Tools를 입력하세요. - 나타나는 모든 도구(gopls, dlv, staticcheck 등)를 체크하고 확인을 누르세요. 이 도구들은 코드 자동 완성, 디버깅, 오류 검출을 담당하는 핵심 엔진이에요.
이제 코드 작성 중에 오타가 나면 빨간 줄로 알려주고, 함수 이름을 입력할 때 자동으로 완성해 주는 마법 같은 경험을 할 수 있을 거예요.
STEP 4. 현대적 프로젝트 관리, Go Modules 시작하기
이제 모든 준비가 끝났으니 첫 번째 프로젝트를 만들어 볼까요? 예전 방식처럼 폴더 구조에 매몰되지 말고, Go Modules 방식을 사용하세요. 이것이 현재 Go 커뮤니티의 표준이에요.
원하는 위치에 새 폴더를 만들고 터미널로 이동한 뒤, 다음 명령어를 입력해 보세요: go mod init my-project. 이 명령을 실행하면 폴더 안에 go.mod라는 파일이 생성될 거예요. 이 파일은 여러분 프로젝트의 이름과 사용 중인 라이브러리들의 버전을 기록하는 명부 역할을 해요.
새로운 외부 라이브러리를 설치하고 싶다면 go get <패키지주소>를 사용하면 되고, 프로젝트에 사용 중인 라이브러리들을 깔끔하게 정리하고 싶다면 go mod tidy 명령어를 사용하세요. 이 명령어 하나로 불필요한 의존성은 제거하고 필요한 것은 자동으로 가져올 수 있답니다.
STEP 5. 첫 번째 코드 실행 시나리오
모든 설정이 완벽한지 확인하기 위해 간단한 테스트를 진행해 봅시다. 프로젝트 폴더에 main.go 파일을 만들고 아래 코드를 복사해서 붙여 넣어 보세요.
package main
import "fmt"
func main() {
fmt.Println("Go 개발 환경 설정 완료!")
}
저장한 뒤 터미널에서 go run main.go를 입력했을 때, 화면에 “Go 개발 환경 설정 완료!”라는 문구가 나타난다면 축하드려요! 여러분은 이제 진정한 Go 개발자로 거듭날 준비가 모두 끝난 거예요.
자주 하는 실수와 해결법
환경을 구축하다 보면 예상치 못한 벽에 부딪히기 마련이에요. 당황하지 마세요. 대부분의 문제는 아래의 5가지 사례 중 하나에서 발생하거든요.
- ❌ ‘go’ 명령어를 찾을 수 없다는 오류가 떠요
왜 발생할까요? Go 설치 경로가 시스템의 PATH 환경 변수에 등록되지 않았기 때문이에요.
✅ 해결법: 운영체제 설정에서 Go 설치 폴더의 bin 디렉토리를 PATH에 추가하고 터미널을 재시작하세요. - ❌ 외부 패키지를 가져오는데 에러가 나요
왜 발생할까요? 프로젝트에 Go Modules가 활성화되지 않았거나go.mod파일이 없기 때문이에요.
✅ 해결법: 프로젝트 루트 디렉토리에서go mod init [프로젝트명]을 실행하세요. - ❌ VS Code에서 자동 완성이 작동하지 않아요
왜 발생할까요? Go 확장이 설치되지 않았거나, 내부 도구(gopls 등)가 제대로 업데이트되지 않았을 수 있어요.
✅ 해결법: 명령 팔레트에서Go: Install/Update Tools를 실행해 모든 도구를 다시 설치하세요. - ❌ 버전이 맞지 않아 컴파일이 실패해요
왜 발생할까요? 프로젝트가 요구하는 Go 버전과 현재 설치된 버전이 다르기 때문이에요.
✅ 해결법:go version으로 버전을 확인하고, 필요하다면 버전 관리 도구(asdf 등)를 사용해 버전을 맞추세요. - ❌ 코드 실행 시 파일 경로 오류가 발생해요
왜 발생할까요? 현재 터미널의 작업 디렉토리가 프로젝트 폴더가 아니기 때문이에요.
✅ 해결법:cd [프로젝트경로]명령어를 통해 프로젝트 위치로 이동한 뒤 실행하세요.
자주 묻는 질문
Q. Go 설치는 한 번만 하면 되나요?
기본적으로는 한 번 설치하면 계속 쓸 수 있어요. 하지만 새로운 버전을 써보고 싶거나, 프로젝트마다 다른 버전을 써야 할 때는 추가적인 설치나 버전 관리 도구가 필요할 수 있어요.
Q. Windows와 macOS 중 어디에서 개발하는 게 더 좋나요?
Go는 크로스 플랫폼을 지원하므로 어느 쪽이든 상관없어요. 다만, 서버 배포 환경이 대부분 Linux인 경우가 많아, 개발 환경을 Unix 계열인 macOS나 Linux로 맞추면 환경 차이로 인한 변수를 줄일 수 있어 조금 더 유리해요.
Q. 외부 라이브러리는 어디에 저장되나요?
Go Modules를 사용하면 각 프로젝트의 go.mod 파일에 기록되며, 실제 파일들은 사용자 홈 디렉토리의 $GOPATH/pkg/mod 폴더에 안전하게 관리돼요.
Q. VS Code 말고 다른 에디터는 안 되나요?
물론이에요! JetBrains의 GoLand는 매우 강력한 유료 도구이고, Vim이나 Emacs를 사용하는 숙련된 개발자들도 많아요. 하지만 입문자에게는 설정이 쉬운 VS Code를 가장 추천해요.
Q. Go Modules를 꼭 써야 하나요?
네, 강력히 권장해요. 예전의 GOPATH 방식은 프로젝트 관리가 매우 까다로웠지만, Go Modules는 현대적인 패키지 관리 표준이며 협업과 배포를 훨씬 쉽게 만들어주거든요.
이제 코드를 작성할 준비가 끝났어요
지금까지 Go 개발환경을 구축하기 위한 모든 과정을 살펴보았어요. 처음에는 환경 변수나 터미널 명령어가 낯설고 어렵게 느껴질 수 있지만, 이 기초를 탄탄히 다져두면 나중에 어떤 복잡한 프로젝트를 만나더라도 흔들리지 않는 실력을 갖출 수 있어요. 환경 설정은 개발의 끝이 아니라, 본격적인 항해를 위한 닻을 올리는 과정이라는 점을 꼭 기억해 주세요.
- 운영체제에 맞는 적절한 설치 파일(또는 패키지 매니저) 선택하기
- PATH 환경 변수에 Go bin 경로를 반드시 추가하기
- VS Code와 공식 Go 확장 프로그램을 설치하고 도구 업데이트하기
- 모든 프로젝트는
go mod init으로 시작하기 - 에러가 발생하면 터미널의 메시지와 환경 변수 설정을 먼저 확인하기
오늘 배운 내용을 바탕으로 바로 다음 단계로 나아가 보세요. 무엇을 해야 할지 막막하다면 아래의 계획을 따라보시는 건 어떨까요?
- 오늘 할 일: Go 설치를 완료하고
go version으로 성공 여부 확인하기 - 이번 주 할 일: VS Code 세팅을 마치고 간단한 Hello World 프로그램 실행해 보기
- 실행 직전 할 일: Go Modules를 이용해 외부 라이브러리 하나를 가져와서 사용해 보기
개발을 하다가 막히는 부분이 있거나 이해가 가지 않는 개념이 있다면 주저하지 말고 댓글로 남겨 주세요. 여러분의 성공적인 Go 학습을 진심으로 응원할게요!
함께 읽으면 좋은 글: Go 설치와 개발환경 설정 완벽 가이드
