Golang Kurulumu: Windows, macOS ve Linux Adım Adım

Go'yu go.dev/dl adresinden indirin, sisteminize uygun yükleyiciyi çalıştırın, yeni bir terminal açın ve go version çalıştırın. Windows ve macOS'ta kurulumun tamamı budur. Linux'ta bir tarball açar ve PATH'e bir dizin eklersiniz. Aşağıdaki bölümler her sistemi, ardından kontrolleri ve insanların gerçekten karşılaştığı hataları ele alıyor.

Denemek için Go'yu kurmanız gerekmez. Bu program tarayıcınızda, sitenin kullandığı Go sürümüyle çalışır ve neyin üzerinde çalıştığını raporlar:

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())
}

Go yerel olarak kurulduğunda aynı program kendi makinenizin bilgilerini yazdırır.

Hangi Dosyayı İndirmeli

İndirme sayfası her işletim sistemi ve CPU mimarisi için bir dosya listeler:

Bu örneklerdeki sürüm numarası 1.24.5. En yeni kararlı sürüm hangisiyse onu alın; adımlar sürümden sürüme değişmez.

Go'yu Windows'a Kurmak

1. .msi dosyasını indirip çalıştırın.
2. Varsayılanları kabul edin. Go, C:\Program Files\Go içine kurulur ve yükleyici C:\Program Files\Go\bin dizinini PATH'e ekler.
3. Açık tüm Komut İstemi ve PowerShell pencerelerini kapatıp yeni bir tane açın. Kurulum sırasında açık olan terminaller hâlâ eski PATH'e sahiptir.
4. Kurulumu kontrol edin:

go version

go version go1.24.5 windows/amd64

Bir paket yöneticisi tercih ediyorsanız winget de çalışır:

winget install GoLang.Go

Go'yu macOS'a Kurmak

Resmi paketle

Çipinize uygun .pkg dosyasını indirip açın. Go'yu /usr/local/go içine kurar ve /etc/paths.d/go dosyası aracılığıyla /usr/local/go/bin dizinini PATH'e ekler. Yeni bir Terminal penceresi açın, ardından:

go version

go version go1.24.5 darwin/arm64

Homebrew ile

brew install go
go version

Homebrew, Go'yu kendi önekinin altına koyar (Apple Silicon'da /opt/homebrew) ve go'yu zaten PATH üzerinde olan bir dizine bağlar. Daha sonra brew upgrade go ile güncelleyin.

Bir yöntem seçin. Hem .pkg hem de Homebrew kurulumuna sahip olmak PATH üzerinde iki go binary'si demektir ve hangisi önce gelirse o kazanır. which go kabuğunuzun hangisini kullandığını söyler.

Go'yu Linux ve Ubuntu'ya Kurmak

Resmi yöntem her dağıtımda çalışır. Önce varsa önceki kurulumu kaldırın, çünkü eski bir ağacın üzerine açmak iki sürümün dosyalarını karıştırır ve araç zincirini bozar:

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

Ardından Go'yu PATH'e ekleyin. Bu satırı ~/.profile (bash) ya da ~/.zshrc (zsh) dosyasının sonuna ekleyin:

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

Mevcut kabuğa yükleyin ve kontrol edin:

source ~/.profile
go version

go version go1.24.5 linux/amd64

Ubuntu paketleri: apt ve snap

Ubuntu, farklı ödünleşimleri olan iki kısayol sunar:

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

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

apt sürümü göründüğünden daha önemlidir. Modüller go.mod içinde minimum bir Go sürümü bildirir. Go 1.21'den itibaren go 1.23 diyen bir modül, Go sizin için daha yeni bir sürüm indiremediği sürece eski bir araç zinciriyle derlenmez; 1.21'den eski araç zincirleri ise yine de derlemeyi dener ve karşılaştıkları ilk yeni özellikte başarısız olur (aşağıdaki "Go'yu güncel tutmak" bölümüne bakın). apt'tan kurduysanız go version çalıştırıp go.dev/dl ile karşılaştırın.

Kurulumu Kontrol Etmek

Üç komut çalışan bir kurulumu doğrular:

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, Go'nun kendisinin kurulu olduğu yerdir. Kendi kodunuzu asla oraya koymayın; bunu ayarlamanız da gerekmez.
• GOPATH varsayılan olarak $HOME/go olur (Windows'ta %USERPROFILE%\go). Go indirilen modülleri $GOPATH/pkg/mod içinde saklar ve go install ile derlenen programları $GOPATH/bin içine koyar.
• which go (Windows'ta where go), kabuğunuzun çalıştırdığı binary'yi tam olarak gösterir. go version beklemediğiniz bir sürüm raporladığında bunu kullanın.

İlk Programınızı Çalıştırın

Kodunuz herhangi bir dizinde durabilir. Bir klasör oluşturun, bir modül başlatın ve bir dosya yazın:

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

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

Şunu o klasöre main.go olarak kaydedin:

package main

import "fmt"

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

Sonra çalıştırın:

go run .

Go is installed and working.

go run . mevcut dizindeki paketi derler ve çalıştırır. Hello world sayfası programın her satırını açıklıyor, go mod init adımı ise Go modules sayfasında anlatılıyor.

GOPATH/bin'i PATH'e Eklemek

go install ile kurulan araçlar $HOME/go/bin içine gider ve bu dizin varsayılan olarak PATH üzerinde değildir. Bir araç kurduğunuzda kabuk onu bulamadığını söylüyorsa bu dizini de ekleyin:

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

export satırını ~/.profile ya da ~/.zshrc içine koyun ki yeni terminallerde de kalsın. Windows'ta yükleyici %USERPROFILE%\go\bin dizinini kullanıcı PATH'inize zaten ekler.

Go'yu Güncel Tutmak

Güncellemek için yeni sürümü eskisini kurduğunuz şekilde kurun. Linux'ta bu, rm -rf /usr/local/go ve tar adımlarını tekrarlamak demektir; silme adımını atlamayın.

Go 1.21'den beri go komutu gerektiğinde daha yeni bir araç zincirini de indirebilir. Bir modülün go.mod dosyası go 1.24 diyorsa ve sizde Go 1.22 kuruluysa, go build çalıştırmak Go 1.24'ü modül önbelleğine indirir ve onu kullanır; tabii GOTOOLCHAIN varsayılan değeri olan auto'da bırakıldıysa. Kurulu Go'nuz aynı kalır; yalnızca o modül daha yeni sürümle derlenir.

Test için eski bir sürümü de tutmak isterseniz yan yana kurun:

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

Sık Görülen Kurulum Hataları

go: command not found ya da zsh: command not found: go. Kabuk binary'yi bulamıyor. Linux'ta, kabuğunuzun gerçekten okuduğu dosyadaki (zsh için ~/.zshrc, bash için ~/.profile ya da ~/.bashrc) export PATH satırında /usr/local/go/bin olduğunu kontrol edin, sonra yeni bir terminal açın. Kabuğun elinde ne olduğunu görmek için echo $PATH çalıştırın.

'go' is not recognized as an internal or external command (Windows). Terminali kapatıp yeniden açın. Devam ederse "Sistem ortam değişkenlerini düzenle"yi açın, Ortam Değişkenleri'ne tıklayın ve C:\Program Files\Go\bin dizininin Path içinde olduğundan emin olun. VS Code'un yerleşik terminali VS Code'un başladığı ortamı devralır, bu yüzden VS Code'u da yeniden başlatın.

Güncellemeden sonra go version eski sürümü gösteriyor. PATH üzerinde iki kurulum var. which -a go (Windows'ta where go) çalıştırın ve istemediğinizi kaldırın; çoğu zaman bu, /usr/local/go/bin/go'yu gölgeleyen /usr/bin/go konumundaki bir apt paketidir.

go: go.mod file not found in current directory or any parent directory. Go doğru kurulmuş; siz go build ya da go run . komutunu bir modülün dışında çalıştırdınız. Önce proje klasöründe go mod init example.com/yourname çalıştırın.

Linux'ta güncellemeden sonra standart kütüphanede tuhaf derleme hataları. Yeni tarball eski ağacın üzerine açılmış. /usr/local/go dizinini tamamen silin ve yeniden açın.

Açarken permission denied. /usr/local root'a aittir, bu yüzden rm ve tar komutları sudo ister. Kendi kodunuz hiçbir zaman sudo gerektirmez.

Editör Kurulumu

Her editör işinizi görür, ama tamamlama, hata vurgulama ve kaydederken biçimlendirme için Go desteğini kurun. VS Code'da resmi Go eklentisini kurun (Google'daki Go ekibi yayımlar); bir .go dosyasını ilk açtığınızda Go dil sunucusu gopls'i kurmayı önerir. JetBrains'in GoLand'i başlıca ticari seçenektir. Vim ve Neovim, gopls'i LSP istemcileri üzerinden kullanır.