Какими должны быть значения GOPATH и GOROOT в Go? Правильная настройка окружения

Краткий ответ: что такое GOROOT и GOPATH

GOROOT — это путь к директории, куда установлен компилятор Go и стандартная библиотека. Обычно эту переменную не нужно задавать вручную: Go сам определяет её при установке. Если вы установили Go стандартным способом (через официальный инсталлятор, пакетный менеджер или скачав бинарник), GOROOT уже прописан внутри исполняемого файла go. Проверить можно командой:

go env GOROOT

На Windows это обычно C:\Go, на Linux/macOS — /usr/local/go или /usr/lib/go. Если команда возвращает пустую строку или неверный путь — тогда нужно задать GOROOT вручную, указав папку, где лежат bin/go, src и pkg.

GOPATH — рабочее пространство

GOPATH — это корневая директория вашего Go-окружения, где хранятся:

• src/ — исходный код ваших проектов и сторонних пакетов
• pkg/ — скомпилированные объектные файлы (.a)
• bin/ — скомпилированные исполняемые файлы

По умолчанию (если GOPATH не задан) Go использует $HOME/go на Linux/macOS или %USERPROFILE%\go на Windows. Это нормальное рабочее значение. Вы можете оставить его как есть, и все ваши проекты будут лежать внутри ~/go/src.

Как правильно организовать проекты (режим модулей)

Начиная с Go 1.11, появилась поддержка модулей (go modules). Это современный и рекомендуемый способ работы, который избавляет от жёсткой привязки к GOPATH. Теперь вы можете хранить проекты в любом месте на диске. Для этого достаточно выполнить в корне проекта:

go mod init имя_модуля

Пример для вашего кода:

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

После этого в папке появится файл go.mod, и Go будет знать, что это корень модуля. Теперь вы можете спокойно запускать go run main.go из любой папки, а go get будет работать без ошибок. При этом GOPATH всё ещё используется для хранения кэша скачанных зависимостей (они попадают в $GOPATH/pkg/mod), но вам не нужно вручную создавать структуру src.

Пошаговая настройка для начинающего

1. Проверьте GOROOT: выполните go env GOROOT. Если путь корректен — ничего не меняйте.
2. Установите GOPATH (если хотите явно): например, export GOPATH=$HOME/go (Linux/macOS) или set GOPATH=C:\Users\ВашеИмя\go (Windows cmd). Можно оставить по умолчанию.
3. Добавьте $GOPATH/bin в PATH — это позволит запускать установленные через go install утилиты из любого места.
4. Для каждого нового проекта используйте модули: go mod init.
5. Устанавливайте пакеты через go get example.com/package — они автоматически попадут в кэш модулей, не засоряя ваш исходный код.

Пример рабочего процесса

# Создаём проект в любом месте
mkdir ~/projects/hello
cd ~/projects/hello
go mod init hello

# Создаём main.go с вашим кодом
cat > main.go <<EOF
package main

import "fmt"

func main() {
    fmt.Println("Hello, Go!")
}
EOF

# Запускаем
go run main.go

# Устанавливаем сторонний пакет
go get github.com/gin-gonic/gin
# go.mod и go.sum обновятся автоматически

Таким образом, вам не нужно вручную задавать GOROOT (кроме редких случаев), а GOPATH можно оставить по умолчанию. Главное — используйте модули (go mod init) для каждого проекта, и вы забудете о проблемах с путями.

$GOPATH/
├── bin/
├── pkg/
└── src/
    ├── github.com/
    │   └── user/
    │       └── myproject/
    │           └── main.go
    └── myapp/
        └── main.go