如何通过Apps Script删除带Tab名称前缀的Named Ranges

问题根因 #

removeNamedRange()方法仅需要传入不带任何工作表前缀的命名范围本身的名称，你看到的带'tmp'!前缀的内容是命名范围指向的单元格区域的位置表达式，不是命名范围的名称。你测试时使用的带单引号、转义符的写法会被识别为名称的一部分，自然匹配不到对应范围。

正确实现方案 #

1. 单个指定名称删除 #

如果明确要删除的命名范围的纯名称，直接传纯名称即可：

const analyzerDoc = '1pYgcX2dxzHd4cCofy0RFZTzEl36QesiakMGIqCC2QlY'
const openAnalyzerDoc = SpreadsheetApp.openById(analyzerDoc)

function testDeleteNamedRange (){
  var docUrl = openAnalyzerDoc.getRangeByName('docUrl').getValue();
  var targetDoc = SpreadsheetApp.openByUrl(docUrl);
  // 仅传入纯名称，不需要加任何工作表前缀、单引号
  const targetRangeName = 'dyCl_MoodEntries';
  targetDoc.removeNamedRange(targetRangeName);
}

2. 批量筛选删除（更稳妥，避免拼写错误） #

直接遍历所有命名范围对象，按规则筛选后调用对象自带的remove()方法删除，不需要手动拼接名称，不会出现匹配错误问题：

function batchDeleteUnusedNamedRanges() {
  var docUrl = openAnalyzerDoc.getRangeByName('docUrl').getValue();
  var targetDoc = SpreadsheetApp.openByUrl(docUrl);
  // 获取当前文档所有命名范围对象
  const allNamedRanges = targetDoc.getNamedRanges();
  // 替换为你需要保留的命名范围名称列表
  const reservedRangeNames = ['需要保留的名称1', '需要保留的名称2'];

  allNamedRanges.forEach(rangeItem => {
    const currentName = rangeItem.getName(); // 此处获取的是不带前缀的真实名称
    // 示例筛选逻辑：不在保留列表中的范围直接删除，可根据需求调整规则
    if (!reservedRangeNames.includes(currentName)) {
      rangeItem.remove();
    }
  })
}

附加：按所属工作表筛选的逻辑 #

如果需要删除所有指向tmp表的命名范围，可使用如下筛选逻辑：

allNamedRanges.forEach(rangeItem => {
  const bindSheet = rangeItem.getRange().getSheet();
  if (bindSheet && bindSheet.getName() === 'tmp') {
    rangeItem.remove();
  }
})

内容的提问来源于stack exchange，提问作者Atiq Zabinski