Go言語のmain関数入門：実行順序やコマンドライン引数、終了ステータスの制御を解説

2026年5月6日2026年5月8日

基本構文・制御構造

Goプログラミングの世界へようこそ。

Go言語（Golang）は、そのシンプルさと高いパフォーマンスから、現代のバックエンド開発やクラウドネイティブなツール開発において中心的な役割を果たしています。

プログラムが起動する際、最初に実行される「入り口」となるのがmain関数です。

Go言語を習得する上で、main関数の役割や仕組みを正しく理解することは、効率的で保守性の高いコードを書くための第一歩です。

この記事では、main関数の基本構造から、実行順序のルール、コマンドライン引数の取り扱い、そしてプログラムの終了ステータスを制御する方法まで、実務で役立つ知識を詳しく解説します。

2026年現在のモダンな開発手法も踏まえ、実践的なテクニックを学んでいきましょう。

目次 [ close ]

Go言語におけるmain関数の基本構造

Go言語のプログラムが実行可能なバイナリとして動作するためには、特定のルールに従ったmain関数が必要です。

スクリプト言語とは異なり、Goではエントリーポイントが厳格に定義されています。

package mainの宣言

まず、main関数が含まれるファイルは、必ずpackage mainというパッケージ宣言で始まらなければなりません。

Goのコンパイラは、このパッケージ宣言を見て「このファイルは実行可能なプログラムである」と認識します。

main関数の定義

main関数は、引数を取らず、戻り値も持たない特別な関数です。

基本的な構文は以下の通りです。

package main

import "fmt"

// main関数はプログラムの開始点です
func main() {
    fmt.Println("Hello, Go World!")
}

このシンプルなコードにおいて、プログラムが起動するとランタイムが自動的にmain()を呼び出します。

ここで注意が必要なのは、main関数が終了すると、他に実行中のゴルーチン（Goroutine）があったとしても、プログラム全体が強制終了するという点です。

プログラムの起動と実行順序

Goプログラムが起動し、main関数に到達するまでには、いくつかの重要なステップが存在します。

これを知っておくことで、変数の初期化タイミングや依存関係によるトラブルを防ぐことができます。

初期化のフロー

プログラムの実行順序は、一般的に以下の流れに従います。

パッケージのインポート: 依存しているパッケージが再帰的に読み込まれます。
パッケージレベルの変数・定数の初期化: グローバル変数の初期化が行われます。
init関数の実行: パッケージごとに定義されたinit()関数が実行されます。
main関数の実行: 最後にmain.main()が呼び出されます。

init関数とmain関数の関係

Goにはinit()という特別な関数があります。

これは、main関数が呼ばれる前に、パッケージの初期設定を行うために使用されます。

一つのパッケージ内に複数のinit()を定義することも可能で、ソースコードに記述された順序で実行されます。

package main

import "fmt"

func init() {
    fmt.Println("初期化処理1を実行します")
}

func init() {
    fmt.Println("初期化処理2を実行します")
}

func main() {
    fmt.Println("メイン処理を開始します")
}

実行結果

初期化処理1を実行します
初期化処理2を実行します
メイン処理を開始します

init関数は開発者が明示的に呼び出すことはできず、引数や戻り値も持てません。

主にデータベースの接続設定や、環境変数の読み込み、設定のバリデーションなどに活用されます。

コマンドライン引数の取得と解析

ツール開発において、実行時にユーザーから入力を受け取る「コマンドライン引数」の処理は欠かせません。

Goでは主に2つの方法で引数を扱います。

os.Argsによる単純な取得

最も基本的な方法は、標準ライブラリのosパッケージを使用することです。

os.Argsは文字列のシライス（[]string）として提供されます。

インデックス	内容
os.Args[0]	実行されたプログラムのパス（名前）
os.Args[1]	最初の引数
os.Args[n]	n番目の引数

package main

import (
    "fmt"
    "os"
)

func main() {
    // 全ての引数を表示
    fmt.Println("全引数:", os.Args)

    // 引数の数を確認
    if len(os.Args) > 1 {
        fmt.Println("最初の引数:", os.Args[1])
    } else {
        fmt.Println("引数が指定されていません")
    }
}

flagパッケージによる高度な解析

オプション（例: -port=8080）を扱う場合は、flagパッケージを使うのが一般的です。

これにより、型安全に値をパースし、デフォルト値やヘルプメッセージを簡単に定義できます。

package main

import (
    "flag"
    "fmt"
)

func main() {
    // フラグの定義
    name := flag.String("name", "Guest", "ユーザー名を指定します")
    age := flag.Int("age", 0, "年齢を指定します")
    isVerbose := flag.Bool("v", false, "詳細ログを出力します")

    // 定義したフラグをパース（必須）
    flag.Parse()

    fmt.Printf("名前: %s, 年齢: %d, 詳細モード: %v\n", *name, *age, *isVerbose)
}

flag.Parse()を呼び出すのを忘れないようにしてください。

これを呼び出すことで、実際の引数が変数に代入されます。

終了ステータスの制御

プログラムが正常に終了したのか、エラーで終了したのかをOSに伝えることは、シェルスクリプトやCI/CDパイプラインとの連携において非常に重要です。

os.Exitの使用

通常、main関数が最後まで実行されると、終了ステータスは0（正常終了）となります。

エラーが発生した際に特定のステータスコードを返したい場合は、os.Exit()を使用します。

package main

import (
    "fmt"
    "os"
)

func main() {
    if err := doSomething(); err != nil {
        fmt.Fprintf(os.Stderr, "エラーが発生しました: %v\n", err)
        // 異常終了として1を返す
        os.Exit(1)
    }
    fmt.Println("正常に完了しました")
}

func doSomething() error {
    // 擬似的なエラー発生
    return fmt.Errorf("ファイルが見つかりません")
}

os.Exitの注意点

os.Exitを呼び出すと、その時点でプログラムが即座に終了します。 そのため、deferで登録した遅延実行処理が呼び出されません。

リソースのクローズ処理などが必要な場合は、関数の設計を工夫する必要があります。

推奨されるパターン：run関数の分離

main関数内で直接ロジックを書かず、run関数などの別関数に切り出すことで、deferを確実に実行させ、かつエラーハンドリングをスマートに行うことができます。

package main

import (
    "fmt"
    "os"
)

func main() {
    // mainはrunの戻り値を受け取って終了ステータスを決めるだけにする
    if err := run(); err != nil {
        fmt.Fprintf(os.Stderr, "Fatal Error: %v\n", err)
        os.Exit(1)
    }
}

func run() error {
    // deferが正しく動作する
    f, err := os.Create("log.txt")
    if err != nil {
        return err
    }
    defer f.Close()

    fmt.Println("処理を実行中...")
    return nil
}

2026年におけるmain関数のベストプラクティス

2026年のモダンなGo開発においては、単に動くだけでなく、運用性やテスト容易性を考慮したmain関数の記述が求められます。

コンテキスト（Context）の活用

サーバー待機系や長時間実行されるバッチ処理では、context.Contextを使用してキャンセル処理やタイムアウトを管理することが標準的です。

package main

import (
    "context"
    "os"
    "os/signal"
    "syscall"
)

func main() {
    // シグナルを検知してキャンセルされるコンテキストを作成
    ctx, stop := signal.NotifyContext(context.Background(), os.Interrupt, syscall.SIGTERM)
    defer stop()

    if err := run(ctx); err != nil {
        os.Exit(1)
    }
}

構造化ロギングの導入

2026年現在、Goの標準ライブラリであるlog/slogを用いた構造化ロギングが主流です。

main関数でロガーの初期設定を行い、アプリケーション全体で一貫した形式のログを出力するように構成します。

package main

import (
    "log/slog"
    "os"
)

func main() {
    // JSON形式でログを出力する設定
    logger := slog.New(slog.NewJSONHandler(os.Stdout, nil))
    slog.SetDefault(logger)

    slog.Info("アプリケーションを起動しました", "pid", os.Getpid())
}

main関数におけるエラーハンドリングの考え方

Goの哲学は「エラーを値として扱う」ことです。

これはmain関数でも変わりません。

しかし、main関数は「最後の防衛線」であるため、以下の3点を意識して実装しましょう。

ログ出力の場所を限定する: 各関数内でバラバラにログを出すのではなく、最終的なエラーメッセージはmain（またはrun）関数で一括して出力すると、ログの重複を防げます。
標準エラー出力（stderr）を活用する: 正常なデータ出力とエラーメッセージを混同させないため、エラーはos.Stderrに書き込みます。
スタックトレースの検討: 複雑なアプリケーションでは、エラーの発生箇所を特定するために、ラップされたエラーからスタック情報を取得できるように工夫します。