caarlos0/env

これは何？

主な機能

• 01`env`構造体タグを使って、環境変数を構造体に読み込みます。
• 02組み込みの数値、文字列、bool、duration、URL、タイムゾーン型に対応しています。
• 03プレフィックス付きのスライス、マップ、ポインター、ネストした構造体を扱えます。
• 04必須チェック、notEmpty、ファイル読み込み、変数展開のオプションを利用できます。
• 05ユーザー定義型向けのカスタムパーサーを設定できます。

ユースケース

• Goサービスで環境変数からアプリケーション設定を読み込む。
• 起動時に必須設定がそろっていることを検証する。
• コンテナ環境や12-factor形式の設定を、型付きGo構造体に読み込む。

クイックスタート

1. 1

   go get でライブラリをインストールします

   go get github.com/caarlos0/env/v11
2. 2

   env タグを付けた struct を定義し、env.Parse を呼び出して環境変数を読み込みます

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

• !非公開の struct フィールドは仕様上無視されます。

トピック

よくある質問

env とは？

構造体タグを使って環境変数を型付き構造体に読み込む、依存関係ゼロのGoライブラリです。 envは、環境変数から設定を読み込むためのGoライブラリです。構造体を定義し、読み込む環境変数名を`env`タグで各フィールドに指定して、ParseまたはParseAsを呼び出すと、型付きの値が構造体に設定されます。外部依存はありません。

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

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

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

活発にメンテナンス中。env の最終コミットは 2026年11月5日 です。

env は何に使えますか？

Goサービスで環境変数からアプリケーション設定を読み込む。 起動時に必須設定がそろっていることを検証する。 コンテナ環境や12-factor形式の設定を、型付きGo構造体に読み込む。

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

go get でライブラリをインストールします: go get github.com/caarlos0/env/v11 env タグを付けた struct を定義し、env.Parse を呼び出して環境変数を読み込みます

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

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