【Python】環境変数の追加・参照・削除｜os.environの使い方

Pythonで環境変数を扱うには、標準ライブラリのosモジュールに含まれるos.environを利用します。本記事では、os.environの基本的な使い方から、実践例についても詳しく解説します。初心者から中級者まで、Pythonで環境構築やセキュアな設定管理を行いたい方に役立つ内容となっています。

os.environは環境変数へのアクセスを提供する

os.environは、環境変数へのアクセスを提供する辞書のようなオブジェクトで、Pythonスクリプトから実行環境に設定された環境変数を簡単に参照・設定・削除することができます。これは開発環境の切り替えや、機密情報の取り扱い、構成の自動化など、多くの場面で活躍する重要なインターフェースです。

1
import os
2
print(os.environ['USERPROFILE'])  # Windowsの場合

1
import os
2
print(os.environ['HOME'])  # Unix系OSの場合

os.environは辞書のように振る舞うため、.get()メソッドを使用して柔軟に操作することができます。

1
import os
2
# 安全に取得する方法（キーが存在しない可能性を考慮）
3
home_dir = os.environ.get('HOME', '/default/path')
4
print(f"ホームディレクトリ: {home_dir}")

このようにしておくと、実行環境によって環境変数が未設定でもデフォルト値を使用できるため、コードの堅牢性が高まります。

os.environで環境変数を追加・参照する

Python内で一時的に環境変数を設定することも可能です。設定はos.environに代入するだけで行えます。

1
import os
2
os.environ['MY_VARIABLE'] = 'some_value'
3
print(os.environ['MY_VARIABLE'])  # => 'some_value'

ただし、この設定はPythonプログラムの実行中およびその子プロセスにのみ反映され、システム全体の環境変数を恒久的に変更するわけではありません。これは、スクリプト実行時に一時的な設定が求められるCI/CDパイプラインやテスト環境の構築などに便利です。

os.environで環境変数を削除する

設定した環境変数を削除したい場合は、del文を使って削除できます。

1
import os
2
os.environ['MY_VARIABLE'] = 'some_value'
3
del os.environ['MY_VARIABLE']

ただし、存在しないキーを削除しようとするとKeyErrorが発生するため、削除の前にキーの存在を確認するようにしましょう。

1
import os
2
os.environ['MY_VARIABLE'] = 'some_value'
3
if 'MY_VARIABLE' in os.environ:
4
    del os.environ['MY_VARIABLE']
5
    print("環境変数MY_VARIABLEを削除しました")
6
else:
7
    print("MY_VARIABLEは存在しません")
8

9
if 'MY_VARIABLE2' in os.environ:
10
    del os.environ['MY_VARIABLE2']
11
    print("環境変数MY_VARIABLE2を削除しました")
12
else:
13
    print("MY_VARIABLE2は存在しません")

Kindle Unlimited

IT専門書も30日間無料で読み放題

1冊数千円する専門書から、ビジネス書、実用書、雑誌まで幅広いジャンルが定額で読み放題。ITスキルの向上はもちろん、日々の情報収集や教養を深めるのにも最適です。

• 📚 技術書も月額定額で読み放題
• 📱 マルチデバイス対応
• ✨ 30日間の無料体験

無料で30日間試してみる

os.environ実践例：APIキーや秘密鍵情報の管理

多くの実運用アプリケーションでは、APIキーやデータベースの認証情報、シークレットキーなど、コード内に直接記述すべきでない情報を環境変数で安全に管理します。

1
import os
2

3
API_KEY = os.environ.get('API_KEY')
4
if not API_KEY:
5
    raise ValueError("API_KEYが環境変数として設定されていません")

このようにすることで、Gitなどのバージョン管理システムに秘密情報が含まれないようになり、セキュリティが強化されます。また、.envファイルとpython-dotenvなどのツールと併用することで、ローカル開発環境と本番環境で異なる設定を簡単に切り替えられるようになります。

.envファイルとload_dotenvの活用

.envファイルは、環境変数をキーと値の形式で記述するテキストファイルです。これをPythonで読み込むには、python-dotenvライブラリを使用し、load_dotenv()を呼び出します。

例：.envファイル

1
API_KEY=your-api-key-here
2
DEBUG=true

例：Pythonコードで読み込む

1
from dotenv import load_dotenv
2
import os
3

4
# .envファイルを読み込む
5
load_dotenv()
6

7
# 読み込んだ環境変数を使用
8
api_key = os.environ.get('API_KEY')
9
if not api_key:
10
    raise ValueError("API_KEYが読み込めませんでした")
11

12
print(f"APIキー: {api_key}")

この方法を使えば、開発チーム全体で安全に設定を共有でき、環境ごとの切り替えも簡単になります。.envファイルは .gitignore に追加してバージョン管理対象から除外するのが一般的です。

os.environまとめ

• os.environはPythonで環境変数を操作するためのインターフェースです。
• 環境変数の取得・設定・削除が簡単にでき、プロセス内で完結します。
• APIキーや接続情報などの機密情報をコードから切り離して管理するのに非常に便利です。
• .envとの併用により、柔軟で拡張性のある設定管理が可能です。

Pythonで安全かつ効率的に構成管理を行うには、os.environを使いこなすことが重要です。プロジェクトの初期設計時から環境変数の取り扱い方針を決めておくことで、開発や運用のトラブルを未然に防ぐことができます。

Pythonユーザにお勧めの本

人気

スッキリわかるPython入門 第2版 スッキリわかるシリーズ

難易度

実用性

読みやすさ

こんな人におすすめ： プログラミング完全未経験者、Pythonに再挑戦したい人

対話形式でスラスラ読める。複雑な概念もキャラクターが分かりやすく解説してくれます。

Amazonで詳細 🔴 楽天

独習Python

難易度

実用性

網羅性

こんな人におすすめ： Pythonを体系的に、かつ深くマスターしたい人

言語仕様を深く解説。なんとなく書ける状態から、自信を持って書ける状態へ引き上げてくれます。

Amazonで詳細 🔴 楽天

Python1年生 第2版 体験してわかる！会話でまなべる！プログラミングのしくみ

難易度

実用性

読みやすさ

こんな人におすすめ： 超初心者が最初に手にする一冊

イラスト中心で、プログラミングの楽しさを教えてくれる。ワクワクしながら学べる入門書です。

Amazonで詳細 🔴 楽天

📚 ITエンジニア向けおすすめ技術書・関連書籍まとめはこちら