DriveApp中Folder类getFoldersByName()方法非拉丁名称查询异常

这看起来是getFoldersByName()方法在处理西里尔字符时的字符串匹配逻辑出了问题——虽然它返回了FolderIterator实例，但内部查询并没有正确匹配到已存在的文件夹，导致迭代器实际为空，调用next()就会抛出“iterator has reached the end”错误。下面是几个可行的解决思路和方案：

1. 确认字符编码与一致性 #

首先排查传入的西里尔字符串和目标文件夹名称的Unicode一致性：

• 检查是否存在大小写差异（西里尔文的大小写规则和英文不同，比如ё和Ё是独立字符）
• 排查是否有不可见控制字符（比如零宽空格、非打印字符）混入字符串
• 可以用字符编码比对工具验证两者是否完全一致，比如用charCodeAt()逐个输出字符编码：

  // 示例：比对两个字符串的字符编码
  function compareCharCodes(str1, str2) {
    console.log('Str1 codes:', [...str1].map(c => c.charCodeAt(0)));
    console.log('Str2 codes:', [...str2].map(c => c.charCodeAt(0)));
    return JSON.stringify([...str1].map(c => c.charCodeAt(0))) === JSON.stringify([...str2].map(c => c.charCodeAt(0)));
  }
  

2. 改用手动遍历+Unicode感知的字符串比较 #

既然getFoldersByName()无法正确处理西里尔字符匹配，我们可以绕过这个方法，手动遍历父文件夹的所有子文件夹，并用支持Unicode的比较方法判断名称是否匹配。推荐使用localeCompare()，它能正确处理特定语言的字符规则：

function getOrCreateFolder(parentFolder, targetName) {
  const folderIterator = parentFolder.getFolders();
  while (folderIterator.hasNext()) {
    const currentFolder = folderIterator.next();
    // 使用俄语locale进行基础敏感度比较（可根据需求调整规则）
    if (currentFolder.getName().localeCompare(targetName, 'ru', { sensitivity: 'base' }) === 0) {
      return currentFolder;
    }
  }
  // 未找到则新建文件夹
  return parentFolder.createFolder(targetName);
}

这个方法的核心是localeCompare的参数：

• 'ru'指定俄语环境，确保西里尔字符的比较规则正确
• sensitivity: 'base'表示只要字符的基础形式相同就视为匹配（忽略大小写、变音符号差异，可改为'case'或'accent'调整严格度）

3. 检查API的字符支持限制 #

如果是在特定平台（比如Google Apps Script的Drive API）使用Folder类，建议确认官方文档中关于非ASCII字符查询的说明——部分API可能对非拉丁字符的查询有隐藏限制，或者需要将字符串转码为特定格式后再传入。

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