環境變數

路徑：【後台管理】⇒【系統管理】⇒【環境變數】

環境變數用於將 會隨環境而異、或可能需要調整的參數值（例如網域名稱、服務位址、模型名稱、對接參數等）集中存放於系統中，供其他模組以 變數名稱 取用。

其主要用處在於 把參數值與使用位置分離：

集中維護：同一參數被多處引用時，只需修改環境變數一處，所有引用位置即同步生效，不必逐一調整設定。
環境切換：測試環境與正式環境可使用相同的變數名稱、不同的變數值，搬移設定時無須改動引用該變數的內容。
降低誤植：以具意義的變數名稱取代直接填寫數值，減少各處重複輸入所造成的不一致。

note

環境變數屬於系統層級的設定，僅供超級管理員（Admin）與系統管理員操作，子管理員無此模組的操作權限。詳細權限差異請參閱 管理員設定 章節的權限對照表。

1. 變數分類

環境變數採 「先分類、再建變數」 的架構：畫面左側為 【分類】 清單，右側則顯示所選分類底下的變數列表。分類用於將性質相近的變數歸類存放，變數數量增加時仍能快速定位。

📌 首次使用：先建立分類

系統尚未建立任何分類時，頁面會呈現空白狀態，並提示 『新增環境變數前，請先新增分類』，畫面中央提供 『新增分類』 按鈕。

點選畫面中央的 『新增分類』，開啟 【新增分類】 視窗。
於 顯示名稱 欄位輸入分類名稱（必填）。
點選 『確定』 完成新增；若不新增則點選 『取消』。

建立成功後，畫面上方會顯示 『新增分類成功』 的提示，左側 【分類】 清單隨即出現該分類，右側則切換為變數列表。

📌 新增其他分類

已存在分類後，可點選左側 【分類】 標題右方的 『＋』 圖示，開啟同樣的 【新增分類】 視窗，繼續建立其他分類。

📌 切換與刪除分類

切換分類：點選左側清單中的分類名稱，右側列表即會切換為該分類下的變數。
刪除分類：將滑鼠移至分類項目上，點選右方的 垃圾桶圖示 即可刪除。

2. 新增環境變數

於右上角點選 『新增』，右側會滑出 【新增環境變數】 面板。

📌 欄位說明

變數名稱（必填）：變數的識別名稱，也是其他模組引用此變數時所使用的鍵值，建議採用 英文、具描述性且不重複 的命名（例如 domain）。
變數類型：目前固定為 『文字』，欄位呈現灰階且不可修改。
變數值（必填）：該變數實際存放的內容（例如 goojob.com.tw）。
變數分類（必填）：選擇變數所屬的分類，預設為 『請選擇』，下拉選項即為左側 【分類】 清單中已建立的項目。
描述：變數用途的補充說明，便於後續維護者理解此變數的作用。

填寫完成後點選 『儲存』，畫面上方會顯示 『新增環境變數成功』，該筆變數即出現於所屬分類的列表中。

tip

若下拉選單中找不到合適的分類，請先於左側 【分類】 建立分類後，再回到此處新增變數。

3. 編輯與刪除

📌 編輯變數

點選操作欄的 『編輯』，即可開啟 【編輯環境變數】 面板調整內容。

編輯時 變數名稱 與 變數類型 呈現灰階且無法修改，可調整的項目為 變數值、變數分類 與描述。修改完成後點選 『儲存』 生效。

📌 刪除變數

點選操作欄的 『刪除』，即可將該變數自系統移除。

warning

刪除前請務必確認 無任何設定正在引用此變數。變數刪除後，原本取用該變數的位置將取不到值，可能導致對應功能執行失敗。

1. 變數分類​

📌 首次使用：先建立分類​

📌 新增其他分類​

📌 切換與刪除分類​

2. 新增環境變數​

📌 欄位說明​

3. 編輯與刪除​

📌 編輯變數​

📌 刪除變數​