Go言語のビルドの基本！go buildコマンドの使い方を初心者向けに解説
生徒
「先生、Go言語のプログラムを作ったんですけど、これってどうやって実行すればいいんですか？」
先生
「Goでは、go buildというコマンドを使うと、プログラムを実行可能なファイルに変換することができます。」
生徒
「実行可能なファイルって、例えばWindowsなら.exeファイルみたいなものですか？」
先生
「その通りです。Goではソースコードから直接コンピュータが理解できるファイルに変換する作業をビルドと言います。」
生徒
「じゃあ、go buildを使うだけでプログラムが動くんですか？」
先生
「基本はそうですが、いくつか知っておくと便利なポイントがあります。順番に見ていきましょう。」
1. go buildとは何か？
Go言語のgo buildコマンドは、ソースコードをコンパイルして実行ファイルを生成するためのコマンドです。例えば、main.goというファイルがあるとします。このファイルをそのままでは実行できません。go buildを使うことで、Windowsならmain.exe、MacやLinuxならmainというファイルが生成され、ダブルクリックやターミナルで実行できるようになります。
2. 基本的な使い方
まずは基本的な使い方から見てみましょう。ターミナルやコマンドプロンプトで、ソースコードがあるディレクトリに移動して以下のコマンドを入力します。
go build main.go
このコマンドを実行すると、同じディレクトリに実行ファイルが生成されます。Windowsならmain.exe、MacやLinuxならmainです。
3. 実行ファイルの名前を指定する
デフォルトではソースコードの名前が実行ファイル名になりますが、-oオプションを使うと任意の名前で実行ファイルを作れます。
go build -o myprogram main.go
この場合、myprogramという名前の実行ファイルが生成されます。名前を自由に付けられるので、複数のプログラムを管理するときに便利です。
4. ディレクトリ単位でビルドする
Goでは1つのファイルだけでなく、ディレクトリ全体をビルドすることもできます。ディレクトリにmain.goが含まれていれば、ディレクトリ名を指定してビルド可能です。
go build ./myapp
この場合、myappディレクトリ内のmain.goをビルドして実行ファイルが生成されます。
5. 実行結果の確認方法
生成された実行ファイルはターミナルやコマンドプロンプトから実行できます。
./myprogram
Windowsの場合は
myprogram.exe
と入力して実行します。これで、Go言語のプログラムが実際に動くことを確認できます。
6. go buildとgo runの違い
Go言語にはgo runというコマンドもあります。これはビルドしてすぐに実行する便利なコマンドです。
go run main.go
違いは、go buildは実行ファイルを生成するのに対して、go runは一時的にビルドしてその場で実行するだけです。開発中のテストにはgo run、配布用にはgo buildを使うのが一般的です。
7. 複数ファイルのビルド
Go言語では、複数のソースコードファイルをまとめてビルドすることも可能です。
go build main.go utils.go
この場合、main.goとutils.goをまとめてビルドし、1つの実行ファイルが生成されます。複雑なプロジェクトでも、この方法で効率よくビルドできます。
8. ビルド時の依存関係管理
Goではgo.modというファイルを使って、外部パッケージの依存関係を管理します。ビルド前に
go mod tidy
を実行すると、必要な外部パッケージが自動でダウンロードされ、ビルドに必要な環境が整います。これにより、複数のライブラリを使ったプロジェクトでもスムーズにビルドできます。
9. クロスコンパイルで他のOS向けにビルド
Goの大きな特徴の一つにクロスコンパイルがあります。例えば、MacでWindows用の実行ファイルを作ることも可能です。
SET GOOS=windows
SET GOARCH=amd64
go build -o myprogram.exe main.go
このように環境変数を設定するだけで、異なるOSやCPUアーキテクチャ向けの実行ファイルを生成できます。
10. よくあるエラーと対処法
ビルド時に「packageが見つからない」と表示されることがあります。これは依存パッケージがダウンロードされていない場合に起こります。
go get github.com/user/package
このコマンドで必要なパッケージをインストールすれば解決します。また、go mod tidyを使って依存関係を整理するのもおすすめです。
11. まとめのポイント
ここまでで、Go言語のビルドの基本、go buildの使い方、オプション、複数ファイルや依存関係の管理、クロスコンパイルについて学びました。初心者でもこの手順を理解すれば、基本的なGoプログラムを自分の環境でビルドして実行できるようになります。
