Go 개발을 위한 첫걸음, 왜 지금 바로 시작해야 할까요?
새로운 프로그래밍 언어를 배우기로 결심했을 때, 가장 먼저 마주하는 장벽은 코드가 아니라 환경 설정이에요. 분명히 강의에서는 5분 만에 끝낼 것처럼 말했는데, 막상 따라 하다 보면 터미널에서 빨간 글씨가 뜨거나 설치 경로를 찾지 못해 1시간을 허비하기도 하죠. 저도 처음 Golang을 접했을 때, 환경 변수 설정 하나 때문에 밤을 지새운 기억이 있어요.
하지만 걱정하지 마세요. Go는 설계 단계부터 개발자의 편의성을 극도로 고려한 언어예요. 복잡한 의존성 문제나 무거운 프레임워크 없이도 아주 빠르고 가볍게 동작하거든요. 클라우드 네이티브 환경이나 백엔드 시스템 구축을 꿈꾼다면, 지금 이 시점에 Go를 익히는 것은 아주 탁월한 선택이에요.
이 글은 환경 설정 단계에서 길을 잃고 포기하려는 입문자들을 위해 준비했어요. 복잡한 이론보다는 당장 내 컴퓨터에서 코드가 돌아가게 만드는 실전적인 방법에 집중할게요. Go 개발환경 빠른 시작을 목표로, 가장 깔끔하고 오류 없는 경로만 안내해 드릴게요.
오늘 우리는 다음 내용들을 차근차근 밟아나갈 거예요.
- 내 운영체제에 딱 맞는 Go 설치 방법 확인하기
- 코드 작성이 즐거워지는 필수 도구(IDE) 세팅하기
- Go 모듈 시스템을 활용한 프로젝트 초기화
- 첫 번째 코드를 작성하고 실제로 실행까지 완료하기
준비가 되셨나요? 그럼 바로 시작해 봐요!
시작 전 체크리스트: 어떤 환경이 필요할까요?
무턱대고 설치 파일부터 내려받기 전에, 현재 내 컴퓨터 환경을 먼저 점검해야 해요. Go는 멀티 플랫폼을 지원하지만, 운영체제마다 설치 방식과 경로 설정의 디테일이 조금씩 다르거든요. 어떤 준비물이 필요한지, 그리고 내 환경에 어떤 도구가 어울릴지 미리 알고 있으면 시행착오를 절반으로 줄일 수 있어요.
운영체제별 특징과 선택 기준
대부분의 개발자는 Windows, macOS, Linux 중 하나를 사용하고 계실 거예요. 각 운영체제는 Go를 다루는 방식에서 미세한 차이를 보여요. 아래 표를 보고 본인의 환경을 확인해 보세요.
| 운영체제 | 설치 난이도 | 주요 특징 | 추천 도구 |
|---|---|---|---|
| Windows | 보통 | 환경 변수(PATH) 설정이 중요함 | VS Code, PowerShell |
| macOS | 낮음 | Homebrew를 통한 간편한 관리 가능 | VS Code, iTerm2 |
| Linux | 보통 | 터미널 기반 환경, 서버 배포와 유사함 | Vim, VS Code |
운영체제를 확인했다면, 이제 도구를 골라야 해요. 코드를 작성할 메모장 같은 존재가 바로 IDE(통합 개발 환경)예요. 입문자에게는 전 세계적으로 가장 많이 쓰이고, Go 전용 확장 기능이 매우 잘 갖춰진 Visual Studio Code(VS Code)를 강력하게 추천해요. 가볍고 무료라는 점이 가장 큰 매력이죠.
Go는 컴파일 언어예요. 이는 작성한 코드를 컴퓨터가 바로 이해할 수 있는 기계어로 바꾸는 과정이 필요하다는 뜻이에요. 그래서 실행하기 전에 반드시 컴파일 과정을 거치거나, `go run` 명령어를 통해 내부적으로 컴파일된 결과를 실행하게 돼요.
마지막으로 필요한 개념 하나만 짚고 넘어갈게요. 바로 환경 변수(Environment Variable)예요. 컴퓨터에게 “Go라는 프로그램이 어디에 설치되어 있는지” 알려주는 이정표와 같아요. 설치 후 터미널에서 `go version`을 입력했을 때 에러가 난다면, 대부분 이 이정표를 제대로 세우지 못했기 때문이에요. 이 부분은 다음 단계의 설치 과정에서 아주 상세히 다룰 테니 너무 걱정하지 마세요.
실전 가이드: 10분 만에 끝내는 Go 설치와 설정
이제 본격적으로 컴퓨터에 Go의 생명력을 불어넣어 볼 시간이에요. 단순히 설치 버튼만 누르는 게 아니라, 실제 개발자가 바로 업무에 투입될 수 있는 수준의 환경을 구축하는 것이 목표예요. 단계별로 차근차근 따라와 주세요.
STEP 1. 공식 웹사이트에서 Go 내려받기
가장 먼저 해야 할 일은 검증된 공식 경로를 통해 설치 파일을 받는 거예요. 출처를 알 수 없는 사이트에서 내려받으면 보안 문제는 물론, 버전 호환성 문제로 고생할 수 있어요.
먼저 웹 브라우저를 열고 golang.org 공식 사이트에 접속하세요. 메인 화면에 보이는 Download 메뉴를 클릭하면 여러분의 운영체제에 맞는 파일들이 나열될 거예요. Windows 사용자라면 `.msi` 파일을, macOS 사용자라면 `.pkg` 파일을 선택하면 됩니다. Linux 사용자라면 `.tar.gz` 압축 파일을 내려받는 것이 일반적이에요.
팁: 항상 가장 최신 안정화 버전(Stable Version)을 선택하세요. 베타 버전은 실험적인 기능이 많아 입문 단계에서는 오히려 방해가 될 수 있어요.
STEP 2. 운영체제별 맞춤 설치 진행하기
파일을 내려받았다면 이제 실행할 차례예요. OS마다 조금씩 주의할 점이 있어요.
Windows 사용자라면: 다운로드한 `.msi` 파일을 더블 클릭하세요. 설치 마법사가 나타나면 기본 설정 그대로 ‘Next’를 누르면 돼요. 여기서 가장 중요한 것은 설치 경로예요. 기본적으로 `C:\Program Files\Go`에 설치되는데, 이 경로는 나중에 환경 변수를 확인할 때 필요하니 꼭 기억해 두세요. 설치가 끝나면 반드시 터미널(PowerShell 또는 CMD)을 새로 열어야 설정이 적용된다는 점을 잊지 마세요.
macOS 사용자라면: 두 가지 방법이 있어요. 첫째는 `.pkg` 파일을 실행하는 전통적인 방식이고, 둘째는 개발자라면 필수인 Homebrew를 사용하는 방식이에요. 터미널을 열고 `brew install go`라고 입력하기만 하면 끝나요. 개인적으로는 패키지 관리가 쉬운 Homebrew 방식을 훨씬 추천해요.
설치 후 터미널에 `go version`을 입력했을 때 “명령어를 찾을 수 없습니다”라는 메시지가 나온다면, 설치가 안 된 게 아니라 환경 변수(PATH)가 등록되지 않은 거예요. 이럴 땐 컴퓨터를 재부팅하거나, 시스템 환경 변수 설정에서 Go의 bin 폴더 경로를 직접 추가해줘야 해요.
STEP 3. VS Code와 Go 확장 프로그램 완벽 세팅
이제 코드를 작성할 무기를 준비해야죠. VS Code를 실행한 뒤, 왼쪽 사이드바에 있는 확장 프로그램(Extensions) 아이콘을 클릭하세요. 검색창에 Go를 입력하면 Google에서 만든 공식 확장 프로그램이 보일 거예요. 이걸 설치하세요.
설치가 완료되면 VS Code가 오른쪽 하단에 “Analysis Tools Missing”이라는 메시지를 띄울 수도 있어요. 이건 당황하지 마세요! Go 코드를 더 똑똑하게 분석해 주는 도구들을 추가로 설치하라는 친절한 안내예요. 메시지에 있는 Install All 버튼을 누르면 터미널이 자동으로 돌아가며 필요한 도구들을 알아서 설치해 줄 거예요. 이 과정이 끝나야 비로소 자동 완성, 코드 오류 검사, 포맷팅 기능을 제대로 쓸 수 있어요.
STEP 4. Go 모듈을 이용한 첫 프로젝트 생성
과거에는 모든 코드를 특정 폴더(`GOPATH`) 안에 몰아넣어야 했지만, 이제는 그럴 필요가 없어요. 현대적인 Go 개발은 Go Modules라는 시스템을 사용해요. 여러분이 원하는 어떤 폴더에서든 프로젝트를 시작할 수 있죠.
먼저 바탕화면이나 문서 폴더에 `my-go-app`이라는 새 폴더를 만드세요. 그 다음 VS Code로 그 폴더를 엽니다. 이제 터미널(Ctrl + `)을 열고 아래 명령어를 입력하세요.
`go mod init my-go-app`
이 명령어를 실행하면 폴더 안에 `go.mod`라는 파일이 생길 거예요. 이 파일은 이 프로젝트가 어떤 라이브러리를 사용하는지 기록하는 일종의 명부예요. 이 파일이 있어야 Go가 여러분의 코드를 체계적으로 관리할 수 있답니다.
STEP 5. Hello World 실행 및 검증
마지막 관문이에요. 이제 진짜 코드를 작성해 봅시다. `main.go`라는 파일을 만들고 아래 코드를 그대로 입력해 보세요.
package main
import "fmt"
func main() {
fmt.Println("안녕하세요, Go의 세계에 오신 것을 환영합니다!")
}
저장이 완료되었다면 터미널에 이렇게 입력해 보세요. go run main.go
터미널 화면에 “안녕하세요, Go의 세계에 오신 것을 환영합니다!”라는 문구가 떴나요? 축하해요! 여러분은 방금 Go 개발자가 되기 위한 가장 어렵고도 중요한 관문을 완벽하게 통과했어요.
go run은 코드를 즉시 실행할 때 편리하지만, 실제 배포할 때는 go build를 사용해요. `go build`를 실행하면 실행 가능한 단일 파일(예: main.exe)이 생성되어, Go가 설치되지 않은 다른 컴퓨터에서도 바로 실행할 수 있게 됩니다.자주 하는 실수와 해결법 + FAQ
설정 과정에서 겪는 문제는 대부분 비슷한 패턴을 보여요. 문제를 마주했을 때 당황해서 처음부터 다시 설치하기보다는, 아래의 해결책을 먼저 살펴보는 것이 훨씬 효율적이에요.
자주 하는 실수와 해결법
❌ 실수: 터미널에 명령어를 쳤는데 아무 반응이 없거나 에러가 나요.
왜 발생하는가: 설치 후 기존에 열려 있던 터미널을 그대로 사용했기 때문이에요.
✅ 해결법: 설치가 끝났다면 반드시 사용 중인 모든 터미널이나 명령 프롬프트를 닫고 새로 열어주세요. 환경 변수는 프로그램이 시작될 때 로드되거든요.
❌ 실수: VS Code에서 코드 자동 완성이 작동하지 않아요.
왜 발생하는가: Go 확장 프로그램이 설치되었더라도, 내부 분석 도구(gopls 등)가 제대로 설치되지 않았기 때문이에요.
✅ 해결법: VS Code 명령 팔레트(Ctrl+Shift+P)를 열고 “Go: Install/Update Tools”를 검색해 실행하세요. 모든 도구를 선택하고 확인을 누르면 해결됩니다.
❌ 실수: `go mod init`을 안 하고 코드를 실행하려고 해요.
왜 발생하는가: 현대적인 Go 프로젝트는 모듈 시스템을 기반으로 작동하는데, 이 설정 파일이 없으면 의존성 관리가 안 돼요.
✅ 해결법: 프로젝트 폴더 최상위에서 반드시 `go mod init [프로젝트명]` 명령어를 먼저 실행해 주세요.
❌ 실수: Windows에서 `go` 명령어를 인식하지 못해요.
왜 발생하는가: 설치 프로그램이 자동으로 PATH를 등록하지 못했거나, 수동 설정이 누락되었기 때문이에요.
✅ 해결법: 시스템 환경 변수 편집에서 `C:\Program Files\Go\bin` 경로가 추가되어 있는지 확인해 보세요.
❌ 실수: `fmt` 패키지를 찾을 수 없다는 에러가 떠요.
왜 발생하는가: 코드 상단에 `import “fmt”`가 빠졌거나, 오타가 났을 가능성이 높아요.
✅ 해결법: 코드 최상단에 정확한 패키지 선언과 임포트 문이 있는지 다시 한번 확인해 보세요.
자주 묻는 질문
Q. Go를 배우면 어떤 직업을 가질 수 있나요?
주로 백엔드 개발자, 클라우드 엔지니어, 인프라 자동화 전문가로 활동하게 돼요. 특히 구글, 넷플릭스 같은 대규모 시스템을 운영하는 기업에서 Go 개발자를 매우 선호하고 있어요.
Q. Python이나 Java를 아는데, Go를 배우면 도움이 될까요?
네, 엄청나요! 다른 언어의 개념을 알고 있다면 Go의 단순함이 오히려 큰 강점으로 다가올 거예요. 병렬 처리를 다루는 법을 배우면 시스템의 효율성을 높이는 눈이 생깁니다.
Q. 공부는 어디서부터 시작하는 게 좋을까요?
공식 문서(go.dev)의 Tutorial을 먼저 따라 해보는 것을 추천해요. 그 다음에는 간단한 CLI(명령줄 도구) 프로그램을 직접 만들어 보는 것이 실력 향상에 가장 빨라요.
Q. Go는 왜 이름이 Golang인가요?
도메인 이름이 go.org가 아니라 go.dev로 바뀌면서 혼동을 줄이기 위해 프로그래밍 언어로서의 정체성을 나타내는 Golang이라는 용어가 널리 쓰이게 되었어요.
Q. Mac에서 M1/M2 칩을 쓰는데 설치할 때 주의할 점이 있나요?
최신 버전의 Go는 Apple Silicon을 완벽하게 지원해요. 설치 파일 선택 시 ARM64 버전을 선택하거나, Homebrew를 사용하면 자동으로 최적화된 버전을 설치해 줍니다.
성공적인 Go 시작을 위한 마지막 정리
환경 설정이라는 거대한 산을 드디어 넘으셨네요! 처음엔 복잡해 보였을지 모르지만, 막상 한 번 세팅을 끝내고 나면 Go만큼 깔끔하고 직관적인 도구가 없다는 걸 느끼실 거예요. 이제 여러분의 컴퓨터는 Go 코드를 받아들일 완벽한 준비가 되었습니다.
- 공식 사이트(golang.org)를 통해 OS에 맞는 설치 파일 다운로드
- Windows는 환경 변수(PATH), macOS는 Homebrew 활용 권장
- VS Code 설치 후 Go 확장 프로그램 및 분석 도구 설치 필수
- 프로젝트 시작 시 반드시 `go mod init`으로 모듈 초기화
- `go run`으로 실행하고, `go build`로 배포 파일 생성
설정을 마쳤다면 이제 바로 코드를 짜야 해요. 완벽한 코드를 쓰려고 고민하지 마세요. 일단은 아주 작은 기능부터 직접 구현해 보는 것이 중요합니다.
오늘 바로 해야 할 일
- 자신이 만든 `main.go` 파일의 코드를 한 줄씩 직접 타이핑해 보기
- 터미널에서 `go run` 명령어를 실행해 성공 메시지 확인하기
이번 주 목표
- Go의 기본 자료형(int, string, bool)을 활용한 계산기 프로그램 만들기
- 간단한 반복문을 사용하여 구구단 출력해 보기
오늘의 학습이 여러분의 개발 인생에 의미 있는 전환점이 되길 진심으로 응원할게요. 혹시 설정 과정에서 해결되지 않는 문제가 있다면 댓글로 남겨주세요. 함께 고민해 드릴게요!
다음 편에서는 Go의 강력한 무기인 고루틴(Goroutine)을 활용한 병렬 처리 기초를 다룰 예정이에요. 더 깊이 있는 내용을 놓치지 않으려면 구독 버튼을 꼭 눌러주세요!
함께 읽으면 좋은 글: /programming/golang/go-install-setup-complete-guide/
