Instalacja Go (Golang) na Windows, macOS i Linux krok po kroku

Pobierz Go ze strony go.dev/dl, uruchom instalator dla swojego systemu, otwórz nowy terminal i uruchom go version. Na Windows i macOS to cała instalacja. Na Linux rozpakowujesz archiwum i dodajesz jeden katalog do PATH. Poniższe sekcje omawiają każdy system, a potem sprawdzanie instalacji i błędy, na które ludzie naprawdę trafiają.

Żeby wypróbować Go, nie musisz go instalować. Ten program działa w twojej przeglądarce, na tym samym wydaniu Go, którego używa strona, i pokazuje, na czym działa:

package main

import (
	"fmt"
	"runtime"
)

func main() {
	fmt.Println("Go version:", runtime.Version())
	fmt.Println("OS:        ", runtime.GOOS)
	fmt.Println("CPU arch:  ", runtime.GOARCH)
	fmt.Println("CPUs:      ", runtime.NumCPU())
}

Po lokalnej instalacji Go ten sam program wypisze dane twojego komputera.

Który plik pobrać

Strona pobierania zawiera jeden plik na każdy system operacyjny i architekturę procesora:

W tych przykładach numer wersji to 1.24.5. Weź najnowsze stabilne wydanie; kroki nie zmieniają się między wersjami.

Instalacja Go na Windows

1. Pobierz plik .msi i uruchom go.
2. Zaakceptuj ustawienia domyślne. Go instaluje się w C:\Program Files\Go, a instalator dodaje C:\Program Files\Go\bin do PATH.
3. Zamknij wszystkie otwarte okna Wiersza polecenia lub PowerShella i otwórz nowe. Terminale otwarte w trakcie instalacji mają nadal stary PATH.
4. Sprawdź instalację:

go version

go version go1.24.5 windows/amd64

Jeśli wolisz menedżer pakietów, działa też winget:

winget install GoLang.Go

Instalacja Go na macOS

Z oficjalnego pakietu

Pobierz plik .pkg dla swojego procesora i otwórz go. Instaluje Go w /usr/local/go i dodaje /usr/local/go/bin do PATH przez plik /etc/paths.d/go. Otwórz nowe okno Terminala, a potem:

go version

go version go1.24.5 darwin/arm64

Przez Homebrew

brew install go
go version

Homebrew umieszcza Go we własnym prefiksie (/opt/homebrew na Apple Silicon) i linkuje go do katalogu, który już jest w twoim PATH. Później aktualizujesz przez brew upgrade go.

Wybierz jedną metodę. Instalacja zarówno z .pkg, jak i z Homebrew oznacza dwie binarki go w PATH, a wygrywa ta, która jest pierwsza. which go pokazuje, której używa twoja powłoka.

Instalacja Go na Linux i Ubuntu

Oficjalna metoda działa na każdej dystrybucji. Najpierw usuń poprzednią instalację, bo rozpakowanie na starym drzewie miesza pliki z dwóch wersji i psuje toolchain:

cd ~/Downloads
sudo rm -rf /usr/local/go
sudo tar -C /usr/local -xzf go1.24.5.linux-amd64.tar.gz

Potem dodaj Go do PATH. Dopisz tę linię do ~/.profile (bash) albo ~/.zshrc (zsh):

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

Wczytaj ją w bieżącej powłoce i sprawdź:

source ~/.profile
go version

go version go1.24.5 linux/amd64

Pakiety Ubuntu: apt i snap

Ubuntu oferuje dwa skróty, każdy z innymi kompromisami:

# Distribution package: easy, but usually several releases old
sudo apt install golang-go

# Snap: tracks current Go releases
sudo snap install go --classic

Wersja z apt ma większe znaczenie, niż się wydaje. Moduły deklarują minimalną wersję Go w go.mod. Od Go 1.21 moduł z wpisem go 1.23 nie zbuduje się starszym toolchainem, chyba że Go może pobrać dla ciebie nowszy, a toolchainy starsze niż 1.21 i tak próbują budować i wykładają się na pierwszej nowszej funkcji, na jaką trafią (zobacz niżej „Aktualizowanie Go”). Jeśli instalujesz z apt, uruchom go version i porównaj wynik z go.dev/dl.

Sprawdzenie instalacji

Działającą konfigurację potwierdzają trzy polecenia:

go version
go env GOROOT GOPATH
which go

go version go1.24.5 linux/amd64
/usr/local/go
/home/ana/go
/usr/local/go/bin/go

• GOROOT to miejsce, gdzie zainstalowane jest samo Go. Nigdy nie umieszczaj tam własnego kodu i nie powinno być potrzeby ustawiania tej zmiennej.
• GOPATH domyślnie wskazuje $HOME/go (%USERPROFILE%\go w Windows). Go przechowuje pobrane moduły w $GOPATH/pkg/mod i umieszcza programy zbudowane przez go install w $GOPATH/bin.
• which go (where go w Windows) pokazuje dokładnie, którą binarkę uruchamia twoja powłoka. Używaj go zawsze, gdy go version zgłasza nieoczekiwaną wersję.

Uruchom pierwszy program

Twój kod może leżeć w dowolnym katalogu. Utwórz folder, zainicjuj moduł i napisz plik:

mkdir hello
cd hello
go mod init example.com/hello

go: creating new go.mod: module example.com/hello

Zapisz to jako main.go w tym folderze:

package main

import "fmt"

func main() {
	fmt.Println("Go is installed and working.")
}

Potem uruchom:

go run .

Go is installed and working.

go run . kompiluje pakiet w bieżącym katalogu i go uruchamia. Strona o hello world wyjaśnia każdą linię programu, a krok go mod init opisuje strona o modułach Go.

Dodanie GOPATH/bin do PATH

Narzędzia instalowane przez go install trafiają do $HOME/go/bin, którego domyślnie nie ma w PATH. Jeśli zainstalujesz narzędzie, a powłoka mówi, że go nie znajduje, dodaj też ten katalog:

go install golang.org/x/tools/cmd/goimports@latest
export PATH=$PATH:$(go env GOPATH)/bin
goimports -h

Umieść linię export w ~/.profile albo ~/.zshrc, żeby działała w nowych terminalach. W Windows instalator już dodaje %USERPROFILE%\go\bin do PATH użytkownika.

Aktualizowanie Go

Aby zaktualizować Go, zainstaluj nowe wydanie tak samo jak poprzednie. Na Linux oznacza to powtórzenie kroków rm -rf /usr/local/go i tar; nie pomijaj usuwania.

Od Go 1.21 polecenie go potrafi też pobrać nowszy toolchain na żądanie. Jeśli go.mod modułu zawiera go 1.24, a masz zainstalowane Go 1.22, go build pobierze Go 1.24 do cache modułów i go użyje, o ile GOTOOLCHAIN ma domyślną wartość auto. Zainstalowane Go zostaje takie samo; tylko ten moduł buduje się nowszym wydaniem.

Aby zachować starszą wersję do testów, zainstaluj ją obok:

go install golang.org/dl/go1.23.4@latest
go1.23.4 download
go1.23.4 version

Częste błędy instalacji

go: command not found albo zsh: command not found: go. Powłoka nie znajduje binarki. Na Linux sprawdź, czy /usr/local/go/bin jest w linii export PATH w pliku, który twoja powłoka faktycznie czyta (~/.zshrc dla zsh, ~/.profile albo ~/.bashrc dla bash), a potem otwórz nowy terminal. Uruchom echo $PATH, żeby zobaczyć, co ma powłoka.

'go' is not recognized as an internal or external command (Windows). Zamknij i ponownie otwórz terminal. Jeśli problem nie znika, otwórz „Edytuj zmienne środowiskowe systemu”, kliknij Zmienne środowiskowe i upewnij się, że C:\Program Files\Go\bin jest w Path. Wbudowany terminal VS Code dziedziczy środowisko z chwili uruchomienia VS Code, więc uruchom ponownie również VS Code.

go version pokazuje starą wersję po aktualizacji. W PATH są dwie instalacje. Uruchom which -a go (albo where go w Windows) i usuń tę niechcianą, często pakiet apt w /usr/bin/go, który przesłania /usr/local/go/bin/go.

go: go.mod file not found in current directory or any parent directory. Go jest zainstalowane poprawnie; po prostu go build albo go run . zostało uruchomione poza modułem. Najpierw uruchom go mod init example.com/yourname w folderze projektu.

Dziwne błędy kompilacji w bibliotece standardowej po aktualizacji na Linux. Nowe archiwum zostało rozpakowane na starym drzewie. Usuń całkowicie /usr/local/go i rozpakuj ponownie.

Permission denied przy rozpakowywaniu. Właścicielem /usr/local jest root, więc polecenia rm i tar wymagają sudo. Twój własny kod nigdy nie potrzebuje sudo.

Konfiguracja edytora

Zadziała każdy edytor, ale zainstaluj obsługę Go, żeby mieć podpowiadanie, podświetlanie błędów i formatowanie przy zapisie. W VS Code zainstaluj oficjalne rozszerzenie Go (wydawane przez zespół Go w Google); przy pierwszym otwarciu pliku .go zaproponuje instalację gopls, serwera języka Go. GoLand od JetBrains to główna opcja komercyjna. Vim i Neovim używają gopls przez swoich klientów LSP.