在Google文档脚本中获取文档所在文件夹及创建子文件夹的方法

要实现获取当前文档所在文件夹、按需创建子文件夹并在其中新建文档，你可以按照以下步骤来编写代码：

1. 获取当前文档的父文件夹 #

Google Apps Script里没有直接的DocumentApp.getMyFolder()方法，但我们可以通过文档ID关联到Drive中的文件对象，进而获取它的父文件夹：

// 获取当前文档对应的Drive文件对象
const currentDoc = DriveApp.getFileById(DocumentApp.getActiveDocument().getId());
// 获取文档的父文件夹（文档可能被添加到多个文件夹，这里取第一个匹配项）
const parentFolder = currentDoc.getParents().next();

提示：如果你的文档存在于多个文件夹中，getParents()会返回一个文件夹迭代器，你可以根据需求遍历所有父文件夹，或者添加逻辑判断处理这种场景。

2. 在父文件夹下创建子文件夹（仅当不存在时） #

别用全局的DriveApp.getFoldersByName()，它会搜索整个Drive，我们需要在指定的父文件夹范围内查找：

const folderName = "myNewFolder";
let targetFolder;

// 检查父文件夹下是否已存在同名子文件夹
const existingFolders = parentFolder.getFoldersByName(folderName);
if (existingFolders.hasNext()) {
  targetFolder = existingFolders.next();
} else {
  // 不存在则创建子文件夹
  targetFolder = parentFolder.createFolder(folderName);
}

3. 在子文件夹中新建文档 #

用DocumentApp.create()创建的文档默认会出现在Drive根目录，所以需要把它移动到目标子文件夹中：

const newDocName = "子文件夹内的新文档";
// 创建新文档
const newDocument = DocumentApp.create(newDocName);
// 获取新文档对应的Drive文件对象
const newDocFile = DriveApp.getFileById(newDocument.getId());
// 将新文档移动到目标子文件夹
newDocFile.moveTo(targetFolder);

完整代码示例 #

把上面的步骤整合起来，完整脚本如下：

function createSubfolderAndDoc() {
  // 1. 获取当前文档的父文件夹
  const currentDoc = DriveApp.getFileById(DocumentApp.getActiveDocument().getId());
  const parentFolder = currentDoc.getParents().next();

  // 2. 创建或获取目标子文件夹
  const folderName = "myNewFolder";
  let targetFolder;
  const existingFolders = parentFolder.getFoldersByName(folderName);
  if (existingFolders.hasNext()) {
    targetFolder = existingFolders.next();
  } else {
    targetFolder = parentFolder.createFolder(folderName);
  }

  // 3. 在子文件夹中新建文档
  const newDocName = "子文件夹内的新文档";
  const newDocument = DocumentApp.create(newDocName);
  const newDocFile = DriveApp.getFileById(newDocument.getId());
  newDocFile.moveTo(targetFolder);

  // 可选：弹出提示告知操作成功
  DocumentApp.getUi().alert(`已在「${folderName}」文件夹中创建新文档：${newDocName}`);
}

关键注意点 #

• 权限说明：第一次运行脚本时会弹出授权提示，需要授予脚本访问Google Drive和Docs的权限，按照指引完成授权即可。
• 多父文件夹场景：如果文档被添加到多个文件夹，getParents().next()只会取第一个父文件夹，若需要处理所有父文件夹，可以通过循环遍历getParents()迭代器实现。
• 同名文件夹处理：如果父文件夹下有多个同名子文件夹，getFoldersByName().next()会返回第一个匹配项，若需要更精确的控制，可以考虑通过文件夹ID来定位。

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