如何通过Toggle按钮实现Google Sheets单元格图片的增删操作

你遇到的核心问题有两个：

1. insertImage 插入的是悬浮在单元格上层的图片，没有和单元格直接绑定，需要通过图片的锚点坐标判断所属单元格
2. 原代码中取到的row、col是选中范围内的相对索引，需要转换为表格的绝对行列号才能正确插入/定位图片

可直接运行的完整代码 #

function toggleCellImage() {
  // 替换为你要插入的图片URL
  const IMAGE_URL = "你的图片URL地址";
  const sheet = SpreadsheetApp.getActiveSheet();
  // 获取当前选中的所有范围
  const ranges = sheet.getActiveRangeList().getRanges();
  // 先获取当前工作表所有已插入的图片，方便后续匹配
  const allImages = sheet.getImages();

  ranges.forEach(range => {
    const startRow = range.getRow();
    const startCol = range.getColumn();
    const data = range.getValues();
    // 遍历选中范围内的每个单元格
    for (let relativeRow = 0; relativeRow < data.length; relativeRow++) {
      for (let relativeCol = 0; relativeCol < data[relativeRow].length; relativeCol++) {
        // 跳过空单元格
        if (data[relativeRow][relativeCol] === "") continue;
        // 转换为表格绝对行列号（Google Sheet行列从1开始计数）
        const absoluteRow = startRow + relativeRow;
        const absoluteCol = startCol + relativeCol;

        // 查找当前单元格是否已有绑定的图片
        let existImage = null;
        for (let img of allImages) {
          if (img.getAnchorCell().getRow() === absoluteRow && img.getAnchorCell().getColumn() === absoluteCol) {
            existImage = img;
            break;
          }
        }

        if (existImage) {
          // 存在图片则删除
          existImage.remove();
        } else {
          // 不存在则插入图片，最后两个参数是x偏移、y偏移，可根据需要调整
          sheet.insertImage(IMAGE_URL, absoluteCol, absoluteRow, 2, 2);
        }
      }
    }
  });
}

使用步骤 #

• 打开目标Google表格，点击顶部菜单栏「扩展程序」-「Apps 脚本」进入脚本编辑器
• 清空默认代码，粘贴上述代码，将IMAGE_URL的值替换为你实际要插入的图片地址
• 点击保存按钮，给项目任意命名后关闭脚本编辑器
• 回到表格页面，插入一个绘制的图形作为切换按钮，右键点击图形选择「分配脚本」，输入toggleCellImage后确认

注意事项 #

• 插入的图片默认锚定在所属单元格，调整单元格行高列宽时图片会跟随移动
• 仅处理选中范围内的非空单元格，空单元格会自动跳过不会操作
• 支持多范围选择，按住Ctrl选中多个不连续的单元格/范围后点击按钮也可批量操作

内容的提问来源于stack exchange，提问作者Kevin P.