Как импортировать локальные пакеты в Go без GOPATH (модули Go)

Question

alex_dev37 · 09.05.2026

Как импортировать локальные пакеты в Go без GOPATH (модули Go)

Привет! Я начинаю изучать Go, и у меня возникла проблема с импортом локальных пакетов. Я привык работать с другими языками, где можно просто создать файлы в одной папке и импортировать их. Но в Go всё оказалось сложнее. У меня есть такая структура проекта: ``` myproject/ ├── main.go └── utils/ └── helper.go ``` В `helper.go` я определил функцию `Hello()`: ```go package utils func Hello() string { return "Привет из utils!" } ``` В `main.go` я пытаюсь импортировать этот пакет: ```go package main import ( "fmt" "myproject/utils" ) func main() { fmt.Println(utils.Hello()) } ``` Но когда я запускаю `go run main.go`, получаю ошибку: `package myproject/utils is not in GOROOT (/usr/local/go/src/myproject/utils)`. Я читал, что раньше нужно было настраивать GOPATH, но слышал, что в новых версиях Go есть что-то под названием "модули". Как правильно импортировать локальные пакеты без GOPATH? Объясните, пожалуйста, для новичка, шаг за шагом. <<>>

Решение: используйте Go Modules

Начиная с версии Go 1.11, в языке появилась официальная поддержка модулей (Go Modules). Это современный способ управления зависимостями, который полностью избавляет от необходимости настраивать GOPATH. Вот пошаговая инструкция, как импортировать локальные пакеты.

Шаг 1: Инициализация модуля

Откройте терминал в корневой папке вашего проекта (myproject) и выполните команду:

go mod init myproject

Эта команда создаст файл go.mod со следующим содержимым:

module myproject

go 1.21

myproject — это имя модуля. Оно будет использоваться как корневой путь для всех импортов внутри проекта.

Шаг 2: Структура проекта

Убедитесь, что ваша структура папок выглядит так (папка utils должна быть внутри myproject):

myproject/
├── go.mod
├── main.go
└── utils/
    └── helper.go

Шаг 3: Правильный импорт в main.go

Теперь в main.go импорт должен быть таким:

package main

import (
    "fmt"
    "myproject/utils"
)

func main() {
    fmt.Println(utils.Hello())
}

Обратите внимание: путь к пакету — myproject/utils, где myproject — это имя модуля из go.mod.

Шаг 4: Запуск

Теперь вы можете запустить программу из корня проекта:

go run main.go

Или, если у вас несколько файлов в main-пакете:

go run .

Всё должно работать! Вы увидите вывод: Привет из utils!

Важные моменты:

Имя модуля — это не обязательно имя папки. Вы можете назвать его как угодно, например example.com/myproject. Главное — чтобы пути в импортах соответствовали имени модуля.
Имена пакетов — папка utils должна содержать файлы с package utils. Имя пакета в Go обычно совпадает с именем папки, но это не строгое правило (хотя так рекомендуется).
Вложенные пакеты — если у вас есть utils/helpers/, то импорт будет myproject/utils/helpers.
Экспортируемые имена — функции и переменные, которые вы хотите использовать из другого пакета, должны начинаться с большой буквы (как Hello в вашем примере).

Если что-то пошло не так:

Проверьте, что вы выполнили go mod init в корне проекта.
Убедитесь, что все файлы внутри папки utils имеют package utils.
Попробуйте удалить папку vendor (если есть) и файл go.sum, затем выполните go mod tidy для очистки зависимостей.

Go Modules — это стандарт де-факто в современном Go. Они просты, удобны и решают проблему локальных импортов без GOPATH. Удачи в изучении!

<<>>

Альтернативный подход: относительные импорты с vendor (не рекомендуется)

Хотя Go Modules — правильное решение, некоторые старые проекты используют механизм vendor. Вот как это работает:

Создайте папку vendor в корне проекта.
Скопируйте туда ваши локальные пакеты, сохраняя структуру. Например, vendor/myproject/utils/helper.go.
В main.go импорт будет выглядеть так же: "myproject/utils".
Запустите с флагом -mod=vendor: go run -mod=vendor main.go.

Недостатки этого подхода:

Нужно вручную синхронизировать код в vendor с исходниками.
Это устаревший метод, который не рекомендуется для новых проектов.
Go Modules делает то же самое автоматически и проще.

Совет: Используйте Go Modules. Если вы работаете с проектом, который использует vendor, лучше переведите его на модули — это сэкономит время в будущем.

0 ответов