首页 > 文章 > 前端

GoogleAppsScript邮件换行问题解决

时间：2025-09-28 10:27:30 499浏览收藏

大家好，我们又见面了啊~本文《Google Apps Script HTML邮件换行异常解决方法》的内容中将会涉及到等等。如果你正在学习文章相关知识，欢迎关注我，以后会给大家带来更多文章相关文章，希望我们能一起进步！下面就开始本文的正式内容~

解决Google Apps Script发送HTML邮件中换行符显示异常问题

本文详细介绍了在使用Google Apps Script通过GmailApp发送HTML格式邮件时，如何正确处理从Google表格中获取的带有换行符的文本。当直接将包含\n的文本转换为
并插入HTML模板时，HtmlService.evaluate().getContent()方法可能会将其转义为HTML实体，导致换行符失效。教程提供了通过.replace()方法将转义的HTML实体（如<和>）还原为实际HTML标签的解决方案，确保邮件内容能按预期正确显示换行。

问题背景：HTML邮件中换行符的挑战

在使用Google Apps Script构建自动化邮件系统时，我们经常需要从Google表格中读取文本内容并将其嵌入到HTML格式的邮件中。一个常见的问题是，当表格单元格中的文本包含换行符（\n）时，我们通常会尝试将其替换为HTML的换行标签
以便在邮件中正确显示。然而，在通过HtmlService.createTemplateFromFile()和evaluate().getContent()生成最终HTML内容时，这些
标签可能会被转义成HTML实体（例如<br />），导致邮件中直接显示文本Hello
I'm here!而不是实际的换行。

这个问题产生的原因在于HtmlService.evaluate().getContent()方法在处理模板变量时，出于安全考虑，默认会将HTML特殊字符进行转义，以防止跨站脚本攻击（XSS）。这意味着，即使你在Apps Script代码中明确地将\n替换为
，当这些内容被注入到HTML模板并通过evaluate().getContent()处理时，<和>字符也会被转义。

解决方案：还原HTML实体

解决此问题的核心思路是在evaluate().getContent()生成最终HTML字符串之后，手动将其中被转义的HTML实体（特别是<和>）还原为实际的<和>字符。这样，原本被转义的
标签就能恢复其应有的功能。

我们将通过修改sendMail函数来实现这一目标。

示例代码：Apps Script部分

首先，我们来看一下原始的Apps Script代码片段，其中尝试将换行符转换为
：

// splitTest 函数用于从B4单元格获取文本并按换行符分割
function splitTest() {
  var ss = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Settings");
  var str = ss.getRange("B4").getValue(); // 假设B4单元格内容为 "Hello\nI'm here!"
  Logger.log(str); // 输出: Hello\nI'm here!
  var array1 = str.split("\n"); // 分割成 ["Hello", "I'm here!"]
  return array1;
}

// sendMail 函数负责发送邮件
function sendMail() {
  // ... 其他变量和设置 ...

  var wsSettings = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Settings");
  var name = wsSettings.getRange("B2").getValue();
  var subject = wsSettings.getRange("B1").getValue();

  var array1 = splitTest();
  var cMessage = array1.join("<br />"); // 此时 cMessage 为 "Hello<br />I'm here!"

  var emailTemp = HtmlService.createTemplateFromFile("email");
  // ... 填充模板变量 ...
  emailTemp.cmess = cMessage;

  var htmlMessage = emailTemp.evaluate().getContent(); // 此时 htmlMessage 中的 <br /> 已被转义为 &lt;br /&gt;

  // ... 其他邮件发送逻辑 ...

  // 错误的发送方式，htmlMessage中的<br/>未被识别
  // GmailApp.sendEmail(
  //   row[email],
  //   subject,
  //   "Bitte öffnen Sie das Html-Format,um die Email zu lesen, Danke!",
  //   {name: name,
  //   htmlBody: htmlMessage, 
  //   });
}

为了解决上述问题，我们需要在htmlMessage生成之后，但在发送邮件之前，对其进行字符串替换操作。

function sendMail() {
  var ename = 3; 
  var cname = 2;
  var email = 5;
  var emailTemp = HtmlService.createTemplateFromFile("email");
  var ws = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Recipients");
  var wsSettings = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Settings");
  var name = wsSettings.getRange("B2").getValue();
  var subject = wsSettings.getRange("B1").getValue();
  var array1 = splitTest();
  var cMessage = array1.join("<br />"); // 此时 cMessage 是 "Hello<br />I'm here!"
  var data = ws.getRange("A2:G" + ws.getLastRow()).getValues();
  data = data.filter(function(r){ return r[6] == true}); 

  // 在循环外处理模板，避免重复 evaluate() 和 replace()
  emailTemp.cmess = cMessage; // 将带有 <br /> 的内容赋值给模板变量
  var htmlContentRaw = emailTemp.evaluate().getContent(); // 获取被转义的HTML内容

  // 核心解决方案：还原HTML实体
  var htmlContentUnescaped = htmlContentRaw.replace(/&lt;/g, "<");
  htmlContentUnescaped = htmlContentUnescaped.replace(/&gt;/g, ">");

  data.forEach(function(row){
    GmailApp.sendEmail(
      row[email],
      subject,
      "Bitte öffnen Sie das Html-Format,um die Email zu lesen, Danke!",
      {name: name,
      htmlBody: htmlContentUnescaped, // 使用还原后的HTML内容
      });
  }); 
}

示例代码：HTML模板部分

HTML模板文件（例如email.html）中接收cmess变量的部分保持不变。重要的是，white-space:pre-line;样式可以帮助处理文本中的原始换行符（\n），但对于被HtmlService转义的
标签则无效，因此仍需Apps Script进行处理。

<html>
  <head>
    <base target="_top">
  </head>
  <body>
    <!-- ... 其他HTML结构 ... -->
    <p style="line-height: 1.2; margin-top: 0pt; margin-bottom: 0pt; white-space:pre-line;"><span style="font-size: 11pt; font-family: Arial;">
      <?= cmess ?>
    </span></p>
    <!-- ... 其他HTML结构 ... -->
  </body>
</html>

注意事项与最佳实践

替换的顺序和时机： 确保replace()操作是在emailTemp.evaluate().getContent()之后执行的。因为只有在内容被evaluate()方法处理并转义后，我们才需要进行还原。
选择性替换： 本例中我们只替换了<和>，因为我们明确知道是
标签被转义了。如果你的HTML内容中还包含其他需要作为HTML标签处理的实体（例如&、"等），你需要根据具体情况决定是否也进行还原。但通常情况下，对于用户输入或从表格中获取的文本，我们只希望
等少数标签生效，过度还原可能会引入安全风险。
安全性考量： 直接将用户输入的文本注入到HTML并进行实体还原，存在一定的安全风险。如果用户输入的内容包含恶意的HTML或JavaScript代码，这些代码在还原后可能会被执行。因此，此方法最适用于你完全控制输入内容（例如，仅从特定单元格读取或经过严格验证的文本）的场景。对于可能包含用户生成内容的邮件，建议对输入进行更严格的清理或使用更安全的模板引擎。
white-space: pre-line; 的作用： 虽然本教程的解决方案主要依赖于Apps Script的字符串替换，但HTML/CSS中的white-space: pre-line;样式仍然有用。它告诉浏览器保留文本中的换行符（\n）和空格，并在必要时进行换行，但会合并多个连续的空格。如果你的Apps Script代码没有将\n转换为
，并且你希望原始的\n能引起换行，那么pre-line就能发挥作用。然而，当
被转义时，pre-line无法识别<br />为换行标签。

总结

通过在Apps Script中对HtmlService.evaluate().getContent()的输出进行后处理，将<和>等HTML实体还原为实际的HTML标签，我们可以有效解决从Google表格中获取的带换行符的文本在HTML邮件中显示异常的问题。这种方法提供了一个实用且可控的方案，确保自动化邮件系统能够按照预期呈现丰富的文本内容。在实施时，务必考虑内容的来源和潜在的安全风险，并进行适当的测试。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《GoogleAppsScript邮件换行问题解决》文章吧，也可关注golang学习网公众号了解相关技术文章。