想一次掌握一個活頁簿裡「所有分頁」？getSheets() 就是入口。它會回傳目前試算表中的所有工作表（含隱藏），讓你能批量讀寫、命名、排序、顯示/隱藏，甚至產生「分頁目錄」。官方文件明確說明：Spreadsheet.getSheets() 會取得此活頁簿中的 Sheet 陣列。

管理一個 Google 試算表還好，但當分頁越長越像火車編號時，要找資料、重排順序、產出月報就開始卡。其實關鍵只差一個入口：getSheets()。

它一次把整本活頁簿的所有分頁抓到手上（包含被你藏起來的），之後要列清單、批次改名、依規則排序、建立「分頁目錄」、甚至快速隱藏不相干頁，都能一次到位。希望本篇文章可以幫助到需要的您。

function listAllSheets() {
  const ss = SpreadsheetApp.getActiveSpreadsheet(); // 取得目前活頁簿
  const sheets = ss.getSheets();                     // 取得所有分頁（含隱藏）
  const summary = sheets.map(sh => ({
    name: sh.getName(),
    id: sh.getSheetId(),
    index1Based: sh.getIndex(),
    hidden: sh.isSheetHidden()
  }));
  Logger.log(JSON.stringify(summary, null, 2));
}

小提醒：getActiveSpreadsheet()／getActiveSheet() 等常用入口都在 SpreadsheetApp，官方說明可查。

核心用法範例

列出所有分頁名稱與 ID（附輸出到新表）

function exportSheetCatalog() {
  const ss = SpreadsheetApp.getActiveSpreadsheet();
  const sheets = ss.getSheets();
  const out = [['Name', 'Sheet ID', 'Index(1-based)', 'Hidden?']];
  for (const sh of sheets) {
    out.push([sh.getName(), sh.getSheetId(), sh.getIndex(), sh.isSheetHidden()]);
  }
  const toc = ss.getSheetByName('目錄') || ss.insertSheet('目錄'); // 若無則建立
  toc.clear();
  toc.getRange(1, 1, out.length, out[0].length).setValues(out);
  toc.autoResizeColumns(1, out[0].length);
}

只挑「可見」分頁

function getVisibleSheets() {
  const sheets = SpreadsheetApp.getActive().getSheets();
  return sheets.filter(sh => !sh.isSheetHidden()); // true=隱藏
}

判斷可見性靠 isSheetHidden()

依名稱排序／依索引排序

function sortSheetsByNameAsc() {
  const ss = SpreadsheetApp.getActive();
  const sheets = ss.getSheets().slice().sort((a, b) => a.getName().localeCompare(b.getName()));
  // 依新順序搬動：注意 getIndex() 是 1 起算
  sheets.forEach((sh, i) => ss.setActiveSheet(sh).moveActiveSheet(i + 1));
}

批次隱藏/顯示（避免把唯一可見分頁也隱藏）

function hideSheetsByPrefix(prefix) {
  const ss = SpreadsheetApp.getActive();
  const sheets = ss.getSheets();
  const visible = sheets.filter(s => !s.isSheetHidden());
  for (const sh of sheets) {
    if (sh.getName().startsWith(prefix) && visible.length > 1) {
      sh.hideSheet(); // 唯一可見分頁不可被隱藏，否則會拋錯
    }
  }
}
function showAllSheets() {
  SpreadsheetApp.getActive().getSheets().forEach(sh => sh.showSheet());
}

跨檔案抓分頁

function listOtherFileSheets(fileId) {
  const ss = SpreadsheetApp.openById(fileId);
  return ss.getSheets().map(s => ({ name: s.getName(), id: s.getSheetId() }));
}