Windowsの環境変数とは?システムとユーザーの違い・Pathの優先順位

このサイトはアフィリエイト広告(Amazonアソシエイト含む)を掲載しています。
システム環境変数とユーザー環境変数の比較。通常の同名変数はユーザー側が優先され、Pathは結合される

PowerShellで新しいツールを入れた後パスを通そうとして「システム環境変数とユーザー環境変数どっちに追加すればいいんだっけ」と手が止まったこと、ありませんか。筆者も最初のころは適当に両方へ似たような値を追加してしまい、あとで「思った通りに反映されない」と首をかしげたことがあります。

個人だけで使う設定はユーザー環境変数、PCの全ユーザーで使う設定はシステム環境変数に入れるのが基本です。同名の通常変数が両方にある場合はユーザー側が優先されます。一方、Pathは上書きではなくMachine側とUser側が1つの検索パスとして結合されます。同名の実行ファイルが複数ある場合は、最終的なPathの前にあるフォルダーのものが先に使われます。

目次

環境変数とは?

環境変数はWindowsという建物の掲示板に貼ってある共有メモのようなものです。プログラムは起動するときにこのメモを覗きに行き「実行ファイルはどこにあるんだっけ」「一時ファイルはどこに置けばいいんだっけ」といった情報を確認します。

たとえばPathという環境変数には「実行ファイルを探しにいくフォルダの一覧」が入っています。コマンドプロンプトやPowerShellでnodeやgitとだけ打って動くのは、これらの実行ファイルが置かれているフォルダがPathに登録されているからです。

Pathに登録されていないフォルダの実行ファイルも、ファイルの場所を指定すれば実行できます。PowerShellでは現在のフォルダにあるファイルを.\tool.exeのような相対パスで指定する方法もあります。


PowerShellのps1ファイルを実行する場合は相対パス・絶対パス・右クリックなど実行方法ごとの書き方を次の記事で確認できます。

システム環境変数とユーザー環境変数の違い

環境変数には大きく分けて2種類あり、保存場所と適用範囲が異なります。

Windowsの環境変数はプログラムが実行時に参照する設定値です。永続的な設定には「PC全体に適用されるMachineスコープ」「ログインユーザーだけに適用されるUserスコープ」があります。現在起動中のプログラムはそれらを元に作られたProcessスコープの環境変数を使います。

項目システム環境変数ユーザー環境変数
保存場所(レジストリ)HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Session Manager\EnvironmentHKEY_CURRENT_USER\Environment
適用範囲そのPCを使う全ユーザーログイン中の自分だけ
変更に必要な権限管理者権限が必要特別な権限は不要
主な用途全ユーザー共通のツール(Node.jsやGitなど)の実行パス自分専用の環境(venvや個人ツールなど)

自分しか使わないPCであれば正直どちらに追加しても動作は変わらないことが多いです。チームで共有するPCや複数アカウントでログインする環境では、ユーザー環境変数に追加した設定は自分以外のアカウントには反映されない点に注意が必要です。

UserやMachineに保存した値を変更しても起動中のPowerShellが持つProcessの値は自動では更新されません。変更後は使っているターミナルや開発ツールを終了して開き直してください。新しいタブでも古い値のままなら、親アプリが以前の環境変数を引き継いでいる可能性があります。

同じ変数名をシステムとユーザーの両方に作ってみた

同じ名前の変数がシステム側とユーザー側の両方に存在した場合、Windowsはどちらの値を使うか気になりますね。

管理者権限のPowerShellでシステム側に値を設定します。

PowerShell
[System.Environment]::SetEnvironmentVariable('TEST_VAR', 'システム側の値です', 'Machine')

続けて通常権限のPowerShellでユーザー側にも同じ変数名で値を設定します。

PowerShell
[System.Environment]::SetEnvironmentVariable('TEST_VAR', 'ユーザー側の値です', 'User')

ここで新しいPowerShellウィンドウを開き直して確認してみます。

確認結果
PS C:\> $env:TEST_VAR
ユーザー側の値です

ユーザー側の値が優先されてますね。これはWindowsが環境変数を組み立てる際、システム側の値を先に読み込んだあとにユーザー側の値を読み込み、同じ名前があれば後から読んだ方で上書きするという処理をしているためです。

ではPathでも同じことをしたらどうなるでしょうか。システム側のPathにC:\SystemToolを、ユーザー側のPathにC:\MyToolを追加してみます。

確認結果
PS C:\> $env:Path -split ';' | Select-Object -First 3
C:\Program Files\PowerShell\7
C:\SystemTool
C:\MyTool

TEST_VARとは違いPathは通常システム側の値の後ろにユーザー側の値が結合されます。ユーザー側にPathを設定してもシステム側のPathは消えません。

これはWindowsが両方の設定を組み合わせるときの話です。設定画面やコマンドでユーザー側のPathを新しい値に置き換えると、ユーザー側に保存されていた既存の項目は消えます。Pathへ追加するときは変更する側の現在の値を残したまま追記してください。

PowerShell
Get-Command node

Pathの優先順位は結合後の並び順で決まる

通常、Pathはシステム側の一覧の後ろにユーザー側の一覧が続きます。そのため、ユーザー側のPathでフォルダを一番上へ移動してもシステム側のPathより前になるわけではありません。

PowerShellの起動処理や開発ツールによっては実行中のPathが変更されることもあります。実際の並び順は現在のPowerShellで確認してください。

PowerShell
$env:Path -split ';'
実行結果(例)
C:\Program Files\PowerShell\7
C:\Program Files\NVIDIA GPU Computing Toolkit\CUDA\v12.0\bin
C:\Program Files\NVIDIA GPU Computing Toolkit\CUDA\v12.0\libnvvp
C:\WINDOWS\system32
C:\WINDOWS
(以下省略)

同じ名前の実行ファイルが複数ある場合、Path内では前にあるフォルダが優先されます。たとえばnodeを実行したときに何が使われるかは、次のコマンドで確認できます。

PowerShell
Get-Command node | Select-Object CommandType, Name, Source, Definition
実行結果(例)
CommandType Name     Source                           Definition
----------- ----     ------                           ----------
Application node.exe D:\Program Files\nodejs\node.exe D:\Program Files\nodejs\node.exe

同名の候補を一覧で確認する場合は-Allを付けます。

PowerShell
Get-Command node -All | Select-Object CommandType, Name, Source, Definition

PowerShellでは同名のエイリアスや関数が実行ファイルより優先される場合もあります。想定と違うものが動くときは、Pathの順番だけでなくCommandTypeも確認してください。


PowerShell 7のインストーラーにも「Add PowerShell to Path Environment Variable」という設定があります。実際のインストール画面を見ながら確認したい場合はこちらも参考にしてください。

PowerShellで安全に確認・設定する方法

環境変数についての公式情報もどうぞ。

現在の値をスコープ別に確認する

現在のPowerShellで使われている環境変数を一覧表示するには次のコマンドを実行します。

PowerShell
Get-ChildItem Env: | Sort-Object Name

特定の変数だけを確認する場合は$env:変数名と書きます。たとえば一時ファイルの保存先はEnv: Tempで確認できます。。

コマンドプロンプトでは一覧表示にset、特定の変数の確認にecho %TEMP%を使います。PowerShellとは書き方が異なります。

ここで表示されるのは実行中のプロセスが持っている値です。ユーザー側とシステム側に保存された値を分けて調べる場合は次の方法を使います。GetEnvironmentVariableの第2引数にスコープを指定するとシステム側とユーザー側を別々に確認できます。

PowerShell
# システム環境変数のPathを確認
[System.Environment]::GetEnvironmentVariable('Path', 'Machine')

# ユーザー環境変数のPathを確認
[System.Environment]::GetEnvironmentVariable('Path', 'User')

# 現在のセッションで実際に使われている合体後のPathを確認
$env:Path -split ';'

第2引数に指定できる値は次の3つです。

Machine

システム環境変数を意味します。書き込みには管理者権限が必要です。

User

ユーザー環境変数を意味します。管理者権限は不要です。

Process

現在動いているPowerShellプロセスが実際に持っている環境変数です。通常は親プロセスから引き継いだ値を持っていますが、起動後に変更することもできるためUserやMachineに保存されている値と必ず同じとは限りません。


$env:Pathのような環境変数と$nameのような通常のPowerShell変数は別物です。変数そのものの宣言・型・スコープ・文字列展開については以下の記事で詳しく解説しています。

ユーザー環境変数にPathを安全に追加する

いきなり値を代入すると既存のPathが消えてしまうので、必ず現在のPathの値を読み出してから前なり後ろに追加します。

PowerShell
$currentUserPath = [System.Environment]::GetEnvironmentVariable('Path', 'User')
$newPath = $currentUserPath + ';【追加したいフォルダのパス】'
[System.Environment]::SetEnvironmentVariable('Path', $newPath, 'User')

管理者権限は不要なので通常のPowerShellでそのまま実行できます。

システム環境変数を変更する場合の注意点

全ユーザーで共通のツールをPathに登録したい場合はMachineスコープを使いますが、必ず管理者としてPowerShellを起動してください。

PowerShell
$currentMachinePath = [System.Environment]::GetEnvironmentVariable('Path', 'Machine')
$newMachinePath = $currentMachinePath + ';【追加したいフォルダのパス】'
[System.Environment]::SetEnvironmentVariable('Path', $newMachinePath, 'Machine')

システム側は全ユーザーに影響するため、既存の値を消してしまうと他のアプリまで動かなくなることがあります。実行前に$currentMachinePathの中身をどこかにメモしておくと安心です。

setxコマンドを使うときに気をつけたいこと

Path編集の方法を調べるとsetx PATH "%PATH%;C:\追加したいフォルダ"のようなコマンドプロンプト向けの書き方もよく紹介されています。ただsetxコマンドには1024文字の制限があります。1024文字を超えると警告は表示されますが、値は途中で切り詰められた状態で保存されるため、既存のPathを壊す原因になります。Pathの編集には[System.Environment]::SetEnvironmentVariable()かWindowsの環境変数画面を使う方が安全です。

Windowsの環境変数画面はWin + R > sysdm.cplと入力 > 詳細設定 > 環境変数でアクセスできます。

Windowsの環境変数画面。上段にユーザー環境変数、下段にシステム環境変数を表示
上段がユーザー環境変数、下段がシステム環境変数です。編集する側を確認してから操作します。

迷いやすいポイント

GUI(設定画面)とPowerShell、環境変数はどちらで編集すればいい?

一度だけの追加であればシステムのプロパティ画面から開ける「環境変数」ダイアログでも十分です。一覧形式で編集できるので誤操作が少なく済みます。何度も同じ作業をする場合やセットアップ手順をスクリプト化したい場合はPowerShellが向いています。

環境変数を変更したのにPowerShellで認識されない

まず変更した値がUserまたはMachineに保存されているかを確認してください。保存値は新しいのに現在のPowerShellだけ古い場合は、起動時に引き継いだ値が残っています。

Windows TerminalやVS Codeの統合ターミナルを使っている場合はタブだけでなくアプリ全体を終了して開き直してください。それでも反映されない場合は作業を保存してWindowsからサインアウトし、サインインし直します。

$env:変数名 = '値'で変更しただけの場合は、現在のPowerShellとそこから起動する子プロセスに使われる設定です。次回以降も使うにはUserまたはMachineへの保存が必要です。

レジストリを直接編集して大丈夫?

可能ですが編集後にWM_SETTINGCHANGEというメッセージをシステムに送らないと既に起動しているエクスプローラーなどに変更がすぐ反映されないことがあります。特別な理由がなければシステムのプロパティ画面か[System.Environment]クラス経由での編集をおすすめします。

環境変数以外のPowerShell基本操作や実行ポリシー、よく使うコマンドもまとめて確認したい場合はこちら。

まとめ

  • システム環境変数は全ユーザー共通、ユーザー環境変数は自分専用の設定だよ。
  • 同じ名前の変数が両方にある場合はユーザー環境変数が優先されるよ。
  • でもPathだけは特別で、システムとユーザーの両方が結合されて使われるよ。
  • Pathを編集するときはsetxコマンドの1024文字制限に気をつけてね。
  • 変更後はターミナルや開発ツールを開き直してね。新しいタブでも変わらないときはアプリ全体を終了してから確認しよう。

Windowsの設定変更やトラブル対処をまとめて探したい場合はこちらも参考にしてください。

  • URLをコピーしました!
目次