并插入HTML模板时，HtmlService.evaluate().getContent()方法可能会将其转义为HTML实体，导致换行符失效。教程提供了通过.replace()方法将转义的HTML实体（如zuojiankuohaophpcn和youjiankuohaophpcn）还原为实际HTML标签的解决方案，确保邮件内容能按预期正确显示换行。
问题背景：HTML邮件中换行符的挑战
在使用google apps script构建自动化邮件系统时，我们经常需要从google表格中读取文本内容并将其嵌入到html格式的邮件中。一个常见的问题是，当表格单元格中的文本包含换行符（\n）时，我们通常会尝试将其替换为html的换行标签
以便在邮件中正确显示。然而，在通过htmlservice.createtemplatefromfile()和evaluate().getcontent()生成最终html内容时，这些
标签可能会被转义成html实体（例如zuojiankuohaophpcnbr /youjiankuohaophpcn），导致邮件中直接显示文本hello
i'm here!而不是实际的换行。
这个问题产生的原因在于HtmlService.evaluate().getContent()方法在处理模板变量时，出于安全考虑，默认会将HTML特殊字符进行转义，以防止跨站脚本攻击（XSS）。这意味着，即使你在Apps Script代码中明确地将\n替换为
，当这些内容被注入到HTML模板并通过evaluate().getContent()处理时，字符也会被转义。
解决方案：还原HTML实体
解决此问题的核心思路是在evaluate().getContent()生成最终HTML字符串之后，手动将其中被转义的HTML实体（特别是zuojiankuohaophpcn和youjiankuohaophpcn）还原为实际的字符。这样，原本被转义的
标签就能恢复其应有的功能。
我们将通过修改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("
"); // 此时 cMessage 为 "Hello
I'm here!"
var emailTemp = HtmlService.createTemplateFromFile("email");
// ... 填充模板变量 ...
emailTemp.cmess = cMessage;
var htmlMessage = emailTemp.evaluate().getContent(); // 此时 htmlMessage 中的
已被转义为 zuojiankuohaophpcnbr /youjiankuohaophpcn
// ... 其他邮件发送逻辑 ...
// 错误的发送方式，htmlMessage中的
未被识别
// 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("
"); // 此时 cMessage 是 "Hello
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; // 将带有
的内容赋值给模板变量
var htmlContentRaw = emailTemp.evaluate().getContent(); // 获取被转义的HTML内容
// 核心解决方案：还原HTML实体
var htmlContentUnescaped = htmlContentRaw.replace(/zuojiankuohaophpcn/g, "<");
htmlContentUnescaped = htmlContentUnescaped.replace(/youjiankuohaophpcn/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进行处理。
注意事项与最佳实践
- 替换的顺序和时机： 确保replace()操作是在emailTemp.evaluate().getContent()之后执行的。因为只有在内容被evaluate()方法处理并转义后，我们才需要进行还原。
-
选择性替换： 本例中我们只替换了zuojiankuohaophpcn和youjiankuohaophpcn，因为我们明确知道是
标签被转义了。如果你的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无法识别zuojiankuohaophpcnbr /youjiankuohaophpcn为换行标签。
总结
通过在Apps Script中对HtmlService.evaluate().getContent()的输出进行后处理，将zuojiankuohaophpcn和youjiankuohaophpcn等HTML实体还原为实际的HTML标签，我们可以有效解决从Google表格中获取的带换行符的文本在HTML邮件中显示异常的问题。这种方法提供了一个实用且可控的方案，确保自动化邮件系统能够按照预期呈现丰富的文本内容。在实施时，务必考虑内容的来源和潜在的安全风险，并进行适当的测试。
