Как пакеты и модули организуют код в Go?

Question

Accepted Answer

Go организует код с помощью **пакетов** (коллекций исходных файлов в директории) и **модулей** (коллекций пакетов с версионированными зависимостями). Вместе они структурируют проекты и управляют зависимостями.

## Пакеты — директория связанного кода

```go
// every .go file starts by declaring its package
package main         // "main" is special — produces an executable

// or a library package (named after its directory, conventionally)
package mathutil

func Add(a, b int) int { return a + b }   // Exported (capitalized) — usable outside
func helper() {}                           // unexported (lowercase) — package-private
```

Все файлы в одной директории принадлежат одному пакету. **Заглавные буквы контролируют видимость**: имена с заглавной буквы экспортируются (открыты для других пакетов), строчные буквы — приватны для пакета.

## Импорт и использование пакетов

```go
import (
    "fmt"                          // standard library
    "strings"
    "github.com/user/repo/mathutil" // a third-party or local module package
)

fmt.Println(strings.ToUpper("hi"))
mathutil.Add(2, 3)                  // use Exported names via package.Name
```

## Модули — управление версионированными зависимостями

```bash
go mod init github.com/user/myapp   # create a module → makes go.mod
go get github.com/gin-gonic/gin     # add a dependency (records it in go.mod)
go mod tidy                          # add missing & remove unused dependencies
go build                             # build using the module's dependencies
```

```text
go.mod  — declares the module path, Go version, and direct dependencies (+ versions)
go.sum  — cryptographic checksums of dependencies (integrity/security)
```

**Модуль** (введён в Go 1.11) — это единица управления зависимостями — `go.mod` перечисляет точные версии зависимостей, что делает сборки воспроизводимыми. `go.sum` проверяет целостность зависимостей.

## Функция init и main

```go
package main

func init() {    // runs automatically when the package loads (before main)
    // setup
}
func main() {    // entry point of an executable (package main only)
}
```

## Конвенции структуры проекта

```text
myapp/
  go.mod
  main.go              package main
  internal/            packages here are PRIVATE to this module (can't be imported externally)
  pkg/ or other dirs/  reusable packages
```

Директория `internal/` — специальная — её пакеты могут импортироваться только внутри одного модуля, обеспечивая инкапсуляцию на уровне модуля.

## Почему это важно

Пакеты и модули — это то, как структурируются проекты Go и как управляются зависимости — необходимо для любого реального проекта.

Понимание пакетов (директория файлов, видимость экспортируемых/неэкспортируемых элементов на основе заглавных букв, специальный пакет `main`) — основополагающе для организации кода и контроля его публичного API.

Модули (`go mod`, `go.mod`/`go.sum`) обеспечивают воспроизводимое, версионированное, проверяемое по целостности управление зависимостями — современный стандарт, заменивший старый подход GOPATH.

Знание системы импорта, конвенции `internal/` для приватного кода модуля и инструментария (`go mod init/tidy`, `go get`) необходимо для разработки, совместного использования и поддержки проектов Go, и отражает практическое владение экосистемой Go.