App Script从邮件字符串提取邮箱生成统一数组问题排查

安全阿岳

2026-8-26

问题根源

你代码里有4个核心问题导致拿不到预期的纯邮箱一维数组：

日志打印方式错误：用"字符串"+数组的写法时，JavaScript会自动调用数组的toString()方法把数组转成逗号拼接的字符串，本质上数组还是数组，只是打印出来看起来像字符串。要看真实数组结构直接把数组作为单独参数传给console.log就行，不要拼接字符串。
数组嵌套错误：你写emailArray.push([toArray[i]])的时候，给每个邮箱值额外套了一层数组，最后返回的是二维嵌套结构；另外外层fullArray.push(extractDetails(message))是把每封邮件返回的邮箱整个数组作为单个元素推入，也会造成嵌套。
提取逻辑遗漏：你拆分了发件人、回复邮箱的字符串，但根本没把这两部分的邮箱加入结果数组。
内容没清洗：getFrom()/getTo()这类方法返回的字符串带发件人姓名，格式类似张三 <zhangsan@example.com>，直接按逗号拆分拿到的不是纯邮箱地址。

修复方案

直接替换成下面的代码即可，核心改动点：

新增简单正则提取每个字段里的纯邮箱地址，自动过滤姓名、尖括号
去掉所有不必要的数组嵌套，最终返回纯邮箱字符串构成的一维数组
补全发件人、回复邮箱的提取逻辑
修正日志打印方式，外层合并数组时用展开运算符避免嵌套
写入表格时把邮箱数组转成逗号分隔字符串，避免单元格格式异常

var ui = SpreadsheetApp.getUi();
function onOpen(e){
  ui.createMenu("Gmail Manager").addItem("Get Emails by Label", "getGmailEmails").addToUi();
}

// 从"姓名 <邮箱>"格式的字符串里提取纯邮箱
function parsePureEmail(rawStr) {
  if (!rawStr) return '';
  const matchRes = rawStr.match(/<([^>]+)>/);
  return matchRes ? matchRes[1].trim() : rawStr.trim();
}

function getGmailEmails(){
  var label = GmailApp.getUserLabelByName("MyLabel");
  var threads = label.getThreads();
  var fullArray = [];

  for(var i = threads.length - 1; i >=0; i--){
    var messages = threads[i].getMessages();
    for (var j = 0; j <messages.length; j++){
      var message = messages[j];
      if (message.isUnread()){
        // 用展开运算符把单封邮件的邮箱逐个推入总数组，避免嵌套
        const emailList = extractDetails(message);
        fullArray.push(...emailList);
      }
    }
  }
  // 直接传数组打印，不要拼接字符串
  console.log("FullArray:", fullArray);
  for(var i=0; i<fullArray.length; i++){
    console.log("printing array " + i + ": "+fullArray[i])
  }
}


function extractDetails(message){
  var dateTime = message.getDate();
  var subjectText = message.getSubject();

  var senderDetails = message.getFrom();
  var ccEmails = message.getCc();
  var replyEmail = message.getReplyTo();
  var toEmail = message.getTo();

  var emailArray = []
  
  // 拆分所有字段，逐个提取纯邮箱后加入结果
  [senderDetails, ccEmails, replyEmail, toEmail].forEach(fieldStr => {
    if (!fieldStr) return;
    const rawItems = fieldStr.split(',');
    rawItems.forEach(item => {
      const pureEmail = parsePureEmail(item);
      if (pureEmail) emailArray.push(pureEmail);
    })
  })

  console.log("Email Array: ", emailArray);
 
  var activeSheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
  // 写入表格时把邮箱数组转成逗号分隔字符串
  activeSheet.appendRow([
    dateTime, 
    parsePureEmail(senderDetails), 
    subjectText, 
    ccEmails.split(',').map(parsePureEmail).join(','),
    parsePureEmail(replyEmail),
    toEmail.split(',').map(parsePureEmail).join(','), 
    emailArray.join(',')
  ]);

  return emailArray;
}

如果需要对结果去重，只要在拿到完整fullArray之后加一句fullArray = [...new Set(fullArray)]即可。

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