Pythonのsubprocessの環境変数を設定する

[質問]

Pythonのsubprocessに環境変数を渡す方法として、自分のプロセスの環境変数を設定して子プロセスを起動する、という方法は行儀が悪いですか

[回答] Gemini

結論から言うと、「あまり行儀が良いとは言えない」ケースが多いです。

自分のプロセス（親プロセス）の環境変数を os.environ で直接書き換えてしまうと、その後に実行されるプログラム全体に影響が及ぶため、予期せぬサイドエフェクト（副作用）を生むリスクがあるからです。

もっと「お行儀が良く」、かつ安全な方法が Python には用意されています。

1. なぜ「直接書き換え」が推奨されないのか

Pythonで os.environ["VAR"] = "value" とすると、そのスクリプト内の全コードでその変数が有効になります。

他のライブラリへの影響: 読み込んでいる外部ライブラリが同じ環境変数を参照していた場合、挙動が変わってしまう可能性があります。
マルチスレッドでの危険性: os.environ はプロセス全体で共有されるため、あるスレッドで書き換えた変数が、意図せず別のスレッドで動いている処理に影響する「競合」が発生します。
後片付けの漏れ: 子プロセスが終わった後に元の値に戻し忘れると、親プロセスの残りの処理が汚染された状態で進んでしまいます。

2. おすすめの「お行儀の良い」方法

subprocess.run などの引数にある env パラメータ を使うのがベストプラクティスです。これを使えば、親プロセスの環境変数は汚さず、子プロセスにだけ特定の変数を渡すことができます。

実装例

現在の環境変数をコピーし、必要な分だけ追加・更新して渡すのが一般的です。

import subprocess
import os

# 1. 現在の環境変数をコピー（親プロセスは汚さない）
my_env = os.environ.copy()

# 2. 子プロセスに渡したい変数だけを追加・上書き
my_env["MY_SPECIAL_VAR"] = "hello_world"
my_env["PATH"] = f"/custom/path:{my_env['PATH']}"

# 3. env引数に渡して実行
subprocess.run(["ls", "-l"], env=my_env)

3. 使い分けの判断基準

方法	影響範囲	評価	使うべき場面
`env`引数を使う	子プロセスのみ	推奨	ほとんどのケース（安全・確実）
`os.environ`を書き換える	プロセス全体	非推奨	スクリプトの開始直後に設定し、最後までその設定で動かしたい使い捨てツールなど

まとめ

「自分の環境を汚さず、相手に必要なものだけ持たせて送り出す」のが、プログラム界隈におけるスマートな振る舞いです。

もし特定の環境変数が複雑に絡むような構成を作ろうとしているのであれば、その変数を設定するロジックをお手伝いしましょうか？

★続き

たしかに「子プロセスの引数の代わりに、親プロセスがいちいち環境変数を設定する」というのはよくないですね。それに対して、「親プロセスが自分のために環境変数を設定し、子プロセスはそれを見て親プロセスの環境を知る」という使い方は問題ない感じですね。

その通りです！「親が自分の状態を定義し、子がそれを継承する」という流れは、UNIX/Linux以来の伝統的でごく自然な設計思想です。

おっしゃる通り、 「親プロセスの設定（コンフィグ）として環境変数を使う」 のであれば、それは「行儀が悪い」どころか、むしろ標準的なプラクティスと言えます。

健全な使い方のイメージ

「行儀が悪い（副作用）」と「健全な継承」の違いを整理すると、以下のようになります。

健全なケース（設定の継承）

親プロセスが起動時に DEBUG=1 や DB_URL=... という環境変数を持っていて、それを子プロセスが参照して「あ、今はデバッグモードなんだな」と判断する。

メリット: 設定を一元管理できる。
例: DockerやCI/CDツール（GitHub Actionsなど）では、この「親が設定した環境を子が引き継ぐ」仕組みがフル活用されています。

行儀が悪いケース（一時的なすり替え）

親プロセスが本来の自分の目的とは関係なく、特定の子プロセスを動かす 瞬間だけ os.environ を書き換えて、終わったら戻す（あるいは戻し忘れる）。

デメリット: スレッドセーフではなく、予期せぬ場所で「書き換わった値」を参照してしまうリスクがある。

補足：子プロセスに「親の意図」を伝えるコツ

もし親プロセスがプログラムの途中で「この子プロセスにだけは、特別な設定を伝えたい」と思った場合は、やはり前述の env 引数を使うのが最も安全です。

import subprocess
import os

# 親プロセス自身の「基本設定」
os.environ["APP_MODE"] = "production"

# 特定の子プロセスにだけ「特殊な役割」を伝えたい場合
special_env = os.environ.copy()
special_env["TASK_TYPE"] = "background_cleanup"

# 親の環境(APP_MODE)を引き継ぎつつ、TASK_TYPEを添えて起動
subprocess.run(["python", "worker.py"], env=special_env)

このように、「親のアイデンティティ（環境）」はそのままに、子に渡す「メモ（追加の変数）」だけを切り分けるのが、最も堅牢な実装になります。

このあたりの「親子の役割分担」について、具体的にどのような値を渡そうと考えていらっしゃいますか？もし具体的なユースケースがあれば、より最適な構成案を考えられます。