Google Sheets自定义函数KEY_COPY报setValues权限错误求助

你遇到的权限错误不是因为单元格定位或权限设置，而是Google Sheets自定义函数的核心限制：用@customfunction标记的自定义函数运行在沙箱环境中，仅允许返回数据，不能调用任何修改电子表格的方法（比如setValues、copyTo这类操作单元格内容/格式的API）。

根据你的需求，有两种可行的替代方案：

方案1：自定义函数返回值 + 条件格式匹配格式 #

自定义函数仅负责返回Key工作表的单元格值，再通过条件格式同步格式：

步骤1：编写仅返回值的自定义函数 #

/**
 * @param {string} cell Key工作表的单元格引用
 * @customfunction
 */
function KEY_VALUE(cell) {
  const sourceSheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Key");
  return sourceSheet.getRange(cell).getValue();
}

步骤2：编写获取格式的辅助函数 #

// 获取Key单元格的背景色
function GET_KEY_BG(cellRef) {
  const sourceSheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Key");
  return sourceSheet.getRange(cellRef).getBackground();
}

// 获取Key单元格的字体颜色
function GET_KEY_FONT_COLOR(cellRef) {
  const sourceSheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Key");
  return sourceSheet.getRange(cellRef).getFontColor();
}

步骤3：设置条件格式 #

假设你在单元格B2中输入=KEY_VALUE("A1")，要同步Key!A1的格式：

• 选中B2，打开「条件格式」→「添加规则」
• 选择「自定义公式」，输入=TRUE（应用到当前单元格）
• 设置背景色为=GET_KEY_BG("A1")，字体颜色为=GET_KEY_FONT_COLOR("A1")
• 确认保存即可同步格式

方案2：菜单触发脚本（推荐，操作更直观） #

放弃自定义函数，改用菜单触发的脚本，这类脚本拥有完整的电子表格操作权限：

// 打开表格时创建自定义菜单
function onOpen() {
  SpreadsheetApp.getUi()
    .createMenu("Key工具")
    .addItem("复制Key单元格内容和格式", "copyKeyCell")
    .addToUi();
}

// 执行复制操作的函数
function copyKeyCell() {
  const ui = SpreadsheetApp.getUi();
  const response = ui.prompt("请输入Key工作表的单元格引用（如A1）", ui.ButtonSet.OK_CANCEL);
  
  if (response.getSelectedButton() !== ui.Button.OK) return;
  
  const cellRef = response.getResponseText();
  const sourceSheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Key");
  const sourceRange = sourceSheet.getRange(cellRef);
  const targetRange = SpreadsheetApp.getActiveSpreadsheet().getActiveRange();
  
  // 复制内容+格式
  sourceRange.copyTo(targetRange, SpreadsheetApp.CopyPasteType.PASTE_ALL);
}

使用方法： #

1. 保存代码后刷新表格，顶部会出现「Key工具」菜单
2. 选中要粘贴的目标单元格
3. 点击「Key工具」→「复制Key单元格内容和格式」
4. 输入Key工作表的单元格引用（如A1），点击确定即可完成复制

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