Rustで環境変数を取得する方法：std::envとdotenvyによる効率的な実装と解説

2026年5月8日

標準ライブラリ

Rustで堅牢なアプリケーションを開発する際、設定情報や機密情報を安全に管理するための「環境変数」の扱いは非常に重要なテーマとなります。

データベースの接続URLやAPIキー、実行モードの切り替えといった動的な情報をソースコードにハードコーディングすることは、セキュリティ上のリスクを招くだけでなく、柔軟な運用を妨げる要因にもなり得ます。

Rustの標準ライブラリには環境変数を操作するための強力なツールが備わっており、さらにエコシステムのライブラリを組み合わせることで、開発環境と本番環境の切り替えをスムーズに行うことが可能です。

本記事では、Rustで環境変数を取得するための標準的な手法から、デファクトスタンダードとなっている外部クレートの活用法まで、2026年現在のベストプラクティスを網羅して解説します。

目次 [ close ]

Rustにおける環境変数管理の重要性

モダンなソフトウェア開発において、アプリケーションの構成を環境変数で管理する手法は、Twelve-Factor Appなどの指針でも推奨されている標準的なアプローチです。

特にRustのようなコンパイル言語では、環境変数を利用することでバイナリを再ビルドすることなく実行時の挙動を変更できるという大きなメリットがあります。

また、セキュリティの観点からも、Gitなどのバージョン管理システムに含めてはいけない秘密情報を環境変数として外部から注入することは必須の要件と言えるでしょう。

Rustのエコシステムでは、これらの変数を「安全に」「効率的に」そして「型安全に」扱うための仕組みが整っています。

std::envモジュールによる基本的な環境変数の取得

Rustの標準ライブラリである std::env モジュールを使用すると、追加の依存関係なしに環境変数を取得することができます。

最も頻繁に使用されるのは std::env::var 関数であり、これは指定したキーに対応する値を Result<String, VarError> 型で返します。

std::env::var の基本的な使い方

まずは、特定の環境変数を取得して表示する最もシンプルな実装例を見てみましょう。

Rust

use std::env;

fn main() {
    // "DATABASE_URL" という名前の環境変数を取得します
    let key = "DATABASE_URL";
    match env::var(key) {
        Ok(value) => println!("{}: {}", key, value),
        Err(e) => println!("環境変数 {} の取得に失敗しました: {}", key, e),
    }
}

このコードを実行する際、環境変数が設定されていればその値が表示され、設定されていなければエラーメッセージが表示されます。

実行結果

DATABASE_URL: postgres://user:password@localhost/db

エラーハンドリングと値の有無の確認

std::env::var が返す VarError には、変数が存在しない場合の NotPresent と、値が有効なUnicodeでない場合の NotUnicode の2種類があります。

プロダクションコードでは、これらのエラーを適切に処理し、アプリケーションが予期せぬパニックを起こさないように設計することが重要です。

例えば、環境変数が設定されていない場合にデフォルト値を使用したい場合は、unwrap_or メソッドを活用するのが効率的です。

Rust

use std::env;

fn main() {
    // 環境変数がなければ "8080" をデフォルト値として使用します
    let port = env::var("PORT").unwrap_or_else(|_| "8080".to_string());
    println!("Listening on port: {}", port);
}

Unicode以外のデータを扱う var_os

環境変数の値が必ずしも有効なUTF-8文字列であるとは限らないプラットフォーム（特にWindowsや一部のUnix系システム）に対応する場合、std::env::var_os を使用します。

この関数は Option<OsString> を返すため、文字列として処理できないバイナリデータに近いパス情報なども安全に取得できます。

ファイルパスなどを環境変数から取得する場合は、OS固有の表現を保持できる var_os の利用を検討してください。

dotenvyを用いた開発環境での環境変数管理

ローカル開発環境において、OSの環境変数を毎回手動でエクスポートするのは手間がかかり、ミスも発生しやすくなります。

そこで、プロジェクト直下の .env ファイルから環境変数を自動的に読み込む dotenvy クレートが広く利用されています。

かつては dotenv というクレートが主流でしたが、現在はメンテナンスが継続されている dotenvy を使用するのが2026年現在の標準です。

dotenvyの導入手順

まずは Cargo.toml に依存関係を追加します。

TOML

[dependencies]
dotenvy = "0.15"

次に、プロジェクトのルートディレクトリに .env ファイルを作成し、設定内容を記述します。

text

DATABASE_URL=postgres://localhost/mydb
API_KEY=abcdef123456
DEBUG_LEVEL=info

コード内での読み込み処理

アプリケーションの起動時に dotenvy::dotenv() を呼び出すことで、.env ファイルの内容がプロセス内の環境変数としてロードされます。

Rust

use std::env;
use dotenvy::dotenv;

fn main() {
    // .envファイルを読み込みます。失敗しても続行できるようにエラーは無視する場合が多いです。
    dotenv().ok();

    // 以降は通常の std::env::var で値を取得できます
    let api_key = env::var("API_KEY").expect("API_KEY must be set");
    println!("API Key loaded: {}", api_key);
}

dotenv().ok() と記述することで、.env ファイルが存在しない場合（本番環境など）でもプログラムをクラッシュさせずに実行できます。

環境変数を型安全に扱う：envyクレートの活用

std::env::var は全ての値を文字列として取得しますが、実際にはポート番号を整数として、あるいはフラグを真偽値として扱いたいケースが多々あります。

envy クレートを使用すると、環境変数をあらかじめ定義した構造体にデシリアライズして取り込むことが可能です。

構造体へのマッピング

serde クレートと組み合わせて、環境変数を型安全に定義する手法は、大規模なアプリケーションで非常に有効です。

Rust

use serde::Deserialize;
use dotenvy::dotenv;

#[derive(Deserialize, Debug)]
struct Config {
    database_url: String,
    port: u16,
    is_debug: bool,
}

fn main() {
    dotenv().ok();

    // 環境変数をConfig構造体に読み込みます
    // 変数名は自動的に大文字から小文字へ変換してマッチングされます
    match envy::from_env::<Config>() {
        Ok(config) => println!("Config loaded: {:?}", config),
        Err(e) => panic!("Couldn't read config from env: {}", e),
    }
}

このように実装することで、「PORTが数値でない」といった型の不一致を起動時に検知でき、実行時のバグを未然に防ぐことができます。

環境変数の運用におけるセキュリティと注意点

環境変数を扱う上で最も注意しなければならないのは、秘密情報の漏洩です。

ここでは、Rust開発において守るべきセキュリティルールを整理します。

.envファイルのバージョン管理除外

絶対に .env ファイルをGitリポジトリにコミットしてはいけません。

.gitignore に必ず .env を追加し、代わりにテンプレートとなる .env.example を配布する形式をとりましょう。

text

# .gitignore
.env

実行時エラーの回避

本番環境で必要な環境変数が欠落していると、アプリケーションは予期せぬ動作をしたり、起動直後にパニックを起こしたりします。

これを防ぐためには、main 関数の初期段階で必要な変数を全てチェックし、不足があればエラーメッセージを表示して正常終了させる設計が望ましいです。

環境変数の動的な書き換え（std::env::set_var）

Rustには std::env::set_var という環境変数を設定する関数も存在しますが、これには注意が必要です。

マルチスレッド環境において set_var を使用すると、スレッドセーフではない操作として扱われ、予期しない動作を引き起こす可能性があります。

実際、Rust 1.81以降では、一部のプラットフォームや条件下で set_var の使用が非推奨、あるいは安全ではない操作として議論されています。

基本的に、環境変数は「外部から読み取るもの」として扱い、プロセス内部で値を書き換える必要がある場合は std::sync::OnceLock などを利用したアプリケーション内グローバル変数を利用しましょう。

高度な手法：ビルド時に環境変数を取り込む

実行時ではなく、コンパイル時に環境変数の値を取得してバイナリに埋め込みたい場合は env! マクロを使用します。

これはビルド環境の変数を参照するため、バージョン番号やビルドターゲット情報の埋め込みに適しています。

Rust

fn main() {
    // ビルド時に環境変数が存在しない場合、コンパイルエラーになります
    let version = env!("CARGO_PKG_VERSION");
    println!("Version: {}", version);
}

実行時に値が変わる可能性のある設定には std::env::var を使い、ビルド時の固定情報には env! を使うという使い分けが重要です。

よくある課題と解決策

Rustでの環境変数操作において、開発者が直面しやすい問題とその対処法をまとめました。

課題	原因	解決策
取得した値が文字化けする	Unicode以外の文字が含まれている	`var_os` を使用して OsString として扱う
.env ファイルが読み込まれない	カレントディレクトリの不一致	`dotenvy::from_path` でパスを明示する
テスト中に環境変数が混ざる	並列テストによる競合	テストケースごとに `serial_test` クレートで逐次実行する