本頁面由 Cloud Translation API 翻譯而成。

Google 試算表巨集

您可以使用 Google 試算表記錄巨集，這種巨集會複製您定義的一系列特定 UI 互動。錄製巨集後，您可以將其連結至格式為 Ctrl+Alt+Shift+Number 的鍵盤快速鍵。只要使用該捷徑，就能再次快速執行精確的巨集步驟，步驟通常是在不同的位置或資料中。您也可以從 Google 試算表的「擴充功能」>「巨集」選單啟用這個巨集。

當您錄製巨集時，Google 試算表會自動建立可複製巨集步驟的 Apps Script 函式 (巨集函式)。系統會將巨集函式新增至標題為 macros.gs 檔案的 Apps Script 專案繫結至工作表。如果專案檔案已繫結至使用該名稱的工作表，則會附加巨集函式。Google 試算表也會自動更新指令碼專案資訊清單，記錄指派給巨集的名稱和鍵盤快速鍵。

由於每個錄製的巨集完全是在 Apps Script 中定義，因此您可以直接在 Apps Script 編輯器中編輯。您甚至可以在 Apps Script 中從頭開始編寫巨集，或將已編寫的函式轉換成巨集。

在 Apps Script 中建立巨集

您可以擷取以 Apps Script 編寫的函式，並將其做為巨集函式使用。最簡單的做法是從 Google 試算表編輯器匯入現有函式。

或者，您也可以按照下列步驟，在 Apps Script 編輯器中建立巨集：

在 Google 試算表 UI 中，依序選取「Extensions」>「Apps Script」，在 Apps Script 編輯器中開啟繫結至工作表的指令碼。
編寫巨集函式。巨集函式不應包含引數，並且不會傳回任何值。
編輯您的指令碼資訊清單，建立巨集並連結到巨集函式。為其指派不重複的鍵盤快速鍵和名稱。
儲存指令碼專案。這樣就能在工作表中使用巨集。
測試工作表中的巨集函式，確認函式可正常運作。

編輯巨集

如要編輯已附加在工作表中的巨集，請按照下列步驟操作：

在 Google 試算表 UI 中，依序選取「擴充功能」>「巨集」>「管理巨集」。
找出要編輯的巨集，然後依序選取「」>「編輯巨集」。這會開啟 Apps Script 編輯器，前往包含巨集函式的專案檔案。
編輯巨集函式即可變更巨集行為。
儲存指令碼專案。這樣就能在工作表中使用巨集。
測試工作表中的巨集函式，確認函式可正常運作。

將函式匯入為巨集

如果指令碼已繫結至工作表，您可以在指令碼中import函式做為新巨集，然後為其指派鍵盤快速鍵。方法是編輯資訊清單檔案，然後將另一個元素新增至 sheets.macros[] 屬性。

或者，您也可以按照下列步驟，透過試算表 UI 匯入函式做為巨集：

在 Google 試算表 UI 中，依序選取「Extensions」>「Macros」>「Import」。
從顯示的清單中選取函式，然後按一下「新增函式」。
選取即可關閉對話方塊。
依序選取「擴充功能」>「巨集」>「管理巨集」。
在清單中找出剛才匯入的函式。為巨集指派專屬的鍵盤快速鍵。您也可以在這裡變更巨集名稱；名稱會預設為函式名稱。
按一下「更新」儲存巨集設定。

巨集資訊清單結構

下列資訊清單檔案範例程式碼片段顯示定義 Google 試算表巨集的資訊清單部分。資訊清單的 sheets 部分會定義指派給巨集的名稱和鍵盤快速鍵，以及巨集函式的名稱。

  {
    ...
    "sheets": {
      "macros": [{
        "menuName": "QuickRowSum",
        "functionName": "calculateRowSum",
        "defaultShortcut": "Ctrl+Alt+Shift+1"
      }, {
        "menuName": "Headerfy",
        "functionName": "updateToHeaderStyle",
        "defaultShortcut": "Ctrl+Alt+Shift+2"
      }]
    }
  }

如要進一步瞭解如何建構試算表巨集資訊清單，請參閱試算表巨集資訊清單資源。

最佳做法

使用 Apps Script 建立或管理巨集時，建議您遵循下列規範。

巨集在輕量的情況下效果較佳。請盡可能限制巨集執行的動作數量。
巨集最適合用於頻繁重複且幾乎不需要設定或未設定的老舊作業。如要執行其他作業，請考慮改用自訂選單項目。
請務必記住，巨集鍵盤快速鍵不得重複，而且特定工作表一次只能有 10 個含快速鍵的巨集。其他巨集只能從「Extensions」>「Macros」選單執行。
只要先選取完整範圍，再啟用巨集，就能對單一儲存格範圍套用變更的巨集。也就是說，您通常不需要建立巨集，以便在預先定義的儲存格範圍中複製同一項運算。

禁止執行的操作

巨集有一些限制：

在繫結指令碼外使用巨集

巨集是由指向特定 Google 試算表的指令碼所定義。如果您在獨立指令碼或網頁應用程式中定義了巨集定義，則系統會忽略這些定義。

在試算表外掛程式中定義巨集

您無法使用試算表外掛程式發布巨集定義。該外掛程式的使用者會忽略試算表外掛程式專案中的任何巨集定義。

在指令碼程式庫中發布巨集

您無法使用 Apps Script 程式庫發布巨集定義。

在 Google 試算表外部使用巨集

巨集僅適用於 Google 試算表的功能，不適用於 Google 文件、表單或簡報。