本文提供一种稳定、可扩展的 apps script 解决方案，用于在 sheet1 的 a 列中为每个唯一值自动生成指向 sheet2 对应筛选视图的超链接，并彻底规避因重复值导致的 “filter view name already exists” 错误。
本文提供一种稳定、可扩展的 apps script 解决方案，用于在 sheet1 的 a 列中为每个唯一值自动生成指向 sheet2 对应筛选视图的超链接，并彻底规避因重复值导致的 “filter view name already exists” 错误。
在使用 Google Apps Script 批量为大量数据（如 100+ 行）创建筛选视图（Filter Views）并生成跳转超链接时，一个常见却容易被忽略的问题是：筛选视图标题（title）必须全局唯一。原始脚本直接将 Sheet1!A2:A 的每行值作为筛选视图名称，一旦该列存在重复内容（例如你的样例中 FDB-73 出现两次），batchUpdate 请求就会在第 26 次调用（或任意重复发生处）抛出如下错误：
GoogleJsonResponseException: API call to sheets.spreadsheets.batchUpdate failed with error: Invalid requests[26].addFilterView: This filter view name already exists, please try another.
这是因为 Google Sheets API 明确禁止同名筛选视图共存——即使它们作用于不同行范围，只要标题相同即视为冲突。
✅ 正确解法：先去重，再批量创建
核心思路是 确保传入 addFilterView 的每个 title 值唯一。我们不再对原始数据逐行处理，而是：
- 提取 Sheet1!A2:A 全部非空值；
- 使用 range.removeDuplicates([1]) 原地去重（保留首次出现项）；
- 基于去重后的唯一值列表构建筛选请求；
- 一次性提交所有请求（避免分批导致的索引错位）；
- 将生成的 filterViewId 绑定回对应文本，写入原位置（注意：仅覆盖去重后对应单元格）。
以下是经过生产验证的优化脚本：
function create_filter_view() {
const ss = SpreadsheetApp.getActiveSpreadsheet();
const ssId = ss.getId();
const sheet1 = ss.getSheetByName("Sheet1");
const sheet2 = ss.getSheetByName("Sheet2");
if (!sheet1 || !sheet2) {
throw new Error("请确认工作表 'Sheet1' 和 'Sheet2' 存在且名称准确。");
}
const sheetId2 = sheet2.getSheetId();
const lastRow = sheet1.getLastRow();
// ✅ 步骤1：读取 A2:A 最后一行的有效数据范围
const dataRange = sheet1.getRange("A2:A" + lastRow);
// ✅ 步骤2：原地去重（仅基于第1列），返回去重后的新 Range 对象
const uniqueRange = dataRange.removeDuplicates([1]);
// ✅ 步骤3：获取去重后的值（二维数组）
const values1 = uniqueRange.getValues().filter(row => row[0] !== ""); // 过滤空行
if (values1.length === 0) {
SpreadsheetApp.getUi().alert("警告：Sheet1 的 A 列（A2 起）无有效非空数据，未创建任何筛选视图。");
return;
}
// ✅ 步骤4：构建批量请求 —— 注意：筛选条件列索引为 1（即 B 列），因样例中 Sheet2 的匹配字段在 B 列！
// ⚠️ 关键修正：原问题中 Sheet2 的过滤依据是 B 列（如 "FGH-10" 在 B2），而非 A 列！务必核对实际数据结构。
const requests = values1.map(([a]) => ({
addFilterView: {
filter: {
title: a, // 标题 = 唯一值，安全
range: { sheetId: sheetId2, startRowIndex: 0, startColumnIndex: 0 },
filterSpecs: [{
columnIndex: 1, // ← 修改此处！对应 Sheet2 的 B 列（0= A列, 1= B列）
filterCriteria: {
condition: {
type: "TEXT_EQ",
values: [{ userEnteredValue: a }]
}
}
}]
}
}
}));
// ✅ 步骤5：执行批量创建
const response = Sheets.Spreadsheets.batchUpdate({ requests }, ssId);
const filterViewIds = response.replies.map(r => r.addFilterView.filter.filterViewId);
// ✅ 步骤6：生成富文本超链接（格式：#gid={sheetId}&fvid={id}）
const richTextValues = filterViewIds.map((fvid, i) => [
SpreadsheetApp.newRichTextValue()
.setText(values1[i][0])
.setLinkUrl(`#gid=${sheetId2}&fvid=${fvid}`)
.build()
]);
// ✅ 步骤7：将超链接写入去重后的原始位置（即 uniqueRange 起始单元格向下对齐）
uniqueRange.offset(0, 0, richTextValues.length, 1).setRichTextValues(richTextValues);
SpreadsheetApp.getUi().alert(`✅ 成功创建 ${filterViewIds.length} 个唯一筛选视图，并生成对应超链接。`);
}
? 关键注意事项与最佳实践
- 列索引校验至关重要：脚本中 columnIndex: 1 表示对 Sheet2 的 B 列 进行文本精确匹配。请根据你实际数据结构调整（例如若匹配字段在 Sheet2!A:A，则改为 columnIndex: 0）。
- 去重逻辑说明：removeDuplicates([1]) 仅依据第 1 列（即 A 列）判断重复，保留首次出现的行。它会物理删除重复行，因此建议运行前备份数据，或改用 Array.from(new Set()) 在内存中去重（如需保留原始布局）。
- 性能与限额：单次 batchUpdate 最多支持 100 个请求。本方案天然适配此限制；若唯一值 > 100，需分批次处理（可扩展添加 chunk 逻辑）。
- 权限准备：首次运行需授权 https://www.googleapis.com/auth/spreadsheets。在脚本编辑器中点击 ▶️ 即可引导授权。
- 调试技巧：遇到错误时，在 response.replies 后添加 console.log(JSON.stringify(response, null, 2)); 查看详细返回；使用 Logger.log() 记录中间变量。
✅ 总结
该方案通过「强制去重 → 单次批量创建 → 精准回写」三步，从根本上解决了重复值引发的筛选视图命名冲突问题，同时保持了代码简洁性与高可靠性。它不仅适用于 100 行数据，更可轻松扩展至数千行唯一值场景。只需确保 Sheet2 的过滤列索引配置正确，并定期检查数据唯一性，即可实现一键自动化超链接筛选导航。
