如果你常在試算表裡新增分頁、做月報或日報，應該遇過「命名一團亂、連結對不上」的慘劇。

其實只要用到一個方法——setName()——就能把改名這件事變得可預測、可複用。

本篇文章用白話步驟帶你上手：怎麼安全改名、什麼時候要先比對再改、要不要幫名字做清洗，以及批次改名該注意哪些節點。也會示範幾個日常情境：從 A1 取名、複製模板自動加日期、避免撞名加尾碼。文末整理雷點清單與最佳實務，讓你少走彎路，交出去的表格可讀又耐看。希望能幫助到需要的您。

function batchRenameByList() {
  const ss = SpreadsheetApp.getActiveSpreadsheet();
  const map = [
    ['Sheet1', '概況'],
    ['Sheet2', '訂單'],
    ['Sheet3', '庫存']
  ];
  map.forEach(([from, to]) => {
    const sh = ss.getSheetByName(from);
    if (sh && sh.getName() !== to) sh.setName(to);
  });
}

複製模板 → 依日期（或欄位值）命名

function duplicateTemplateWithDateName() {
  const ss = SpreadsheetApp.getActiveSpreadsheet();
  const tpl = ss.getSheetByName('TEMPLATE');
  const ymd = Utilities.formatDate(new Date(), Session.getScriptTimeZone(), 'yyyy-MM-dd');
  const copy = tpl.copyTo(ss).setName(`日報_${ymd}`); // 鏈式改名
}

這種流程常見在「每日產生工作表」的排程腳本。遇到「名稱已存在」要先處理（下面雷點有解）。官方文件也示範 copyTo() 的用法；setName() 的鏈式呼叫是被支援的。

進階：從儲存格動態命名

從 A1 讀值當作新名稱，並做一點清洗（去頭尾空白、換行、過長截斷）：

function renameByCellA1() {
  const sh = SpreadsheetApp.getActiveSheet();
  const raw = String(sh.getRange('A1').getValue() || '');
  let name = raw.trim().replace(/\s+/g, ' ');
  if (name.length === 0) throw new Error('A1 為空，無法命名');
  if (name.length > 100) name = name.slice(0, 100); // 和 UI 體感一致，保守截斷
  if (name !== sh.getName()) sh.setName(name);
}

備註：官方 setName() 文件沒有硬性「長度上限」說明，但實務上工作表分頁在 UI 呈現過長會難讀，建議自訂上限（例如 60–100 字元）。setName() 本身的使用與授權屬性以官方文件為準。

命名規範＆限制：哪些要注意？

名稱必須在同一份試算表中唯一：

同名會失敗（實務上常見於「先複製、後改名」但同名已存在）。工作流程或第三方工具也會拋出「name already exists」之類的錯誤。

字元：

Google Sheets 分頁名相對寬鬆（包含空白、中文、Emoji 通常可用）。遇到跨系統對接（例如把分頁名拿去當檔名或資料表鍵）才需要限制字元集。

觸發器：

onEdit、onChange 之類事件可能因為改名而連鎖觸發其它流程，要小心迴圈或重複執行。

官方對 Sheet.setName() 的定義與授權需求請以參考文件為準；若你同時在 Drive 端改檔名（DriveApp.File.setName()），是另一個不同層級，別混淆。

常見錯誤與雷點

1. 同名衝突（名字已被用）

症狀：複製模板後馬上改名，偶發失敗；或報「名稱已存在」。

處理：

function safeSetName(sh, want) {
  const ss = sh.getParent();
  const exists = ss.getSheets().some(s => s.getName() === want);
  if (exists) {
    const ts = Utilities.formatDate(new Date(), Session.getScriptTimeZone(), 'HHmmss');
    want = `${want}_${ts}`; // 或加流水號
  }
  return sh.setName(want);
}

在某些整合工具／流程裡，確實會看到「name already exists」的錯誤訊息，需要先做重名檢查。

2. onEdit/onChange 觸發「雙重複製」

症狀：用 onEdit 搭 copyTo()，有時產生兩張副本（其中一張留著「Copy of …」）。

原因：同一事件被多次觸發（例如多儲存格編輯、保護規則、外掛同步），或你的邏輯在改名前後又被呼叫一次。

對策：

用「旗標欄位」或「鎖」機制（PropertiesService）保證單次執行。

嚴格限定觸發條件（只在特定欄/列變動時執行）。

把「複製→改名」封成一個函式並加上重入保護。

社群討論曾提到 .copyTo() 在事件環境下偶見雙生，實務要做好防呆。

3. 從儲存格取名含不適合字元

症狀：名稱包含過多空白、換行、看起來像公式片段，之後難以搜尋或外部系統不吃。

對策：前面「清洗字元」的範例直接收斂成單一空白、刪除控制字元，必要時自訂白名單（例如只留中英數、空白、底線）。