巨集變數
為步驟屬性定義可重複使用的變數。

巨集變數讓你能定義具名數值,供巨集中的步驟參照。只修改一次數值,所有使用該變數的步驟就會自動更新 — 無需逐一編輯每個步驟。
變數類型
每個變數都有標籤(顯示名稱)、類型和預設值。共支援四種類型:
| 類型 | 預設值 | 使用範例 |
|---|---|---|
| 文字 | "" | 視窗標題、分享代碼 |
| 數字 | 0 | 延遲時間、重複次數 |
| 布林值 | false | 功能開關 |
| 按鍵 | A | 快捷鍵設定 |
定義變數
- 點擊步驟樹的空白區域(巨集根節點)開啟巨集屬性面板。
- 找到變數區塊,點擊新增變數。
- 為變數設定標籤 — 這會是使用該變數時到處顯示的名稱。
- 選擇與所需數值相符的類型。
- 設定變數的預設值。
注意: 內部變數名稱會自動根據標籤產生,必須以英文字母開頭,只能包含字母、數字和底線(
A-Za-z0-9_)。
在步驟中使用變數
編輯支援變數的步驟屬性時,輸入欄位旁會出現固定 / 變數切換開關:
- 固定模式 — 直接輸入固定值(預設)。
- 變數模式 — 切換為下拉選單,僅列出類型符合該屬性的變數。選取變數即可參照它。
當屬性參照了變數,步驟樹中會以 ${標籤} 格式顯示,讓你一眼看出哪些步驟使用了變數。
以下步驟屬性支援變數:按鍵輸入、延遲、逾時、重複次數、滑鼠座標、滾輪格數、圖片比對信心度、網格行列數等。
重新命名變數
重新命名變數標籤時,所有參照該變數的步驟會自動更新。如果新名稱與既有變數衝突,會自動加上數字後綴(例如 my_var_2)以保持名稱唯一。
刪除變數
如果你刪除仍被步驟使用的變數,系統會彈出確認對話框警告這些步驟將失效,直到修正參照為止。刪除後,任何參照已刪除變數的步驟會在執行巨集時報錯,直到你賦予新的數值。
複製與貼上
複製含有變數參照的步驟時,這些變數會自動被收集,並在貼上時合併到目標巨集中:
- 若目標巨集已有同名且同值的變數,步驟會直接重用。
- 若名稱相同但值不同,貼上的變數會自動重新命名。
- 若目標巨集中沒有該變數,則會自動新增。
這樣就能安全地在巨集之間分享和重用步驟序列,而不會破壞變數參照。