【環境構築】Goの開発環境

Go でプログラムを書いて実行するための環境構築手順を説明します。Go は公式サイトからインストーラをダウンロードするだけで、すぐに開発を始められます。

インストール

go.dev からお使いの OS に合ったインストーラをダウンロードします。
インストーラを実行し、画面の指示に従ってインストールします。
ターミナル（またはコマンドプロンプト）で以下を実行して、インストールを確認します。

go version

バージョン情報が表示されれば、インストールは完了です。

macOS の場合は Homebrew でもインストールできます。

brew install go

GOPATH とモジュールモード

以前の Go では『GOPATH』というディレクトリの下にすべてのソースコードを置く必要がありました。現在はモジュールモードが標準になっており、好きな場所でプロジェクトを作成できます。

『GOPATH』はダウンロードしたパッケージの保存先として引き続き使われますが、開発時に意識する必要はほとんどありません。

プロジェクトの作成と実行

1. プロジェクトを初期化します

mkdir hello
cd hello
go mod init hello

『go mod init』はモジュール（プロジェクト）を初期化するコマンドです。『go.mod』ファイルが作成されます。

2. ソースファイルを作成します

テキストエディタで『main.go』というファイルを作成し、以下の内容を書きます。

package main

import "fmt"

func main() {
    fmt.Println("Hello, World!")
    fmt.Println("Go の環境構築が完了しました。")
}

3. 実行します

go run main.go

『Hello, World!』と『Go の環境構築が完了しました。』が表示されれば成功です。

ビルド（コンパイル）

『go build』を使うと、実行ファイルを生成できます。

go build -o hello
./hello

Go はクロスコンパイルにも対応しています。以下のように環境変数を指定すると、別の OS 向けの実行ファイルを生成できます。

Windows 向けの実行ファイルを macOS/Linux で生成する例:

GOOS=windows GOARCH=amd64 go build -o hello.exe

よく使う go コマンド

コマンド	説明
go run ファイル名.go	コンパイルと実行を一度に行います。
go build	実行ファイルを生成します。
go mod init	新しいモジュール（プロジェクト）を初期化します。
go mod tidy	不要な依存を削除し、必要な依存を追加します。
go fmt	コードを Go 標準のスタイルにフォーマットします。
go test	テストを実行します。

コマンドが見つからないとき

ターミナルで『go: command not found』と表示される場合は、PATH（パス）が通っていない可能性があります。以下の手順で確認・設定してください。

1. コマンドの場所を探します

コマンドの場所を確認します。

which go

見つからない場合、よくあるインストール先を確認します。

ls /usr/local/go/bin/go
ls /opt/homebrew/bin/go

2. 使用しているシェルを確認します

echo $SHELL

『/bin/zsh』と表示されたら『~/.zshrc』、『/bin/bash』と表示されたら『~/.bashrc』に設定を書きます。

3. PATH に追加します

コマンドの場所がわかったら、シェルの設定ファイルに PATH を追加します。

macOS (zsh) の場合:

echo 'export PATH="/usr/local/go/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Linux (bash) の場合:

echo 'export PATH="/usr/local/go/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

GOPATH と GOROOT について

Go には 2 つの重要な環境変数があります。通常は自動で設定されますが、問題がある場合は確認してみてください。

環境変数	説明	デフォルト値
GOROOT	Go 本体のインストール先です。	/usr/local/go
GOPATH	ダウンロードしたパッケージや『go install』した実行ファイルの保存先です。	~/go

現在の設定を確認します。

go env GOROOT
go env GOPATH

『go install』で入れたコマンドを使うには、GOPATH/bin も PATH に追加します。