설치 시작하기

https://golang.org/doc/install 문서의 한국어 번역 문서입니다.

Go 배포판 다운로드 하기

• Go 다운로드 페이지 - https://golang.org/dl/

공식 바이너리 배포판을 설치할 수 있는 환경은 다음과 같습니다.

• 운영체제: FreeBSD(8-STABLE 버전 이상), Linux, Mac OS X(10.8 버전 이상), Windows
• 아키텍처: 32비트(386), 64비트(amd64) x86 프로세서

이와 같은 환경이 아니라면, 소스를 이용해 설치하거나 gc 대신 gccgo를 설치하여 Go 언어 프로그래밍을 할 수 있습니다.

시스템 요구사항

Go 바이너리 배포판은 아래의 운영체제 및 아키텍처 환경에서 사용할 수 있습니다. Go 바이너리 배포판을 설치하기 전에 당신의 시스템이 아래의 조건을 충족하는지 반드시 확인하시기 바랍니다. 운영체제나 아키텍처가 아래 목록에 없다면 소스를 이용한 설치나 gccgo를 설치하는 방법을 이용할 수 있습니다.

운영체제	아키텍처	참고사항
FreeBSD 9.3 이상	amd64, 386	Debian GNU/kFreeBSD는 지원하지 않음
glibc가 있는 Linux 2.6.23 이상	amd64, 386, arm, arm64, s390x, ppc64le	CentOS/RHEL 5.x는 지원하지 않음
Mac OS X 10.8 이상	amd64	cgo 지원을 위해 Xcode‡와 함께 제공되는 clang 또는 gcc† 사용
Windows XP SP2 이상	amd64, 386	MinGW gcc†를 사용. cygwin이나 msys는 필요 없음

† cgo를 사용할 계획이라면 gcc가 필요합니다.

‡ Xcode command line tools만 설치하면 됩니다. Xcode 4.3 이상을 설치했다면, 다운로드 환경 설정 패널의 컴포넌트 탭에서 설치할 수 있습니다.

Go tools 설치하기

이전 버전의 Go에서 업그레이드하는 경우라면 우선, 기존 버전을 제거해야 합니다.

Linux, Mac OS X, FreeBSD tarballs

압축파일을 다운로드한 다음, /usr/local에 압축을 풀면, /usr/local/go에 Go 하위 디렉터리가 생성됩니다. 예시:

tar -C /usr/local -xzf go$VERSION.$OS-$ARCH.tar.gz

설치에 적합한 압축 파일을 선택하세요. 예를 들어 Go 1.2.1 버전을 Linux 64 비트 x86에 설치하는 경우, 적합한 파일은 go1.2.1.linux-amd64.tar.gz 입니다.

(일반적으로 이런 명령들은 root 계정 또는 sudo를 통해 실행해야 합니다.)

PATH 환경변수에 /usr/local/go/bin을 추가합니다. /etc/profile(시스템 전체에 적용하는 경우) 또는 $HOME/.profile에 아래 라인을 추가하세요.

export PATH=$PATH:/usr/local/go/bin

사용자 정의 위치에 설치하기

Go 바이너리 배포판은 기본적으로 /usr/local/go(Windows에서는 c:\Go)에 설치되지만, Go tools를 다른 위치에 설치할 수도 있습니다. 이 경우, 설치한 디렉터리를 가리키는 GOROOT 환경 변수를 설정해야 합니다.

예를 들어, 사용자의 home 디렉터리에 Go를 설치한 경우 $HOME/.profile에 다음 라인을 추가해야 합니다.

export GOROOT=$HOME/go1.X
export PATH=$PATH:$GOROOT/bin

주의: GOROOT는 사용자 정의 위치에 Go를 설치하는 경우에만 설정해야 합니다.

Max OS X 패키지 설치 프로그램

패키지 파일을 다운로드한 다음, 파일을 실행하여 안내 메시지에 따라 Go tools를 설치하세요. 패키지는 /usr/local/go에 Go 배포판을 설치합니다.

패키지를 이용해 설치한 경우, PATH 환경 변수에 /usr/local/go/bin을 추가해야 합니다. 환경 변수 변경 사항을 적용하려면 열려있는 터미널 세션을 다시 시작해야 합니다.

Windows

Go 프로젝트는 Windows 운영체제 사용자를 위해 두 가지 설치 방법을 제공합니다.(추가로 소스를 이용해 설치 방법도 있습니다). zip 압축파일을 이용한 설치 방법은 몇 가지 환경 변수 설정이 필요하며, MSI 인스톨러를 이용한 설치방법은 자동 설정을 지원합니다.

MSI 설치 프로그램

MSI 파일을 열고 안내 메시지에 따라 Go tools를 설치하세요. 기본적으로 설치 프로그램은 c:\Go에 Go 배포파일을 설치 합니다.

설치 프로그램은 PATH 환경 변수에 c:\Go\bin 디렉터리를 추가합니다. 변경 내용을 적용하려면 열려있는 명령 프롬프트를 다시 시작해야 합니다.

Zip 압축파일

zip 파일을 다운로드하고 원하는 위치에 압축을 푸세요.(c:\Go를 추천합니다).

c:\Go 이외의 디렉터리를 선택한 경우 해당 디렉터리를 GOROOT 환경 변수에 설정해야 합니다.

Go root의 bin 디렉터리(예: c:\Go\bin)를 PATH 환경 변수에 추가합니다.

Windows 환경 변수 설정

Windows 환경에서는 "시스템" 제어판의 "고급" 탭에 있는 "환경 변수" 버튼을 통해 환경 변수를 설정할 수 있습니다. 일부 Windows 버전은 이 설정을 "시스템" 제어판의 "고급 시스템 설정" 옵션을 통해 제공합니다.

설치 상태 확인하기

Go가 제대로 설치되었는지 확인하기 위해 다음과 같이 workspace를 설정하고 간단한 프로그램을 빌드해보겠습니다.

workspace 디렉터리($HOME/go)를 생성합니다.(다른 디렉터리를 사용하는 경우, GOPATH 환경 변수를 설정해야 합니다.)

workspace 디렉터리 아래에 src/hello를 생성하고, src/hello 디렉터리로 이동하여 hello.go라는 파일을 아래와 같이 작성합니다.

package main

import "fmt"

func main() {
    fmt.Printf("hello, world\n")
}

그런 다음, go tool을 이용해 이것을 빌드합니다.

$ cd $HOME/go/src/hello
$ go build

위의 명령은 소스 코드가 들어있는 디렉터리 안에 hello라는 실행가능한 파일을 빌드합니다. 환영 메시지를 확인하기 위해 이것을 실행해봅시다.

$ ./hello
hello, world

"hello, world" 메시지가 표시되면, Go가 정상적으로 설치된 것입니다.

Go 코드 작성을 시작하기 전에 Go tools에 관해 설명한 Go 코드를 작성하는 방법을 꼭 읽어보십시오.

Go 제거하기

기존에 설치된 Go를 시스템에서 제거하려면 go 디렉터리를 삭제하세요. 일반적으로 Linux, Mac OS X, FreeBSD 에서는 /usr/local/go이고, Windows 에서는 c:\Go입니다.

또한 PATH 환경 변수에서 Go bin 디렉터리를 제거해야 합니다. Linux 및 FreeBSD 에서는 /etc/profile 또는 $HOME/.profile 을 수정해야 합니다. Mac OS X 패키지로 Go를 설치 한 경우, /etc/paths.d/go 파일을 제거해야 합니다. Windows 사용자는 Windows 환경 변수 설정과 관련된 부분을 참고해야 합니다.

도움 받기

Go 메일링 리스트, 포럼, 채팅 등을 통해 도움을 받을 수 있습니다. "go bug" 명령어 또는 Go 이슈 추적시스템를 이용해 버그를 알려주시기 바랍니다.