如何添加環境變量：深度解析 Windows、macOS 與 Linux 系統設定攻略

Byadmin

Table of Contents

「找不到指令！」如何添加環境變量才能讓你的程式順利執行？

嘿，你是不是也遇過這種狀況？興高采烈地安裝好一個新程式或開發工具，照著網路上的教學一個口令一個動作，結果一打開終端機或命令提示字元，輸入指令卻跳出「找不到指令」、「’javac’ 不是內部或外部命令」這種讓人一頭霧水的錯誤訊息？別擔心，這幾乎是每個接觸程式或系統設定的人必經的「成長痛」啦！而這個問題的根源，很可能就是──你忘了「添加環境變量」了！

環境變量（Environment Variable），這名字聽起來可能有點陌生，甚至有點「硬核」，但它卻是我們電腦系統裡超級重要的一環喔！簡單來說，它就像是電腦系統的「小抄」或「備忘錄」，裡面記錄了許多關鍵的資訊，告訴系統程式該去哪裡找檔案、該怎麼執行等等。當你設定好環境變量，電腦就知道，喔，原來我需要的程式或腳本檔案，就在那個指定的路徑裡，這樣才能順利地找到並執行它。

這篇文章就是要帶你深入了解什麼是環境變量，它到底有多重要，更重要的是，我會一步步教你如何在 Windows、macOS 和 Linux 這三大主流作業系統中，正確且有效地添加環境變量。不管你是剛入門的新手，還是想要更深入了解系統設定的老手，這篇文章都能幫你解惑，讓你的程式碼從此不再「迷路」！

快速解答：如何添加環境變量？

快速來說，添加環境變量主要就是告知你的作業系統某些重要的配置資訊，例如程式的安裝路徑。這個過程會因為作業系統的不同而有差異：

  • Windows 系統： 通常透過「系統內容」中的「環境變數」設定介面，選擇添加「使用者變數」或「系統變數」，並指定變數名稱與數值（通常是路徑）。也可以使用命令提示字元或 PowerShell 中的 `setx` 指令來新增。
  • macOS 與 Linux 系統： 主要透過編輯你所使用的 Shell（例如 Bash 或 Zsh）的設定檔，像是 `.bash_profile`、`.zshrc` 或 `.profile` 等。在檔案中加入 `export 變數名稱=”數值”` 這樣的語法，然後重新載入設定檔或重啟終端機。對於所有用戶或系統範圍的變量，則會編輯 `/etc/profile`、`/etc/environment` 或 `/etc/profile.d/` 下的檔案。

無論哪種系統，設定完畢後，通常都需要重新啟動相關應用程式、終端機，甚至重開機，才能讓新的環境變量生效喔！

環境變量是什麼？它為什麼這麼重要？

每次聽到「環境變量」這個詞，很多人都會覺得有點抽象，甚至有些距離感。但其實，它就像我們日常生活中會使用的「捷徑」或是「地址簿」一樣，默默地在電腦系統背後扮演著關鍵角色。來，讓我來好好解釋一下。

環境變量的本質：系統的「備忘錄」與「指引」

想像一下，你的電腦要執行一個程式，比如 `python`。如果沒有環境變量，系統就得從頭到尾把所有可能的資料夾都找過一遍，才能找到 `python.exe` 或 `python` 這個執行檔。這得多慢啊？

這時候，環境變量就派上用場了！它就像是系統的一個內部清單，裡面儲存著一堆鍵值對（Key-Value Pair），告訴系統一些非常重要的訊息。例如，最常見的 `PATH` 環境變量，就是一個包含多個資料夾路徑的清單。當你輸入一個指令，系統就會照著 `PATH` 裡列出來的這些路徑，依序去尋找對應的執行檔。找到了，就執行；沒找到，就跟你說「找不到指令」。

我的經驗是，很多新手剛開始學程式，像是要跑 Java 的 `javac` 或 Python 的 `pip`，常常會因為沒設定 `JAVA_HOME` 或把 Python 的路徑加到 `PATH` 裡，就一直卡關。其實只要把環境變量設定好，問題常常就能迎刃而解了，真的是事半功倍！

環境變量的分類：使用者變量與系統變量

環境變量大致上可以分為兩種，它們的差別在於作用範圍：

  1. 使用者變量（User Variables）：

    • 作用範圍： 只對當前登入的「使用者帳戶」生效。如果你電腦有多個使用者，甲使用者設定的環境變量，乙使用者登入後是看不到也用不到的。
    • 應用場景： 通常用來設定個人化的工具路徑、程式設定、或是只有自己會用到的開發環境等等。比如，你可能想把某個特定的腳本目錄加到自己的 `PATH` 裡，但不想影響到其他使用者。
  2. 系統變量（System Variables）：

    • 作用範圍： 對整台電腦上「所有使用者帳戶」都生效，甚至在某些系統服務運行時也會用到。
    • 應用場景： 常用於設定整個系統都需要依賴的程式路徑、系統級別的工具（例如某些驅動程式的路徑），或是你希望每個使用者都能直接使用的通用工具。例如，Windows 系統預設的 `SystemRoot` 變量，指向 Windows 的安裝目錄，就是一個典型的系統變量。

在 Windows 系統中，這兩種變量有很明確的區分界面；而在 macOS 和 Linux 中，則是透過不同的設定檔來達到類似的效果（例如，使用者目錄下的設定檔只對該使用者生效，而 `/etc` 目錄下的設定檔則對所有使用者生效）。

那些你可能聽過的常見環境變量

了解環境變量的概念後，我們來看看幾個你最常會遇到的例子：

  • PATH： 這個是絕對的「超級巨星」！它是一個以分號（Windows）或冒號（macOS/Linux）分隔的路徑清單。當你在命令提示字元或終端機輸入指令時，系統就會在 `PATH` 列出的這些目錄裡找尋對應的執行檔。如果你的程式執行檔所在的路徑沒有被加入 `PATH`，那系統就找不到它，自然會報錯啦！
  • HOME： 指向當前使用者帳戶的主目錄。在 macOS 和 Linux 中非常常用，例如 `~/` 就是 `HOME` 的縮寫。
  • JAVA_HOME： 如果你是 Java 開發者，這個變量肯定不陌生。它指向 Java Development Kit (JDK) 的安裝目錄。許多 Java 相關的工具和程式都需要它來定位 JDK。
  • M2_HOME： Maven 建置工具的安裝路徑。
  • PYTHONPATH： Python 直譯器用來尋找模組的路徑。

其實還有很多其他環境變量，像是 `TMP` 或 `TEMP`（臨時檔案目錄）、`LANG`（語言設定）等等，它們各自有不同的用途，都在默默地協調著系統的運作。是不是覺得它們有點像系統的「幕後英雄」呢？

Windows 系統如何添加環境變量？三種常用方法大解析

在 Windows 系統中添加環境變量，其實有幾種不同的方式，最常見也最直觀的就是透過圖形化介面（GUI）來操作。當然，如果你喜歡「黑底白字」的命令列介面，也有指令可以讓你快速搞定喔！讓我們來一一詳解。

方法一：透過系統設定介面（最常用也最推薦！）

這是大多數 Windows 使用者會選擇的方法，因為它最直觀，而且能夠清楚區分「使用者變數」和「系統變數」。

  1. 開啟「系統內容」：

    • 在 Windows 10/11 中，你可以在「開始」選單搜尋「環境變數」，點選「編輯系統環境變數」就能直接跳到相關設定。
    • 或者，右鍵點擊「此電腦」（或「我的電腦」）> 選擇「內容」> 然後在左側選單點擊「進階系統設定」。

    看到「系統內容」視窗了嗎？它裡面有許多標籤頁，我們需要的是「進階」這個頁面。

  2. 進入「環境變數」設定：

    • 在「進階」標籤頁下方，你會看到一個大大的「環境變數(N)…」按鈕，點下去就對了！

    這時會跳出一個新的「環境變數」視窗，它會把變數分為上下兩個區塊：上面是「使用者變數」，下面是「系統變數」。

  3. 新增或編輯變數：

    • 新增變數：

      • 在你想新增的區塊（使用者或系統）點擊「新增(N)…」按鈕。
      • 在彈出的「新增使用者變數」或「新增系統變數」視窗中，輸入「變數名稱」和「變數值」。例如，如果你要新增 `JAVA_HOME`，變數名稱就填 `JAVA_HOME`，變數值就填你的 JDK 安裝路徑，像是 `C:\Program Files\Java\jdk-17`。
      • 點擊「確定」。
    • 編輯現有變數（尤其是 `Path` 變數）：

      • 選擇你想編輯的變數（例如 `Path`），然後點擊「編輯(E)…」按鈕。
      • 對於 `Path` 這種包含多個路徑的變數，Windows 10/11 會提供一個更友善的編輯器，你可以「新增(N)」、「編輯(E)」、「刪除(D)」或是調整路徑的順序。每個路徑都會獨立成一行，這樣就不用擔心搞亂整個字串了。
      • 記得，當你新增一個程式路徑到 `Path` 時，通常是把程式執行檔所在的目錄路徑加進去，而不是執行檔本身喔！
      • 編輯完畢，點擊「確定」。
  4. 保存設定並生效：

    • 一路點擊「確定」關閉所有打開的視窗，確保你的更改被保存。
    • 重點來了！ 你的變更不會立即在所有正在執行的程式中生效。你需要關閉任何正在運行中的命令提示字元（CMD）、PowerShell 視窗或其他你希望使用新環境變數的應用程式，然後重新打開它們。有時候，甚至可能需要重新啟動你的電腦，尤其是對於某些系統級的變更，這樣才能確保萬無一失。

我覺得這種圖形化介面真的很方便，可以讓你清楚看到所有的變量，也不容易出錯。對新手來說，這是最好的入門方式啦！

方法二：透過命令提示字元 (CMD) 或 PowerShell (CLI)

如果你是喜歡用鍵盤操作、或者需要撰寫腳本來自動化設定的，那命令列工具就會是你的好幫手。Windows 提供 `set` 和 `setx` 這兩個指令。

使用 `set` 指令（臨時變量）

`set` 指令只能在當前命令提示字元或 PowerShell 會話中設定環境變量，一旦你關閉了這個視窗，變量就消失了，不會被保存下來。

語法：

set 變數名稱=變數值

範例：

set MY_TEMP_PATH=C:\MyTools
set PATH=%PATH%;C:\MyOtherTools

第一個範例設定了一個名為 `MY_TEMP_PATH` 的臨時變量。第二個範例則是將 `C:\MyOtherTools` 這個路徑添加到當前會話的 `PATH` 環境變量中。請注意，`%PATH%` 是用來引用當前 `PATH` 的值。

使用 `setx` 指令（永久變量）

`setx` 指令則能讓你設定永久性的環境變量，不論是使用者變量還是系統變量，它會把變量寫入登錄檔中，所以即使重開機也會保留。

語法：

setx 變數名稱 "變數值" [/M]
  • `變數名稱`：你要設定的環境變量名稱。
  • `變數值`：變量要存放的數值。如果數值包含空格，記得要用雙引號括起來。
  • `/M`：這個參數很關鍵！如果你加上 `/M`，表示你要設定「系統變數」（需要管理員權限）。如果沒有 `/M`，則預設是設定「使用者變數」。

範例：

setx JAVA_HOME "C:\Program Files\Java\jdk-17"  # 設定使用者變量 JAVA_HOME
setx JAVA_HOME "C:\Program Files\Java\jdk-17" /M # 設定系統變量 JAVA_HOME (需要管理員權限)

setx PATH "%PATH%;C:\MyCustomScripts"           # 在使用者 PATH 後面追加路徑
setx PATH "%PATH%;C:\MySystemTools" /M         # 在系統 PATH 後面追加路徑 (需要管理員權限)

使用 `setx` 時要特別注意幾點：

  • `setx` 設定的變量不會立即在當前的命令提示字元或 PowerShell 會話中生效。你必須關閉當前的視窗，然後再打開一個新的視窗，才能看到變更。
  • 當你用 `setx` 修改 `PATH` 這樣的複雜變量時，務必小心。如果 `”%PATH%”` 引用的當前 `PATH` 值太長（超過 1024 個字元，儘管現代 Windows 版本已有所改善），可能會導致截斷問題。所以，通常建議是小幅度的追加，或者在 GUI 介面中修改 `Path` 更保險。
  • 執行設定系統變量（帶 `/M` 參數）的 `setx` 指令時，你必須以管理員身份運行命令提示字元或 PowerShell。

方法三：透過 PowerShell 腳本

對於更複雜或自動化的部署情境，PowerShell 提供了更強大的功能來管理環境變量。

設定使用者變量：

[Environment]::SetEnvironmentVariable("MY_USER_VAR", "UserValue", "User")

設定系統變量：

[Environment]::SetEnvironmentVariable("MY_SYSTEM_VAR", "SystemValue", "Machine")

將路徑添加到現有的 `Path` 變量中（使用者或系統）：

$oldPath = [Environment]::GetEnvironmentVariable("Path", "User") # 或 "Machine"
[Environment]::SetEnvironmentVariable("Path", "$oldPath;C:\NewPathForUser", "User")

這種方式的好處是，你可以用腳本批量處理，而且語法更嚴謹，非常適合企業環境的自動化部署。

總之，Windows 的環境變量設定彈性很大，看你的需求和偏好來選擇最合適的方法囉！我個人還是最愛用 GUI，因為它直觀、不容易出錯，對新手也最友善。

macOS 系統如何添加環境變量？掌握 Shell 設定檔是關鍵！

macOS 系統骨子裡是基於 Unix 的，所以它的環境變量設定方式會跟 Linux 非常相似，主要都是透過編輯 Shell 的設定檔來實現。對於剛從 Windows 轉過來的朋友來說，這可能會有點陌生，但一旦你掌握了核心概念，就會發現它其實非常靈活且強大！

macOS 的 Shell 環境：Bash 和 Zsh

在深入設定之前，我們要先了解 macOS 使用的是哪種 Shell。從 macOS Catalina (10.15) 開始，蘋果已經將預設的 Shell 從 Bash 換成了 Zsh。所以，根據你 macOS 的版本和你個人是否有調整過預設 Shell，你需要編輯不同的設定檔。

  • 如果你使用 Bash (舊版 macOS 或手動切換)：

    • 主要設定檔：~/.bash_profile (登入 Shell 時執行)
    • 次要設定檔：~/.bashrc (互動式非登入 Shell 時執行)
  • 如果你使用 Zsh (macOS Catalina 及以後版本預設)：

    • 主要設定檔：~/.zshrc (所有 Zsh 實例執行)

通常，我們會在 .bash_profile 或 .zshrc 裡面來設定環境變量。如果你不確定自己用的是哪種 Shell，可以打開終端機，輸入 `echo $SHELL`，它就會告訴你啦！

方法一：編輯 Shell 設定檔（最常用且推薦！）

這是一個修改使用者環境變量最常見也最推薦的方式。透過文字編輯器來編輯隱藏在使用者主目錄下的 Shell 設定檔。

  1. 打開終端機：

    • 在「應用程式」>「工具程式」裡找到「終端機」，或者直接用 Spotlight (Command + Space) 搜尋「終端機」打開。
  2. 判斷要編輯哪個檔案：

    • 輸入 `echo $SHELL`，如果顯示 `/bin/bash`，就編輯 `.bash_profile` 或 `.bashrc`。
    • 如果顯示 `/bin/zsh`，就編輯 `.zshrc`。
    • 一般來說，對於 macOS，.bash_profile 和 .zshrc 是比較推薦用來設定永久環境變量的檔案，因為它們會在登入時被執行。
  3. 使用文字編輯器打開檔案：

    • 你可以用終端機內建的 `nano` 或 `vim` 編輯器，例如： 
      nano ~/.zshrc  # 如果你用 Zsh
nano ~/.bash_profile # 如果你用 Bash
    • 或者，你也可以用圖形化介面的文字編輯器，比如 TextEdit，但記得要顯示隱藏檔案，並存成純文字檔。不過我個人推薦在終端機裡直接用 `nano`，簡單又快速。
  4. 新增或編輯環境變量：

    • 在檔案的任何地方（通常我們會加在檔案的末尾，方便管理），新增以下語法來設定變量： 
      export 變數名稱="/path/to/your/program"
    • 範例 – 設定 `JAVA_HOME`： 
      export JAVA_HOME="/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home"

      記得這個路徑要換成你 JDK 實際安裝的路徑喔！你可以用 `sudo /usr/libexec/java_home -v 17` 來查詢 JDK 17 的路徑。

    • 範例 – 添加路徑到 `PATH`：

      export PATH="/usr/local/bin:$PATH:/opt/homebrew/bin"

      這裡有幾個重點：

      • $PATH 表示引用現有的 `PATH` 值。
      • 新路徑和 `$PATH` 之間用冒號 `:` 分隔。
      • 順序很重要！如果你的自定義工具跟系統內建工具有同名指令，那麼哪個路徑排在前面，就會優先執行那個路徑裡的指令。通常，我們會把自定義或第三方工具的路徑放在 `$PATH` 的前面。
      • 例如，Homebrew 安裝的程式通常會在 `/opt/homebrew/bin` (M1 Mac) 或 `/usr/local/bin` (Intel Mac) 裡。
  5. 保存檔案並退出編輯器：

    • 如果你用 `nano`：按下 `Ctrl + O` (寫入檔案)，然後按 `Enter` 確認，最後按 `Ctrl + X` (退出)。
  6. 讓變量生效：

    • 方法一（推薦）： 關閉當前的終端機視窗，然後重新打開一個新的終端機視窗。這樣，新的 Shell 會話就會自動載入你的設定檔。
    • 方法二： 在當前終端機中手動載入設定檔： 
      source ~/.zshrc  # 如果你編輯的是 .zshrc
source ~/.bash_profile # 如果你編輯的是 .bash_profile

      或者也可以用簡寫：` . ~/.zshrc` (注意 source 後面有一個空格和一個點)。

我的經驗是，如果你只是要為自己設定一些開發環境，編輯 `~/.zshrc` 或 `~/.bash_profile` 絕對是最乾淨、最方便的做法。這樣不會影響到其他使用者，而且也很好管理。

方法二：使用 `launchctl` 設定系統級別的環境變量（較少用，針對 GUI 應用）

你可能會發現，有些環境變量只在終端機中生效，而你在圖形介面（GUI）中啟動的應用程式（例如某些 IDE）卻無法讀取到這些變量。這是因為 GUI 應用程式通常不會載入 Shell 的設定檔。這時候，你需要用到 `launchctl` 來設定。

這個方法稍微複雜一些，而且在 macOS 較新的版本中，蘋果官方建議透過其他更現代的方式（例如 `defaults write` 或應用程式自身的設定）來解決特定應用程式的需求，而不是普遍使用 `launchctl` 來設定全局環境變量。

不過，如果真的有需要，你可以這樣做：

  1. 建立或編輯 `launchd` 代理設定檔：

    • 在 `~/Library/LaunchAgents/` 目錄下建立一個 `.plist` 檔案，例如 `my.environment.plist`。
    • 檔案內容大致如下： 
      <?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>Label</key>
    <string>my.environment</string>
    <key>ProgramArguments</key>
    <array>
        <string>sh</string>
        <string>-c</string>
        <string>
            launchctl setenv MY_VARIABLE "my_value";
            launchctl setenv PATH "/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin:$HOME/bin:/opt/homebrew/bin"
        </string>
    </array>
    <key>RunAtLoad</key>
    <true/>
</dict>
</plist>
    • 請把 `MY_VARIABLE` 和 `my_value` 換成你實際需要的變數名稱和值。對於 `PATH` 變量，你需要明確列出所有路徑，因為這裡不會自動繼承 Shell 的 `PATH`。
  2. 載入設定檔：

    • 打開終端機，輸入： 
      launchctl load ~/Library/LaunchAgents/my.environment.plist
  3. 重啟或重新登入：

    • 最保險的做法是重新啟動你的 macOS，或者至少登出再登入，這樣才能確保 `launchd` 代理被正確載入。

這個方法比較「重量級」，如果只是為了一個特定的應用程式，我會建議先檢查該應用程式是否有自己的設定檔或環境變量配置方式。真的不行再考慮 `launchctl` 吧！

方法三：系統級別的設定（不推薦普通用戶修改）

在 `/etc/profile` 或 `/etc/paths` 這些檔案中設定，會對所有使用者生效。然而，蘋果官方建議不要直接修改這些系統級別的檔案，因為它們可能會在系統更新時被覆蓋，而且這樣做會影響到所有用戶，潛在風險較大。除非你是系統管理員，有非常明確的需求，否則強烈建議使用編輯使用者主目錄下的 Shell 設定檔就好。

總之，macOS 環境變量的核心就是 Shell 設定檔，掌握了它，你的開發之路就能順暢許多啦！

Linux 系統如何添加環境變量？多種方法滿足不同需求！

Linux 系統在環境變量的處理上，跟 macOS 其實非常相似，因為兩者都基於 Unix。不過，由於 Linux 的發行版眾多，Shell 的選擇也很多元，所以設定環境變量的方式也會有更多的彈性，但核心概念都是一樣的：透過編輯設定檔來告知系統。

Linux 環境變量的作用域：臨時、使用者、系統

在 Linux 中，你可以根據變量的作用範圍，選擇不同的設定方法：

  • 臨時變量（Temporary）： 只在當前 Shell 會話中生效，關閉終端機就消失。
  • 使用者變量（User-specific Persistent）： 對某個特定使用者永久生效。
  • 系統變量（System-wide Persistent）： 對所有使用者永久生效。

方法一：臨時添加環境變量（只在當前會話生效）

如果你只是想在當前終端機會話中測試一個變量，或者臨時執行某個命令，這個方法最簡單。只要在終端機中直接輸入指令就好。

語法：

export 變數名稱="變數值"

範例 – 設定 `MY_TEMP_VAR`：

export MY_TEMP_VAR="Hello World"
echo $MY_TEMP_VAR  # 輸出：Hello World

範例 – 添加路徑到 `PATH`：

export PATH="/opt/my_tool/bin:$PATH"

這樣，`/opt/my_tool/bin` 就被加到了當前會話的 `PATH` 中。請注意，當你關閉這個終端機視窗後，這個變量就會消失。

方法二：使用者級別的永久環境變量（最常用且推薦！）

這是最常見的方式，設定後只對你當前登入的使用者生效，而且是永久的。

Linux 上最常用的 Shell 是 Bash，所以我們通常會編輯 Bash 的設定檔。如果你使用的是其他 Shell，比如 Zsh，那檔案名稱會有所不同 (例如 `~/.zshrc`)，但編輯方式是相似的。

  1. 打開終端機：

    • 任何 Linux 發行版都有內建終端機。
  2. 編輯 Shell 設定檔：

    • ~/.bashrc： 這是互動式 Shell 最常使用的設定檔。每次打開新的終端機視窗時都會讀取。 
      nano ~/.bashrc
    • ~/.profile： 這是登入時執行一次的設定檔，常用於設定 X 會話的環境變量，或者在沒有圖形介面登入時使用。 
      nano ~/.profile
    • ~/.bash_profile： 如果存在，這個檔案會在登入時優先於 `.profile` 和 `.bashrc` 執行。在某些系統上，它可能用來呼叫 `.bashrc`。 
      nano ~/.bash_profile

    我的建議： 對於大多數日常使用，把環境變量加到 ~/.bashrc 是最直觀和常用的做法，因為每次打開新的終端機都能直接使用。如果你不確定，可以先從 ~/.bashrc 開始。

  3. 新增或編輯環境變量：

    • 在檔案的末尾，加入 `export` 語法。
    • 範例 – 設定 `JAVA_HOME`： 
      export JAVA_HOME="/opt/jdk-17"
export PATH="$JAVA_HOME/bin:$PATH" # 通常會把 JAVA_HOME/bin 也加到 PATH

      記得替換成你實際的 JDK 安裝路徑。

    • 範例 – 添加自定義路徑到 `PATH`： 
      export PATH="/home/your_user/scripts:$PATH"
  4. 保存檔案並退出編輯器：

    • 如果你用 `nano`：按下 `Ctrl + O`，然後按 `Enter`，最後按 `Ctrl + X`。
  5. 讓變量生效：

    • 方法一（推薦）： 關閉當前的終端機視窗，然後重新打開一個新的終端機視窗。這樣，新的 Shell 會話就會自動載入你的設定檔。
    • 方法二： 在當前終端機中手動載入設定檔： 
      source ~/.bashrc  # 如果你編輯的是 .bashrc
source ~/.profile # 如果你編輯的是 .profile

      或者簡寫：`. ~/.bashrc`。

方法三：系統級別的永久環境變量（影響所有使用者）

如果你希望某個環境變量對所有登入使用者都生效，那麼就需要編輯系統級別的設定檔。這通常需要 `sudo` 權限。

  1. /etc/environment：

    • 這是設定系統範圍環境變量最推薦的地方，因為它非常簡潔，每個變量一行，格式是 `變數名稱=變數值`。這個檔案在系統啟動時就會被讀取，並且它不會執行任何腳本，只處理簡單的鍵值對。 
      sudo nano /etc/environment
    • 範例： 
      PATH="/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/games:/usr/local/games"
MY_GLOBAL_VAR="GlobalValue"

      注意： 修改 `PATH` 時，記得要包含現有的系統路徑，否則可能會導致系統命令無法執行！

    • 修改後，通常需要重新啟動系統才能完全生效，或者至少重新登入所有受影響的使用者。
  2. /etc/profile：

    • 這是所有使用者登入時都會執行一次的 Shell 腳本。它通常會再去呼叫 `/etc/profile.d/` 目錄下的腳本。 
      sudo nano /etc/profile
    • 在這裡你可以使用 `export` 語法來設定變量，跟使用者設定檔一樣。
    • 由於它是一個 Shell 腳本，所以可以包含更複雜的邏輯。
    • 變更後需要重新登入所有使用者才能生效。
  3. /etc/profile.d/ 目錄：

    • 這是更優雅且推薦的方式，用於添加系統級別的環境變量。你可以為每個應用程式或變量建立一個獨立的 `.sh` 腳本檔案（例如 `java.sh`），放在這個目錄下。這些腳本會被 `/etc/profile` 自動載入。 
      sudo nano /etc/profile.d/my_custom_vars.sh
    • 範例 `my_custom_vars.sh` 內容： 
      # 設定 JAVA_HOME
export JAVA_HOME="/usr/lib/jvm/java-17-openjdk-amd64"
# 將 JDK 的 bin 目錄加入 PATH
export PATH="$JAVA_HOME/bin:$PATH"
    • 記得給予這個腳本執行權限：`sudo chmod +x /etc/profile.d/my_custom_vars.sh`。
    • 變更後，同樣需要重新登入所有使用者才能生效。

小提醒： 修改系統級別的檔案時，務必小心再小心，最好先備份原始檔案，以防萬一。錯誤的設定可能會導致系統行為異常，甚至無法登入喔！

總結 Linux 設定方式：

| 作用域 | 設定檔案 / 指令 | 永久性 | 立即生效 | 備註 |
| :—- | :————— | :—– | :—— | :— |
| 臨時 | `export VAR=”VALUE”` | 否 | 是 | 僅限當前會話 |
| 使用者 | `~/.bashrc` / `~/.profile` / `~/.bash_profile` | 是 | 需 `source` 或重啟終端機 | 最常用，只影響單一用戶 |
| 系統 | `/etc/environment` | 是 | 需重啟或重登 | 簡單鍵值對，影響所有用戶 |
| 系統 | `/etc/profile` | 是 | 需重啟或重登 | Shell 腳本，影響所有用戶 |
| 系統 | `/etc/profile.d/*.sh` | 是 | 需重啟或重登 | 推薦，模組化管理，影響所有用戶 |

我的建議是，如果你只是個人使用，那編輯使用者家目錄下的 `.bashrc` 或 `.profile` 就夠了。如果是伺服器環境，或者需要多個使用者都能用到某個工具，那 `/etc/profile.d/` 就是個很棒的選擇，方便管理又不容易出錯。

環境變量設定的眉角：最佳實踐與常見疑難雜症

雖然我們已經學會了如何添加環境變量，但在實際操作中，還是有一些小細節、小「眉角」需要注意，才能讓你的設定更穩固、更有效率，也能避免一些常見的「踩雷」狀況喔！

最佳實踐：讓你的環境變量設定更優雅

  1. 優先使用使用者變量：

    • 除非你的應用程式或工具真的需要被所有使用者共享，否則盡量只設定「使用者變量」。這樣做可以減少對整個系統的潛在影響，萬一設錯了，也比較容易恢復，不會影響到其他人。
  2. `PATH` 變量的順序很重要：

    • 當系統尋找執行檔時，它會按照 `PATH` 中列出的路徑順序依序查找。這意味著，如果你在 `PATH` 中有兩個不同位置的程式名稱相同，那麼排在前面的路徑會優先被找到並執行。
    • 建議： 將你自定義的工具路徑放在 `$PATH` 的前面（例如：`export PATH=”/my/custom/path:$PATH”`）。這樣可以確保你安裝的特定版本或自定義工具，優先於系統預設的同名工具被執行。
  3. 使用絕對路徑，避免相對路徑：

    • 在設定環境變量時，務必使用完整的「絕對路徑」，例如 `C:\Program Files\Java\jdk-17` 或 `/opt/homebrew/bin`。避免使用相對路徑，因為相對路徑會根據當前工作目錄而變化，容易造成混亂和錯誤。
  4. 善用其他環境變量來構建路徑：

    • 例如，如果你已經設定了 `JAVA_HOME`，那麼在將其 `bin` 目錄添加到 `PATH` 時，就可以寫成 `export PATH=”$JAVA_HOME/bin:$PATH”`。這樣做的好處是，當你的 JDK 升級或移動位置時，只需要修改 `JAVA_HOME` 一處，相關的 `PATH` 就會自動更新，方便管理。
  5. 加入註解，保持整潔：

    • 在 Shell 設定檔（例如 `.zshrc` 或 `.bashrc`）中，可以使用 `#` 符號來添加註解。清楚地標明每個變量的用途，這樣將來回頭看或其他人接手時，都能一目瞭然。
      • # 設定 Java 開發套件的根目錄
export JAVA_HOME="/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home"

# 將 Maven 的 bin 目錄添加到 PATH
export M2_HOME="/usr/local/Cellar/maven/3.8.6"
export PATH="$M2_HOME/bin:$PATH"
  6. 備份你的設定檔：

    • 特別是對於 `.bashrc`、`.zshrc` 這些重要的 Shell 設定檔，在進行大幅修改之前，最好先備份一份。萬一改錯了，也能快速恢復。你可以簡單地複製一份：`cp ~/.zshrc ~/.zshrc.bak`。

常見疑難雜症與解決之道

設定環境變量時，有時候會遇到一些意想不到的問題，別擔心，這些都是常見的「小狀況」，通常都有辦法解決的！

  1. 「我設定了，但為什麼沒生效？」

    • 最常見的原因： 你可能沒有「重新載入」設定檔或「重新啟動」相關程式。記住，修改完環境變量後，當前正在運行的 Shell 或應用程式是不知道這些變化的。你需要：
      • 終端機： 關閉當前終端機，重新打開一個新的；或者使用 `source ~/.bashrc` (或其他對應的設定檔) 指令。
      • Windows GUI 應用： 完全關閉應用程式，再重新啟動。有時甚至需要重新開機。
    • 檢查拼寫： 變數名稱或路徑是否拼寫錯誤？大小寫是否正確？在 Linux/macOS 中，環境變量是區分大小寫的。
    • 設定檔案是否正確： 你編輯的是 `~/.bashrc` 還是 `~/.profile`？你確定你的 Shell 是 Bash 還是 Zsh？
    • `PATH` 路徑是否包含空格： 在 Windows，如果路徑有空格，一定要用雙引號括起來。在 Linux/macOS，如果路徑有空格，需要用反斜線 `\` 進行轉義。
  2. 「我添加到 `PATH` 了，但還是找不到指令！」

    • 路徑是否正確： 確保你加入 `PATH` 的是程式「執行檔所在的目錄」，而不是執行檔本身。例如，Python 的 `bin` 目錄，而不是 `python.exe`。
    • 順序問題： 你的新路徑可能被排在 `PATH` 中其他包含同名指令的路徑後面，導致系統先找到舊的或錯誤的指令。試著把你的新路徑放到 `$PATH` 的最前面。
    • 執行權限： 在 Linux/macOS 中，確保該執行檔有執行權限（`chmod +x filename`）。
  3. 「Windows 的 `Path` 編輯器太複雜，我怕弄壞。」

    • 別怕！Windows 10/11 的 `Path` 編輯器已經很友善了，每個路徑都獨立一行。你可以先複製所有現有路徑到一個文字檔中備份，再進行修改。如果你不小心刪錯了，還可以從備份中找回。
    • 如果真的不確定，可以先試著添加為「使用者變量」的 `Path`，這樣影響範圍較小。
  4. 「我設定了系統變量，但為什麼其他使用者看不到？」

    • 你可能設定成了「使用者變量」，而不是「系統變量」。檢查一下你是在「使用者變數」區塊還是「系統變數」區塊進行的設定（Windows）。
    • 在 Linux/macOS 中，你是否編輯了 `/etc/environment`、`/etc/profile` 或 `/etc/profile.d/` 目錄下的檔案？並且確保有使用 `sudo` 權限進行編輯。
    • 修改後，其他使用者需要「重新登入」才能看到新的系統變量。
  5. 「如何查看我當前的環境變量？」

    • Windows (CMD)： 輸入 `set` 即可列出所有環境變量。
    • Windows (PowerShell)： 輸入 `Get-ChildItem Env:` 即可列出。
    • Linux/macOS： 輸入 `env` 或 `printenv` 即可列出所有環境變量。輸入 `echo $變數名稱` 可以查看特定變量的值，例如 `echo $PATH`。

總之，環境變量的設定雖然有些細節，但只要耐心一點，理解了背後的邏輯，這些問題都能迎刃而解的。多試試看，你就會越來越熟練了！

常見問題與深度解答

問：環境變量是區分大小寫的嗎？

答： 這個問題的答案取決於你使用的作業系統。

在 Linux 和 macOS 這類基於 Unix 的系統中，環境變量是嚴格區分大小寫的。舉例來說，`MY_VARIABLE` 和 `my_variable` 會被視為兩個完全不同的環境變量。所以當你在設定或引用環境變量時，務必確保名稱的大小寫完全一致，否則系統就找不到你設定的變量了。

然而，在 Windows 系統中，環境變量名稱在大多數情況下是不區分大小寫的。這表示 `Path`、`PATH` 和 `path` 都會被系統視為同一個環境變量。儘管如此，我個人還是會強烈建議大家在使用環境變量時，盡量保持一致的大小寫習慣（例如 `PATH` 或 `JAVA_HOME`），這樣不僅程式碼的可讀性更好，也能避免在跨平台開發時可能出現的混淆或問題。

總之，為了保險起見和良好的習慣，將環境變量視為區分大小寫來處理會是比較穩妥的做法喔！

問：我可以在命令列中永久刪除環境變量嗎？

答： 可以，但方式同樣會因作業系統而異。

在 Windows 系統中，你可以使用 `setx` 指令來「刪除」一個永久性的環境變量，但它不是直接的刪除指令，而是將變數值設為空：

setx 變數名稱 ""   # 刪除使用者變量
setx 變數名稱 "" /M # 刪除系統變量 (需要管理員權限)

請注意，與設定變量一樣，這個操作也不會立即在當前命令提示字元或 PowerShell 會話中生效，你需要打開新的視窗才能確認。另外，如果你想移除 `PATH` 中的某個特定路徑，則需要先獲取 `PATH` 的當前值，將想移除的路徑去除後，再用 `setx` 重新設定新的 `PATH` 值。

在 Linux 和 macOS 系統中，如果你在 Shell 設定檔（如 `~/.bashrc` 或 `~/.zshrc`）中設定了變量，最直接的方式是打開這些檔案，刪除或註解掉對應的 `export` 行。刪除後，你需要重新載入設定檔 (`source ~/.bashrc`) 或重新打開終端機，變量才會被移除。

如果你想在當前會話中「取消設定」一個臨時變量，可以使用 `unset` 指令：

unset 變數名稱

例如，`unset MY_TEMP_VAR` 會在當前會話中移除 `MY_TEMP_VAR`。但這只影響當前會話，不會對永久設定造成影響。

對於系統級別的變量（例如在 `/etc/environment` 或 `/etc/profile.d/` 中設定的），你同樣需要編輯或刪除對應的檔案內容，並在之後重新登入或重啟系統才能讓變更生效。無論如何，在刪除或修改永久環境變量之前，都建議先備份喔！

問：什麼是 Shell 環境變量和系統環境變量的區別？

答： 這個問題問得很好，雖然在文章前面有稍微提到，但我們來更深入地釐清一下。Shell 環境變量和系統環境變量，其實是從不同層面來描述環境變量的作用範圍。

當我們談論 「Shell 環境變量」 時，我們通常指的是那些只在當前 Shell 進程及其子進程中生效的變量。這類變量可以細分為兩種：

  1. 臨時性的 Shell 變量： 透過 `VAR=VALUE` 或 `export VAR=VALUE` 指令直接在終端機中設定。它們只存在於當前的終端機會話中，當你關閉終端機，這些變量就會消失，不會被寫入任何設定檔。它們是最短暫、作用範圍最小的環境變量。
  2. 永久性的使用者級別 Shell 變量： 這些變量是透過編輯使用者的 Shell 設定檔（例如 Linux/macOS 的 `~/.bashrc`、`~/.zshrc` 或 Windows 的使用者環境變數）來設定的。它們會在每次使用者登入或開啟新的 Shell 時被載入，因此是永久的，但僅對該特定使用者有效。這其實是使用者環境變量最常見的實現方式。

而 「系統環境變量」 則是作用範圍更廣的變量。它們對整台電腦上的所有使用者帳戶都有效，甚至對一些系統服務和啟動腳本也可能產生影響。這類變量通常是在系統啟動時被載入的，或者是在特定的系統級別設定檔中定義的。在 Windows 中，就是「系統變數」區塊；在 Linux/macOS 中，則通常是透過 `/etc/environment`、`/etc/profile` 或 `/etc/profile.d/` 等檔案來設定。

它們的主要區別在於作用範圍和持久性：

  • 作用範圍：

    • Shell 環境變量（使用者級別）： 僅影響設定它的使用者帳戶。
    • 系統環境變量： 影響所有使用者帳戶以及整個系統。
  • 持久性：

    • 臨時的 Shell 變量： 非永久，關閉會話即消失。
    • 永久的 Shell 變量（使用者級別）與系統環境變量： 都是永久的，會被保存下來並在每次啟動時載入。

理解這兩者的區別，能幫助你在設定環境變量時做出更明智的選擇，確保你的設定只影響到需要影響的範圍，同時也方便日後的管理和除錯喔！

結語

哇，不知不覺我們已經走完了一趟深度探索環境變量的旅程！從一開始的「找不到指令」困惑，到現在你應該對「如何添加環境變量」有了全面而深入的了解了吧？

環境變量這個概念，雖然剛接觸時可能覺得有點硬，但它確實是電腦系統運作的基石之一，更是每個開發者、系統管理員，甚至是進階使用者都應該掌握的基本技能。掌握了它，你就能更自由地配置你的開發環境、更順暢地執行各種工具和程式，告別那些令人惱火的錯誤訊息。

記住，無論是 Windows、macOS 還是 Linux，核心邏輯都是一樣的：就是告訴系統去哪裡找東西。只是不同系統有不同的「表達方式」和「設定地點」罷了。多動手試試看，你會發現這些看似複雜的設定，其實沒那麼可怕，而且還能讓你的電腦變得更聽話、更好用喔！

希望這篇文章能幫助到你，讓你在學習和使用電腦的路上，走得更穩、更遠！

如何添加環境變量