.ics文件中str_replace失效导致Outlook预约换行异常问题

嘿，我之前也踩过Outlook解析ICS换行的坑！这问题本质是Outlook对ICS格式的要求比其他日历软件（比如Google日历）严格得多，普通的换行符根本不被它识别，得严格遵循ICS规范来处理文本。

问题根源 #

ICS标准（RFC 5545）里对文本字段（比如DESCRIPTION）有两个关键要求：

• 字段内的换行需要用转义字符\n表示，而不是普通的\r\n或\n
• 每行内容不能超过75个字符，超过的部分要做「折叠处理」——也就是在75字符后加\r\n （回车+换行+空格），让后续内容缩进一行继续

你之前用的str_replace大概率只是替换成了普通换行，没符合这两个规范，所以Outlook只显示第一行。

具体解决方案 #

以PHP为例，给你一套完整的处理流程：

1. 转义特殊字符和换行
   先把描述里的原生换行转成ICS标准的\n，同时转义ICS里的特殊字符（逗号、分号、反斜杠）：

$original_description = "你的预约描述内容\n第二行内容\n第三行";

// 转义特殊字符
$escaped_desc = str_replace(
    ['\\', ',', ';'],
    ['\\\\', '\\,', '\\;'],
    $original_description
);

// 把原生换行转成ICS识别的\n
$escaped_desc = str_replace(["\r\n", "\n"], '\n', $escaped_desc);

2. 折叠长文本
   用wordwrap函数把内容拆分成每行不超过72个字符（留3个字符给折叠的\r\n ），确保符合ICS的长度要求：

$folded_desc = wordwrap($escaped_desc, 72, "\r\n ", true);

3. 写入ICS文件
   把处理后的描述放到ICS的DESCRIPTION字段里：

$ics_content = <<<ICS
BEGIN:VCALENDAR
VERSION:2.0
PRODID:-//你的网站//EN
BEGIN:VEVENT
UID:唯一的预约ID@你的域名.com
DTSTART:20240520T140000Z
DTEND:20240520T150000Z
SUMMARY:预约标题
DESCRIPTION:$folded_desc
END:VEVENT
END:VCALENDAR
ICS;

额外注意事项 #

• 邮件发送时，要确保ICS附件的Content-Type设置为text/calendar; charset=utf-8，不然Outlook可能解析异常
• Outlook有缓存机制，测试时尽量用新邮箱或者清除Outlook的缓存，避免看到旧的解析结果
• 如果你的描述里有HTML内容，Outlook支持ICS里的HTML格式，但需要把HTML转义后放在DESCRIPTION里，同时加上X-ALT-DESC;FMTTYPE=text/html:字段（不过纯文本换行按上面的方法就够了）

按照这个流程处理后，Outlook应该就能正确显示所有换行内容了！

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