Глиф Учебники

Как установить Go

Справочник · Go · 3 минуты чтения

Go скачивают с официального сайта — со страницы загрузки go.dev. Берите последнюю стабильную версию для своей системы: курс рассчитан на Go 1.22 и новее. После установки в новом окне терминала должна работать команда:

Bash
go version

Она печатает номер версии и систему, например go version go1.22.5 windows/amd64.

Установка по шагам

Шаги зависят от системы — выберите свою.

Windowsустановщик .msi

  1. Скачайте файл go….windows-amd64.msi (для компьютеров с процессором ARM — windows-arm64).
  2. Запустите его и пройдите шаги установщика, ничего не меняя. Go встанет в папку Program Files, а установщик сам пропишет нужную папку в переменную PATH.
  3. Закройте все открытые окна командной строки, PowerShell и VS Code и откройте заново: старые окна изменений PATH не видят.
  4. Проверьте: go version.

Дальше: «Папка для программ, которые ставит go install»

macOSустановщик .pkg

  1. Скачайте файл .pkg: darwin-arm64 — для Mac на процессорах Apple (M1 и новее), darwin-amd64 — для Mac с процессором Intel.
  2. Запустите и пройдите шаги. Go встанет в /usr/local/go, а путь /usr/local/go/bin пропишется в PATH сам.
  3. Откройте новое окно терминала и проверьте: go version.

Дальше: «Папка для программ, которые ставит go install»

Linuxархив с go.dev или репозиторий

Архивом с go.dev

Скачайте архив go….linux-amd64.tar.gz (для Raspberry Pi и других ARM-компьютеров с 64-битной системой — linux-arm64). В папке с архивом выполните:

Bash
sudo rm -rf /usr/local/go
sudo tar -C /usr/local -xzf go1.22.5.linux-amd64.tar.gz
echo 'export PATH=$PATH:/usr/local/go/bin' >> ~/.profile
source ~/.profile
go version

Имя архива подставьте своё — по скачанной версии.

sudo rm -rf /usr/local/go удаляет папку без вопросов и без корзины. Проверьте путь до буквы: лишний пробел (/usr /local/go) удалит совсем другое. Удалять старую папку нужно обязательно: распаковка поверх старой версии, по предупреждению разработчиков Go, ломает установку.

Строка export в ~/.profile добавляет папку с командой go в PATH при каждом входе в систему, а source применяет её сразу, без перезахода. Добавлять её нужно один раз.

Из репозитория

В Ubuntu и Debian Go есть и в репозитории:

Bash
sudo apt update
sudo apt install golang-go
go version

Так проще, но версия в репозитории часто отстаёт от свежей. Если go version показывает версию ниже 1.22, часть примеров курса не заработает — поставьте Go архивом с go.dev, как описано выше.

Папка для программ, которые ставит go install

Утилиты, поставленные командой go install, попадают в папку go/bin в домашней папке ($HOME/go/bin, в Windows — %USERPROFILE%\go\bin). Чтобы они запускались по имени, в Linux добавьте и её в PATH:

Bash
echo 'export PATH="$PATH:$(go env GOPATH)/bin"' >> ~/.profile

В macOS ту же строку дописывают в файл ~/.zshrc (оболочка по умолчанию — zsh, файл ~/.profile она не читает). Изменения подхватятся в новом окне терминала.

Где Go хранит свои файлы, показывает go env: GOROOT — сам Go, GOPATH — скачанные пакеты и утилиты.

Обновление и удаление

Если не работает