如何通过Google Apps Script在Google Sheets中按文件名获取指定Drive文件链接

问题背景 #

当前配置：

• Google Sheets单元格A2存储文件名（示例："Giraffe"）
• 已知目标Google Drive文件夹ID
• 目标文件夹内存在与A2同名的文件

需求：

1. 读取A2中的文件名
2. 在指定Drive文件夹中搜索该名称的文件
3. 将匹配文件的URL填入B2
4. 未找到对应文件时，B2返回"File not found"

实现代码 #

以下是高效稳定的脚本实现：

function getDriveFileUrl() {
  // 替换为你的目标Drive文件夹ID
  const TARGET_FOLDER_ID = "你的文件夹ID";
  
  const sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
  const fileName = sheet.getRange("A2").getValue().trim();
  
  // 处理空文件名情况
  if (!fileName) {
    sheet.getRange("B2").setValue("请输入文件名");
    return;
  }
  
  try {
    const folder = DriveApp.getFolderById(TARGET_FOLDER_ID);
    // 在指定文件夹内精确搜索同名文件
    const files = folder.getFilesByName(fileName);
    
    if (files.hasNext()) {
      const targetFile = files.next();
      // 获取文件的默认访问链接（可根据需求调整权限）
      const fileUrl = targetFile.getUrl();
      sheet.getRange("B2").setValue(fileUrl);
    } else {
      sheet.getRange("B2").setValue("File not found");
    }
  } catch (error) {
    // 捕获权限不足、无效ID等异常
    sheet.getRange("B2").setValue("错误：" + error.message);
  }
}

代码说明 #

• 精确搜索：使用getFilesByName()限定在目标文件夹内搜索，避免跨范围匹配
• 异常处理：通过try-catch捕获权限错误、无效文件夹ID等问题，避免脚本崩溃
• 空值校验：提前判断A2是否为空，减少无效操作
• 性能优化：直接操作单个单元格，比批量操作更节省资源

使用指南 #

1. 打开目标Google Sheets文档，点击「扩展程序」→「Apps Script」
2. 替换默认代码为上述脚本，将TARGET_FOLDER_ID改为你的Drive文件夹ID（从文件夹URL提取，格式如1xYzAbC...）
3. 保存项目，返回Sheets后通过「扩展程序」找到对应脚本运行即可
4. （可选）设置触发器实现自动运行：
   • 在Apps Script编辑器中点击左侧「触发器」→「添加触发器」
   • 选择函数getDriveFileUrl，事件源设为「从电子表格」，事件类型选「编辑」（A2内容变更时自动触发）

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