在使用 Postman 測試 API 時,只要開始碰到多個環境、不同帳號或重複請求,就一定會用到「變數」。
把值抽成變數後,請求本身會變得乾淨,也比較不容易改錯。
這篇整理的是我實際使用 Postman 時,最常用、也最容易搞混的變數與環境參數觀念。什麼是 Postman 變數
Postman 的變數可以用來儲存並重複使用值,例如:
- API Base URL
- 帳號、Token
- 常用參數或路徑片段
設定成變數後,就能在整個集合、環境、請求或測試腳本中引用,避免到處複製貼上。
官方文件可參考:
https://learning.postman.com/docs/sending-requests/variables/
變數的基本用法
變數的使用方式很單純,使用 雙大括號 包住變數名稱:
{{account}}
即使這個變數還沒設定,也可以先直接打。
滑鼠移到未設定的變數上,Postman 會顯示提示訊息,提醒這個變數目前沒有值。

未設定的變數
未設定變數時會發生什麼事
當你看到變數底下出現提示,表示:
- 這個變數名稱存在
- 但目前還沒有任何作用範圍有設定值
此時可以直接點選 Add new Variable,進入設定畫面。

設定變數
變數設定欄位說明
新增或編輯變數時,會看到三個重點欄位:
- Name:變數名稱
- Value:實際使用的值
- Scope:變數的作用範圍
其中 Scope 是最多人一開始會搞混的地方。
變數的作用範圍(Scope)
Postman 的變數依作用範圍區分,常見有幾種:
- Global:整個 Postman 都能用
- Environment:只在指定環境中生效
- Collection:只在某一組 API Collection 中使用
- Local:只在單一請求或測試中暫時存在
實務上最常用的是 Environment 與 Collection。
如果你有「開發/測試/正式環境」,Base URL 幾乎一定會放在 Environment。
如果是某組 API 專用的參數,放在 Collection 會比較安全。

變數作用範圍
如何確認變數目前的值
當變數設定完成後,只要把滑鼠移到請求中的變數名稱上,就能看到:
- 目前實際使用的值
- 來自哪一個 Scope
這在除錯時非常有用,可以快速確認是不是用錯環境。

簡單使用情境整理
設定好變數後滑鼠指著變數就會顯示變數的資訊
幾個常見的搭配方式:
{{baseUrl}}/api/usersAuthorization: Bearer {{token}}- 測試腳本中先設定變數,再給下一個請求使用
只要習慣把「會重複出現的值」抽成變數,Postman 的可讀性會差很多。
補充文件
如果要更深入了解環境與管理方式,可以參考官方文件:












