← 用語集一覧へ戻る

環境変数

Environment Variable
security beginner
システムやアプリを動かすための「裏設定」のような値のこと。
環境変数 (Environment Variable)

概要（サマリー）

システムやアプリの動作に必要な設定値を、コード本体とは別に持たせるための仕組みのこと。

たとえば、APIキー、データベースの接続情報、メール設定、本番環境か開発環境かの区別など、コードの中に直接書きたくない認証情報や設定値を外側から渡すためによく使われる。
こうした値をコードにベタ書きしてしまうと、秘密情報が漏れたり、環境ごとの切り替えがしにくくなったりするため、環境変数として分けて管理するのが基本である。

AIにコードを書かせるときも、「秘密情報やAPIキーは環境変数から読むようにしてください」と指示するのは、とても重要な安全対策の1つである。

詳細解説

環境変数（Environment Variable）とは、アプリやシステムが動くときに参照する設定値を、コード本体とは別に持たせるための仕組みである。
初心者向けには、「プログラムの外から渡す裏設定」と考えるとわかりやすい。

たとえば、同じアプリでも

  • 自分のPCで動かすとき
  • テスト環境で動かすとき
  • 本番サーバーで動かすとき

では、使うデータベースやAPIキー、URLなどが違うことが多い。
そのたびにコードを書き換えるのは危険だし、面倒でもある。
そこで、そうした違う値を環境変数として外に持たせ、プログラム側はそれを読み込むようにする。

なぜ環境変数が必要なのか

もし設定値を全部コードに直接書いてしまうと、次のような問題が起きやすい。

  • APIキーや秘密情報が漏れやすい
  • Git に秘密情報が残りやすい
  • 開発環境と本番環境の切り替えがしにくい
  • 他の人とコードを共有しづらい
  • 設定変更のたびにコード修正が必要になる

そこで環境変数を使うと、

  • 機密情報をコードから分離できる
  • 環境ごとの値の切り替えがしやすい
  • 公開してよいコードと、非公開にすべき値を分けられる
  • 同じコードを複数環境で使いやすくなる

というメリットがある。

つまり環境変数は、
安全性と運用しやすさを高めるための設定の持ち方
なのである。

どんなイメージで考えればよいか

初心者向けには、次のようなたとえがわかりやすい。

裏設定のメモ

見た目には出てこないが、システムを動かすために必要な内部設定メモのようなもの。

差し替えできる設定カード

同じ機械でも、入れるカードを変えれば動作先やモードが変わるイメージ。

舞台裏のスイッチ

観客には見えないが、舞台を動かすための重要な設定が裏にある。
環境変数もそれに近い。

どんな値が環境変数になるのか

環境変数として扱われることが多いものには、次のようなものがある。

  • APIキー
  • データベースのホスト名
  • データベースのユーザー名
  • データベースの認証情報
  • 送信メール設定
  • 本番環境 / 開発環境の区別
  • 外部サービスのURL
  • ポート番号
  • PATH のようなシステム設定

つまり、環境によって変わる値 や 公開したくない値 は、環境変数と相性がよい。

環境変数はどうやって使うのか

環境変数は、OSや実行環境に登録された値として存在し、プログラム側がそれを読み取ることで使われる。

たとえば考え方としては、

  • OSや設定ファイル側に値を用意する
  • プログラムは「その名前の設定値をください」と読む
  • 値があればそれを使って動く

という流れである。

つまり、プログラム本体には「値そのもの」ではなく、
その値を取り出す仕組み
だけを書いておくことが多い。

.env との関係

環境変数を説明するときによく一緒に出てくるのが .env である。

  • 環境変数 = 設定値そのもの、またはそれを扱う仕組み
  • .env = その環境変数をファイル形式で書いておく方法の1つ

つまり .env は、環境変数を管理しやすくするための保存方法の1つである。
環境変数と .env は近いが、完全に同じ意味ではない。

初心者向けには、
.env は環境変数を書いておくメモ帳
と考えるとわかりやすい。

環境ごとに切り替えやすいのが強み

環境変数が特に便利なのは、環境ごとに値を差し替えやすいことだ。

たとえば、

  • ローカルではテスト用のDB
  • 本番では本番用のDB
  • 開発中はテスト用APIキー
  • 本番では本番用APIキー

のように、同じコードでも使う値だけを変えられる。

これにより、コード本体を変えずに環境を切り替えやすくなる。
この点が、環境変数の非常に大きなメリットである。

システム全体の設定にも使われる

環境変数はアプリ開発だけのものではない。
OSやシェルでも広く使われている。

たとえば、有名なものに PATH がある。
これは「コマンドを探しに行く場所の一覧」を持つ環境変数である。

つまり環境変数は、

  • アプリの秘密情報管理
  • 環境切り替え
  • システムの動作設定

など、かなり広い範囲で使われている。

環境変数のメリット

1. 機密情報をコードから分けられる

APIキーや秘密情報を直書きしなくて済む。

2. 環境ごとの切り替えがしやすい

開発・テスト・本番で値を分けやすい。

3. コードの再利用性が上がる

同じコードを違う環境でも使いやすい。

4. 運用しやすい

設定変更がコード修正ではなく設定変更で済むことがある。

環境変数の注意点

便利な一方で、注意点もある。

1. 値が見えにくい

コード内に直接ないため、「どこで設定されているか」が分かりにくいことがある。

2. 設定漏れで動かなくなる

必要な環境変数がセットされていないとエラーになることがある。

3. ログや画面に出さない配慮が必要

うっかり表示すると秘密情報の漏えいにつながる。

環境変数は秘密情報をコードから分離するために役立つが、それ自体が暗号化や完全な保護をしてくれるわけではない。
ログ、エラー画面、CI設定、クラウドの管理画面などに表示されないように扱う必要がある。

4. AIへそのまま共有しない

本物の秘密情報をそのまま渡すのは危険である。

AIコーディングで重要な理由

AIコーディングでは、APIやデータベース、外部サービスを扱うことが多い。
そのため、環境変数の理解はかなり重要である。

たとえばAIに

  • APIキーは環境変数から読み込んでください
  • 本番URLは環境変数で切り替えてください
  • DB接続情報を環境変数化してください

と言われることがある。

この意味が分かっていないと、

  • コードへ直書きしてしまう
  • GitHubへ秘密情報を載せてしまう
  • 本番と開発の設定を混同する
  • AIに本物のキーを渡してしまう

といったリスクが出てくる。

逆に環境変数の考え方が分かっていると、
安全で運用しやすいコード
に近づきやすくなる。

より詳しくAIに聞いてみよう

  • 環境変数とは何かを、中学生でもわかるように説明してください。
  • .env と環境変数の違いを初心者向けに整理してください。
  • なぜAPIキーやDBの認証情報を環境変数で管理するのか教えてください。
  • 開発環境と本番環境で環境変数を切り替える理由を説明してください。
  • AIコーディングで、秘密情報を安全に扱うための環境変数の使い方を教えてください。