Google Apps Script getFileByName无返回结果排查求助

云上老周

2026-8-5

问题分析与修复方案

核心错误点

getFilesByName用法错误：这个方法需要传入精确的完整文件名，你写的'title contains "2022"'是搜索查询语法，只能用在searchFiles()方法里，用在getFilesByName里会直接找不到任何文件，导致循环根本不执行。
clear方法未调用：activeSheet.clear只是引用了方法，没有执行，正确写法是activeSheet.clear()；而且把它放在循环里会每次清空之前的内容，应该移到循环外只执行一次。
未正确获取文件ID：直接把file对象写入单元格会显示[object File]，要获取ID得用file.getId()。
未适配共享驱动器：默认DriveApp只搜索个人驱动器，要搜索共享驱动器得在查询里加上对应条件。

修复后的代码

function onOpen(e) {
  SpreadsheetApp.getUi()
  .createMenu('testMenu')
  .addItem('getRegExFiles', 'matchingFileArray')
  .addToUi();
}

function matchingFileArray() {
  // 标题包含2022，同时搜索共享驱动器的查询语句
  var q = 'title contains "2022" and in shared drives';
  // 使用searchFiles执行查询
  var files = DriveApp.searchFiles(q);

  var activeSheet = SpreadsheetApp.getActive().insertSheet('matchFiles');
  // 提前清空表格，避免旧数据干扰
  activeSheet.clear();
  // 可选：添加表头
  activeSheet.appendRow(['文件ID']);
  
  while (files.hasNext()) {
    var file = files.next();
    // 写入文件ID
    activeSheet.appendRow([file.getId()]);
  }
}