Функция, объявленная в другом файле, не видна — ошибка "undefined" в Go

Почему возникает ошибка "undefined"

Проблема в том, что команда go run main.go запускает только один файл — main.go. Go компилирует и выполняет только те файлы, которые явно переданы в команду. Если вы не указали helper.go, компилятор о нём не знает, и функция hello() остаётся неопределённой.

Как правильно запускать многофайловые проекты

Есть два основных способа:

• Передать все файлы явно:
  go run main.go helper.go
• Использовать пакетный запуск (рекомендуется):
  go run . — запускает все файлы в текущей папке с пакетом main.
  go run ./... — рекурсивно запускает все подпакеты.

Правильная структура проекта

В Go принято организовывать код так:

myproject/
├── go.mod          # модульный файл (обязателен с Go 1.16+)
├── main.go         # точка входа
├── helper.go       # дополнительные функции
└── other/
    └── extra.go    # другой пакет

Создайте модуль (один раз):

go mod init myproject

Теперь можно запускать:

go run .

Важные правила для файлов в одном пакете

• Все файлы должны иметь одинаковое объявление package (например, package main).
• Функции, переменные, типы, объявленные в любом файле пакета, доступны во всех файлах этого пакета без импорта.
• Имена файлов не имеют значения — важна только принадлежность к пакету и то, что все файлы участвуют в компиляции.

Пример рабочего запуска

main.go:

package main

import "fmt"

func main() {
    fmt.Println(helperMessage())
}

helper.go:

package main

func helperMessage() string {
    return "Hello from helper!"
}

Запуск:

go run .
# Вывод: Hello from helper!

Частая ошибка: main в отдельной папке

Если вы используете модуль и хотите, чтобы main.go был точкой входа, поместите его в папку cmd/:

myproject/
├── go.mod
├── cmd/
│   └── myapp/
│       ├── main.go
│       └── helper.go
└── pkg/
    └── mylib/
        └── lib.go

Запуск:

go run ./cmd/myapp/

В этом случае helper.go должен находиться в той же папке, что и main.go (оба с package main).

go build -o myapp .
./myapp

go vet ./...