Ubuntu 24.04에서 Go 1.26.1과 VS Code 설치하기

Ubuntu 24.04 환경에서 Go 1.26.1과 Visual Studio Code를 처음 설치하는 방법을 정리합니다.

Go는 Ubuntu APT 저장소에서도 설치할 수 있지만, 수업이나 프로젝트에서 특정 Go 버전을 맞춰야 한다면 Go 공식 tarball을 사용하는 것이 가장 명확합니다. Ubuntu 패키지 저장소의 Go 버전은 수업 기준 버전과 다를 수 있기 때문입니다.

이 글에서는 Go 공식 설치 문서와 Go 공식 다운로드 페이지, Visual Studio Code 공식 Linux 설치 문서, VS Code Go 확장 문서를 기준으로 설명합니다.

이 글은 기준 버전인 go1.26.1 설치를 목적으로 작성했습니다.
2026년 7월 3일 기준 Go 공식 다운로드 페이지에서는 go1.26.4가 더 최신 1.26.x 릴리스로 확인되지만, 이 글에서는 요청한 기준에 맞춰 go1.26.1로 고정합니다.

핵심 요약

Ubuntu 24.04에서 Go 1.26.1과 VS Code를 설치할 때는 아래 순서로 진행하면 됩니다.

기존 Go 설치 제거
필요한 기본 도구 설치
CPU 아키텍처 확인
Go 1.26.1 공식 tarball 다운로드
SHA256 checksum 검증
/usr/local에 Go 설치
PATH 설정
go version으로 설치 확인
VS Code 설치
VS Code Go 확장 설치
테스트 프로젝트 생성
go run .으로 실행 확인

Go 공식 문서에서는 기존 /usr/local/go 디렉터리에 새 Go tarball을 덮어 풀지 말고, 기존 디렉터리를 먼저 삭제한 뒤 새로 압축을 풀도록 안내합니다.

1. 터미널 열기와 시스템 확인

Ubuntu에서 터미널을 엽니다.

Ctrl + Alt + T

먼저 Ubuntu 버전과 CPU 아키텍처를 확인합니다.

lsb_release -a
uname -m

결과는 보통 아래 둘 중 하나입니다.

`uname -m` 결과	의미	설치 파일
`x86_64`	일반적인 Intel/AMD 64-bit PC	`linux-amd64`
`aarch64`	ARM 64-bit 장비	`linux-arm64`

수업용 PC가 일반적인 Intel 또는 AMD 기반이라면 linux-amd64 파일을 사용하면 됩니다.

2. 기존 Go 제거

이전에 설치된 Go가 있다면 먼저 제거합니다.

sudo rm -rf /usr/local/go

APT로 설치한 Go가 있다면 함께 제거합니다.

sudo apt remove -y golang-go golang
sudo apt autoremove -y

설치되어 있지 않다는 메시지가 나와도 괜찮습니다.

Go 공식 설치 문서에서는 기존 /usr/local/go 디렉터리에 새 tarball을 그대로 덮어 풀지 말라고 안내합니다.
기존 Go 디렉터리를 먼저 삭제하고 새로 압축을 풀어야 깨진 설치 상태를 피할 수 있습니다.

3. 필수 도구 설치

다운로드, 인증서 확인, 압축 해제, Git 사용에 필요한 도구를 설치합니다.

sudo apt update
sudo apt install -y curl ca-certificates tar git

설치 확인:

git --version
curl --version

4. Go 1.26.1 다운로드

Go 공식 다운로드 페이지에서 Linux용 Go 1.26.1 tarball을 다운로드합니다.

4-1. Intel/AMD 64-bit PC

uname -m 결과가 x86_64이면 아래 명령을 사용합니다.

cd /tmp
curl -LO https://go.dev/dl/go1.26.1.linux-amd64.tar.gz

공식 SHA256 checksum:

031f088e5d955bab8657ede27ad4e3bc5b7c1ba281f05f245bcc304f327c987a

검증:

sha256sum go1.26.1.linux-amd64.tar.gz

출력된 값이 위 checksum과 정확히 같아야 합니다.

4-2. ARM 64-bit PC

uname -m 결과가 aarch64이면 아래 명령을 사용합니다.

cd /tmp
curl -LO https://go.dev/dl/go1.26.1.linux-arm64.tar.gz

공식 SHA256 checksum:

a290581cfe4fe28ddd737dde3095f3dbeb7f2e4065cab4eae44dfc53b760c2f7

검증:

sha256sum go1.26.1.linux-arm64.tar.gz

출력된 값이 위 checksum과 정확히 같아야 합니다.

5. Go 설치

CPU 아키텍처에 맞는 명령을 실행합니다.

5-1. Intel/AMD 64-bit PC

sudo tar -C /usr/local -xzf /tmp/go1.26.1.linux-amd64.tar.gz

5-2. ARM 64-bit PC

sudo tar -C /usr/local -xzf /tmp/go1.26.1.linux-arm64.tar.gz

설치 후 Go 실행 파일은 아래 위치에 생성됩니다.

/usr/local/go/bin/go

6. PATH 설정

Go 명령어를 어느 위치에서든 실행하려면 /usr/local/go/bin을 PATH에 추가해야 합니다.

먼저 현재 사용하는 shell을 확인합니다.

echo $SHELL

결과	설정 파일
`/bin/bash` 또는 `/usr/bin/bash`	`~/.profile`
`/bin/zsh` 또는 `/usr/bin/zsh`	`~/.zshrc`

6-1. bash 사용 시

echo 'export PATH=$PATH:/usr/local/go/bin' >> ~/.profile
source ~/.profile

6-2. zsh 사용 시

echo 'export PATH=$PATH:/usr/local/go/bin' >> ~/.zshrc
source ~/.zshrc

Ubuntu 기본 로그인 shell이 bash라면 ~/.profile을 사용하는 것이 일반적입니다.
zsh를 기본 shell로 사용 중이라면 ~/.zshrc에 추가하는 것이 편합니다.

7. Go 설치 확인

설치된 Go 버전을 확인합니다.

go version

정상 출력 예:

go version go1.26.1 linux/amd64

ARM 장비라면 마지막이 linux/arm64로 표시됩니다.

Go 환경 변수도 확인합니다.

go env GOROOT GOPATH GOMODCACHE

일반적으로 아래와 비슷하게 나옵니다.

항목	일반적인 값
`GOROOT`	`/usr/local/go`
`GOPATH`	`/home/<username>/go`
`GOMODCACHE`	`/home/<username>/go/pkg/mod`

8. 테스트 프로젝트 생성

설치가 제대로 되었는지 간단한 Go 프로젝트를 만들어 확인합니다.

mkdir -p ~/workspace/go-test
cd ~/workspace/go-test
go mod init example.com/go-test

Go 1.26.1을 모듈 기준 버전으로 명시하려면 아래 명령을 사용할 수 있습니다.

go get go@1.26.1

또는 go directive만 직접 지정하려면 아래 명령을 사용할 수 있습니다.

go mod edit -go=1.26.1

go get go@1.26.1은 Go를 컴퓨터에 설치하는 명령이 아닙니다.
현재 프로젝트의 go.mod에서 Go toolchain 요구 버전을 관리하는 명령입니다.
Go 자체 설치는 앞에서 진행한 공식 tarball 설치로 완료됩니다.

main.go 파일을 만듭니다.

code main.go

VS Code를 아직 설치하지 않았다면 nano를 사용해도 됩니다.

nano main.go

아래 코드를 입력합니다.

package main

import "fmt"

func main() {
    fmt.Println("hello, go")
}

실행합니다.

go run .

정상 출력:

hello, go

9. Visual Studio Code 설치

VS Code는 Ubuntu에서 .deb 파일 방식 또는 Microsoft APT 저장소 방식으로 설치할 수 있습니다.

9-1. 간단한 설치 방식: `.deb` 파일

브라우저에서 VS Code Linux .deb 파일을 다운로드한 뒤 설치할 수 있습니다.

다운로드한 파일이 ~/Downloads에 있다면 다음처럼 설치합니다.

cd ~/Downloads
sudo apt install ./code_*.deb

VS Code 공식 문서에 따르면 .deb 패키지는 APT 저장소와 signing key 등록을 안내하며, 이를 통해 시스템 패키지 관리자로 자동 업데이트를 받을 수 있습니다.

9-2. 저장소 방식: Microsoft APT repository 등록

수업용 PC 여러 대를 같은 방식으로 설정하거나 터미널에서 일관되게 설치하려면 Microsoft APT repository를 등록하는 방식이 좋습니다.

필요한 도구를 설치합니다.

sudo apt install -y wget gpg

Microsoft signing key를 등록합니다.

wget -qO- https://packages.microsoft.com/keys/microsoft.asc | \
  sudo gpg --dearmor -o /usr/share/keyrings/microsoft.gpg

VS Code repository 파일을 생성합니다.

sudo tee /etc/apt/sources.list.d/vscode.sources > /dev/null <<'EOF'
Types: deb
URIs: https://packages.microsoft.com/repos/code
Suites: stable
Components: main
Architectures: amd64,arm64,armhf
Signed-By: /usr/share/keyrings/microsoft.gpg
EOF

패키지 목록을 갱신하고 VS Code를 설치합니다.

sudo apt update
sudo apt install -y code

설치 확인:

code --version

10. VS Code Go 확장 설치

VS Code를 실행합니다.

code .

확장 설치 순서:

왼쪽 Extensions 아이콘을 클릭합니다.
검색창에 Go를 입력합니다.
Publisher가 Go Team at Google인 Go 확장을 설치합니다.
Go 파일을 열면 Go tools 설치 안내가 뜰 수 있습니다.
안내가 뜨면 설치를 허용합니다.

Command Palette로 설치할 수도 있습니다.

Ctrl + Shift + P
Go: Install/Update Tools 입력
필요한 도구 선택
OK

VS Code Go 확장에서 주로 사용하는 도구는 다음과 같습니다.

도구	역할
`gopls`	Go 공식 language server. 자동완성, 정의 이동, 진단 기능 담당
`dlv`	Delve debugger. VS Code의 디버깅 기능에서 사용
`staticcheck`	기본 lint 도구

11. 추천 VS Code 설정

VS Code에서 아래 메뉴를 엽니다.

Ctrl + Shift + P
Preferences: Open User Settings (JSON)

아래 설정을 추가합니다.

{
  "editor.formatOnSave": true,
  "editor.codeActionsOnSave": {
    "source.organizeImports": "explicit"
  },
  "[go]": {
    "editor.defaultFormatter": "golang.go",
    "editor.formatOnSave": true
  },
  "go.useLanguageServer": true,
  "gopls": {
    "ui.semanticTokens": true,
    "formatting.gofumpt": false
  },
  "go.testFlags": ["-v"]
}

초보자에게 중요한 설정은 다음입니다.

저장 시 자동 formatting
사용하지 않는 import 정리
gopls 기반 자동완성, 에러 표시, 정의 이동
테스트 실행 시 자세한 출력

12. 업무 프로젝트 열기

업무 저장소 루트가 ~/workspace/go-playground/task이라고 가정하면 아래처럼 엽니다.

cd ~/workspace/go-playground/task
code .

VS Code 안에서 터미널을 열려면 아래 단축키를 사용합니다.

Ctrl + `

아직 sources/task-api 프로젝트를 만들지 않았다면 아래 명령으로 생성합니다.

mkdir -p sources/task-api
cd sources/task-api
go version
go mod init example.com/task-api
go get go@1.26.1
go mod edit -go=1.26.1
go mod tidy
go test ./...

이미 프로젝트를 만들었다면 아래만 실행해도 됩니다.

cd sources/task-api
go version
go mod tidy
go test ./...

13. 자주 발생하는 문제

13-1. `go: command not found`

원인은 대부분 PATH 설정이 적용되지 않은 경우입니다.

확인:

echo $PATH
ls /usr/local/go/bin/go

bash라면:

source ~/.profile

zsh라면:

source ~/.zshrc

터미널을 완전히 닫고 다시 열어도 됩니다.

13-2. `go version`이 1.26.1이 아니다

다른 Go 실행 파일이 PATH에서 먼저 잡히는 경우입니다.

확인:

which go
go version

정상 경로:

/usr/local/go/bin/go

만약 /usr/bin/go가 나온다면 APT로 설치된 Go일 가능성이 높습니다.

sudo apt remove -y golang-go golang
source ~/.profile
which go
go version

zsh라면 source ~/.zshrc를 사용합니다.

13-3. VS Code에서 Go 자동완성이 안 된다

터미널에서 먼저 확인합니다.

go version
code --version

VS Code에서 아래 순서로 확인합니다.

Go 파일을 엽니다.
Ctrl + Shift + P
Go: Locate Configured Go Tools 실행
gopls가 설치되어 있는지 확인
없으면 Go: Install/Update Tools 실행

13-4. `code .` 명령이 안 된다

VS Code가 정상 설치되었는지 확인합니다.

which code
code --version

설치되지 않았다면 9번 VS Code 설치 단계를 다시 진행합니다.

14. 설치 확인 체크리스트

설치 후 아래 명령이 모두 정상 동작하는지 확인합니다.

go version
which go
code --version
git --version

기대 상태:

go version이 go1.26.1을 출력합니다.
which go가 /usr/local/go/bin/go를 출력합니다.
code --version이 VS Code 버전을 출력합니다.
VS Code에 Go extension이 설치되어 있습니다.
go run .을 실행할 수 있습니다.
go test ./...를 실행할 수 있습니다.

결론

Ubuntu 24.04에서 Go를 설치할 때 sudo apt install golang-go만 사용하면 원하는 기준 버전과 다를 수 있습니다.

특정 버전인 Go 1.26.1을 맞춰야 한다면 Go 공식 다운로드 페이지에서 tarball을 내려받고, SHA256 checksum을 검증한 뒤 /usr/local에 설치하는 방식이 가장 명확합니다.

VS Code는 Microsoft 공식 .deb 패키지나 APT repository 방식으로 설치할 수 있습니다. 개발PC를 같은 기준으로 맞추거나 자동 업데이트를 안정적으로 받으려면 Microsoft APT repository 방식을 사용하는 것이 좋습니다.

설치 후에는 반드시 다음 네 가지를 확인하면 됩니다.

go version
which go
code --version
git --version

이 네 가지가 정상이라면 Ubuntu 24.04에서 Go 1.26.1과 VS Code를 사용한 Go 개발 준비가 완료된 상태입니다.

참고 자료

Go 공식 설치 문서: https://go.dev/doc/install
Go 공식 다운로드 및 checksum 목록: https://go.dev/dl/
Go Toolchains 문서: https://go.dev/doc/toolchain
Go Modules Reference: https://go.dev/ref/mod
Visual Studio Code Linux 설치 문서: https://code.visualstudio.com/docs/setup/linux
Go in Visual Studio Code: https://code.visualstudio.com/docs/languages/go
VS Code Go Tools 문서: https://go.googlesource.com/vscode-go/+/HEAD/docs/tools.md

저작자표시 비영리 변경금지 (새창열림)

'프로그래밍 > Go' 카테고리의 다른 글

Go 리터럴, 변수, 상수와 Zero Value (0)	2026.07.10
Go package main과 패키지 구조 이해하기 (0)	2026.07.10
Go 모듈과 패키지 이해하기 (0)	2026.07.03
VS Code Go 환경 세팅 (0)	2026.04.14
우분투 24.04 LTS 서버 Go 1.26.1 설치 (0)	2026.03.17

코딩 그리고 코드

Ubuntu 24.04에서 Go 1.26.1과 VS Code 설치하기

핵심 요약

1. 터미널 열기와 시스템 확인

2. 기존 Go 제거

3. 필수 도구 설치

4. Go 1.26.1 다운로드

4-1. Intel/AMD 64-bit PC

4-2. ARM 64-bit PC

5. Go 설치

5-1. Intel/AMD 64-bit PC

5-2. ARM 64-bit PC

6. PATH 설정

6-1. bash 사용 시

6-2. zsh 사용 시

7. Go 설치 확인

8. 테스트 프로젝트 생성

9. Visual Studio Code 설치

9-1. 간단한 설치 방식: `.deb` 파일

9-2. 저장소 방식: Microsoft APT repository 등록

10. VS Code Go 확장 설치

11. 추천 VS Code 설정

12. 업무 프로젝트 열기

13. 자주 발생하는 문제

13-1. `go: command not found`

13-2. `go version`이 1.26.1이 아니다

13-3. VS Code에서 Go 자동완성이 안 된다

13-4. `code .` 명령이 안 된다

14. 설치 확인 체크리스트

결론

참고 자료

'프로그래밍 > Go' 카테고리의 다른 글

댓글

티스토리툴바

Ubuntu 24.04에서 Go 1.26.1과 VS Code 설치하기

핵심 요약

1. 터미널 열기와 시스템 확인

2. 기존 Go 제거

3. 필수 도구 설치

4. Go 1.26.1 다운로드

4-1. Intel/AMD 64-bit PC

4-2. ARM 64-bit PC

5. Go 설치

5-1. Intel/AMD 64-bit PC

5-2. ARM 64-bit PC

6. PATH 설정

6-1. bash 사용 시

6-2. zsh 사용 시

7. Go 설치 확인

8. 테스트 프로젝트 생성

9. Visual Studio Code 설치

9-1. 간단한 설치 방식: .deb 파일

9-2. 저장소 방식: Microsoft APT repository 등록

10. VS Code Go 확장 설치

11. 추천 VS Code 설정

12. 업무 프로젝트 열기

13. 자주 발생하는 문제

13-1. go: command not found

13-2. go version이 1.26.1이 아니다

13-3. VS Code에서 Go 자동완성이 안 된다

13-4. code . 명령이 안 된다

14. 설치 확인 체크리스트

결론

참고 자료

'프로그래밍 > Go' 카테고리의 다른 글

관련글

댓글

티스토리툴바

9-1. 간단한 설치 방식: `.deb` 파일

13-1. `go: command not found`

13-2. `go version`이 1.26.1이 아니다

13-4. `code .` 명령이 안 된다