air-verse/air

これは何？

主な機能

• 01ファイルの変更時にGoアプリを自動で再ビルド・再起動
• 02.air.toml またはCLIフラグからビルド・実行コマンドを設定
• 03サブディレクトリの除外と、新しく作成されたディレクトリの監視
• 04アセット処理やコード生成用のカスタムコマンドを監視ルールで実行
• 05ビルドのたびにブラウザーを再読み込みするオプションのプロキシ
• 06ビルド・実行前に .env ファイルを読み込み

ユースケース

• ginなどで構築したGoのWebサーバーを開発し、保存のたびに再読み込み
• Goアプリと並行してフロントエンドのアセットビルドやtempl／go generateを実行
• プロジェクトをマウントしたDockerコンテナ内でAirを実行し、ライブリロードを利用

クイックスタート

1. 1

   go install を使って Air をインストールします（Go 1.25 以降が必要です）

   go install github.com/air-verse/air@latest
2. 2

   Go の bin ディレクトリを PATH に追加します

   export PATH="$PATH:$(go env GOPATH)/bin"
3. 3

   プロジェクトディレクトリに移動して air を実行します

   air

使う前に知っておきたいこと

• !README には、Air は開発専用であり、本番環境のホットデプロイとは無関係であると記載されています。
• !GPL-3.0 ライセンスの下で提供されています。コピーレフトライセンスのため、派生物を配布する場合はオープンソースにする必要があります。

トピック

よくある質問

air とは？

Goのソースファイルを監視し、開発中にアプリを自動で再ビルド・再起動するコマンドラインツール。 Airは、Goアプリケーションの開発に使えるライブリロード用コマンドラインツールです。プロジェクトのルートで実行すると、ソースファイルが変更されるたびにプログラムを再ビルドして再起動するため、プロセスを手動で停止・起動せずに編集を続けられます。開発専用であり、本番環境でのホットデプロイとは関係ありません。

air は無料で使えますか？ライセンスは？

air は GPL-3.0 ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。

air は今もメンテナンスされていますか？

半年以内に更新あり。air の最終コミットは 2026年8月27日 です。

air は何に使えますか？

ginなどで構築したGoのWebサーバーを開発し、保存のたびに再読み込み Goアプリと並行してフロントエンドのアセットビルドやtempl／go generateを実行 プロジェクトをマウントしたDockerコンテナ内でAirを実行し、ライブリロードを利用

air のインストール方法は？

go install を使って Air をインストールします（Go 1.25 以降が必要です）: go install github.com/air-verse/air@latest Go の bin ディレクトリを PATH に追加します: export PATH="$PATH:$(go env GOPATH)/bin" プロジェクトディレクトリに移動して air を実行します: air

air はどこで入手できますか？

ソースコードとインストール手順は GitHub にあります：https://github.com/air-verse/air