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

生徒

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

先生

「それならgo mod initを使って、まずモジュールを作成することから始めましょう。」

生徒

「モジュールって何ですか？」

先生

「モジュールとは、Goで作られたプログラムの部品のようなもので、他のパッケージやライブラリをまとめて管理できます。」

生徒

「なるほど、ではgo mod initで何ができるんですか？」

先生

「go mod initを実行すると、現在のプロジェクト用にgo.modというファイルが作られ、モジュール名と依存関係を管理できるようになります。」

1. go mod initの基本的な使い方

まず、新しいプロジェクト用のディレクトリを作り、そこに移動します。


mkdir myproject
cd myproject

次にgo mod initを使ってモジュールを初期化します。モジュール名は一般的にGitHubなどのリポジトリURLを指定します。


go mod init github.com/username/myproject

実行すると、go.modファイルが作成され、プロジェクトの基本情報が書かれています。

2. go.modファイルの内容を理解する

作成されたgo.modファイルには、モジュール名とGoのバージョンが記載されています。


module github.com/username/myproject

go 1.20

ここに依存するライブラリが追加されると、自動的に管理されます。

新しいパッケージを使いたい場合、go getコマンドでインストールします。するとgo.modにその情報が追加されます。


go get github.com/gin-gonic/gin

これでWebフレームワークGinをプロジェクトで使えるようになり、依存関係も自動で管理されます。

不要な依存関係が残ることがあります。そんなときはgo mod tidyを実行します。


go mod tidy

これにより、go.modとgo.sumが整理され、必要な依存関係だけが残ります。

Goモジュールを使うことで、プロジェクトの依存関係を簡単に管理でき、チーム開発や公開用パッケージ作成時に非常に便利です。また、環境に依存せず、再現性の高いビルドが可能になります。

Go 1.11以降では、モジュール管理が標準になったため、今後のプロジェクト開発ではgo mod initの理解が必須と言えます。

プロジェクト作成 → go mod initでモジュール初期化 → 必要なパッケージをgo getで追加 → go mod tidyで整理。これが基本の流れです。初心者でもこの手順を覚えれば、依存管理に困ることはありません。