先生と生徒の会話形式で理解しよう

生徒

「先生、Goで作ったプログラムの依存関係を管理したいんですけど、どうすればいいですか？」

先生

「それなら、go.modファイルを理解することが大切です。Goではgo.modが依存関係やモジュール情報を管理する中心的なファイルです。」

生徒

「go.modって具体的にどんな内容が書かれているんですか？」

先生

「基本的にはモジュール名、Goのバージョン、そして依存するパッケージの情報が書かれています。」

生徒

「どうやって作ればいいですか？」

先生

「新しいプロジェクトディレクトリでgo mod init モジュール名を実行すると自動で作成されます。」

1. go.modファイルの役割

go.modは、Goのモジュールを定義し、プロジェクト内で使用するパッケージのバージョンを管理するファイルです。簡単に言うと、プログラムの部品表のようなものです。これにより、複数の開発者が同じバージョンのライブラリを使って開発でき、ビルドや配布が安定します。

2. go.modファイルの基本構造

go.modファイルはテキストファイルで、基本的な書き方はとてもシンプルです。


module github.com/username/myproject

go 1.20

上記の例では、moduleでモジュール名を指定し、goで使用するGoのバージョンを示しています。

依存パッケージを追加すると、requireでバージョン情報が記載されます。


require (
    github.com/gin-gonic/gin v1.9.0
    github.com/sirupsen/logrus v1.10.0
)

このように書くことで、プロジェクトが必要とするライブラリとそのバージョンを明確に管理できます。

不要な依存関係が残っている場合は、go mod tidyを使って整理します。


go mod tidy

これにより、go.modとgo.sumが最新の状態になり、不要なライブラリ情報が削除されます。

go.sumは、依存パッケージのチェックサム（安全性を確認するためのデジタル署名のようなもの）を記録するファイルです。go.modと一緒に管理されることで、誰がビルドしても同じ結果になるよう保証されます。

新しいプロジェクトでgo mod initを実行し、必要なパッケージをgo getで追加、不要な依存はgo mod tidyで整理。これが基本の流れです。初心者でもこの手順を覚えれば、依存管理で迷うことはなくなります。


mkdir myproject
cd myproject
go mod init github.com/username/myproject
go get github.com/gin-gonic/gin
go mod tidy

この流れを理解すれば、Goプロジェクトの依存関係管理は簡単に行えます。