
上个月,我把同一份邮件简报分别放在 Gmail 和 Outlook 桌面客户端里并排打开。三栏页脚塌成了一栏,渐变页头变成一片平白,每个圆角按钮都成了矩形。HTML 是合法的,字节也完全一样。没有报错,可也什么都没渲染出来。文件没有坏,只是读它的那个引擎从来没实现过其中一半的东西。
邮件不是「CSS 支持更差的网页」。它是一份 1990 年代的文档,由一款仍然接受 HTML 的文字处理器渲染;模板就断在这两者的缝隙里。
邮件 HTML 检查器把这条缝隙变成一份有限的规则清单。它用 cheerio 解析模板,套用 9 类静态规则,把每条发现归入 3 个严重级别。这些规则本身就值得读一遍,因为每一条都对应一个浏览器会放过、邮件客户端不会放过的地方。
渲染你邮件的引擎,是一款文字处理器
Outlook 桌面客户端不带浏览器引擎。它通过 Microsoft Word 渲染 HTML,检查器在自己的修复说明第一行就点明了后果:Outlook(Word 渲染器)不支持 Flexbox。这句话解释了为什么一个模板能通过完整的浏览器测试矩阵,到手时却面目全非。
Word 没有 flex 格式化上下文,没有 grid,也没有给滤镜用的合成层。解析器遇到它不实现的声明时,不会优雅降级。它直接丢掉这条声明,把元素按普通块级排版。你的兜底方案从来不会是「稍微丑一点」,它会直接退回到这个元素作为默认块级元素的样子;于是一排卡片变成竖着堆叠,不再是一行窄一点的卡片。
这之所以要紧,是因为 CSS 的失败无声无息。图片缺失会显示破损图标;display: flex 被丢掉之后,呈现的却是一个看起来像刻意设计的布局。这种「像刻意的」损坏会被直接发出去。我在那份简报里看到的两个问题出于同一个原因,检查器要做的,就是在订阅者看到结果之前把这条声明点出来。
撑不过投递的 11 个属性
规则表有 11 个条目;若把 position: fixed 和 position: sticky 分开计数,就是 12 个关键字值,每一条都是 error,不是 warning。其中 3 个是 display 的取值:flex、grid、flow-root,Word 把它们一律渲染成普通块级元素。两个条目关于定位:fixed 和 sticky 失去视口参照,position: absolute 在 Outlook 里不支持,在别处也不可靠。剩下六个是 gap、transform、animation、filter、clip-path 和 object-fit。

指出属性名只是容易的那一半。每条规则还附一句修复说明,这句说明才是有用的那一半。flex 的说明是:改用表格或 inline-block。transform 的说明是:把旋转或缩放的图像预先渲染好。filter:把效果直接做进图片。animation:改用动态 GIF。粘贴模板之前,你可以在邮件 HTML 检查器上把整张表看一遍。
静态规则表在这里胜过直觉,原因在于这些失败光读 CSS 是看不出来的。比如 gap 紧挨着一条好用的 display: flex,看起来毫无害处;object-fit: cover 放在一张有明确宽高的图片旁边,也一样无害。这两条之所以都在表里,是因为渲染邮件的引擎根本没有这两个属性;两种情况下声明都是被丢弃,不是被重新解释。
单位先失效,属性还没轮到出场
第二个正则扫描 7 个单位:vh、vw、vmin、vmax、rem、ch 和 ex。即使属性本身受支持,命中一个也是 error,修复说明只有一句:改用 px 或 %。这个先后顺序有意义,因为一条完全合法的 width 声明可能就栽在视口单位上,模板自己却不会透露原因。
邮件客户端不提供视口,也没有可靠的字体度量。vw 和 vh 假定存在一个渲染面,客户端并不暴露它;ch 和 ex 依赖某款字体的度量,这款字体可能在绘制之前就被替换掉。在浏览器里,这些单位相对一块你能检视的画布计算。在收件箱里,它们相对客户端自己定的东西计算,同一份模板在两个客户端算出的数值并不一样。
有一个边缘情况值得知道。单位扫描只走带 style 属性的元素,所以 <style> 块里的 rem 不会被这条规则报出来。比如模板顶部的媒体查询里写着 font-size: 1.1rem,属性规则同样会漏掉它,因为只有属性表会在 style 块内部重跑一遍。单位规则和 style 块规则并不重叠。
style 块是一句承诺,Gmail 移动端并不兑现
每个 <style> 元素都会在「非内联 CSS」类别下产生一条 warning,修复说明写着:把关键样式内联到每个元素上,style 块只留给 :hover 伪状态和媒体查询。这个存活空间很窄,比大多数模板以为的还要窄。
原因出在渲染时序上。会剥掉 head 里样式的客户端把文档渲染两次:一次在图片和字体加载时,没有你的规则;一次在加载完成之后。网速快的时候,第一遍只是一闪。在手机上,那就是订阅者真正读到的那一帧;依赖 class 的布局会一直显得坏掉,直到它终于看起来像设计好的样子。
把 style 块当作渐进增强,不要当成事实来源。任何承重的东西,宽度、颜色、内边距、表格属性,都属于元素上的内联样式。改变字号阶梯的媒体查询可以留在块里,因为忽略它的客户端只是显示桌面尺寸而已。
两个属性撑起一整张布局表
检查器只看两个表格属性,表格结构的其他部分一概不管。<table> 没有 role="presentation" 是一条 warning。<table> 既没有 cellpadding、自身也没有 padding 声明,是第二条 warning。修复说明很明确:设置 cellpadding="0" cellspacing="0" border="0",或者改用内联内边距。
这两条 warning 看起来都像日常保洁,其实都不是。浏览器和邮件客户端把单元格内边距默认设成 1px,一行 3 个单元格会悄悄多出 6px 宽度;嵌套表格在每一层叠加这个误差,直到一个 600px 的外壳溢出容器几个像素,谁也说不清是哪来的。给元素加 padding 不算同一个修法,因为它作用于单元格的内容盒,不是表格的间距模型。
role="presentation" 是这对属性里管无障碍的那一半。没有它,屏幕阅读器会把这套布局当成表格式数据播报,通常先报行数列数,然后才读到标题。有了它,阅读器跳过脚手架,按顺序读内容。
这个检查的实现有个细节:cellpadding 检测其实是在表格自身的内联样式里搜 padding 这个子串。只要有一条声明含这个词,warning 就消失了,于是 padding-left: 0 能通过检查,cellpadding 却还停在默认值上。这条规则是个代理指标,不是证明。
你不给 VML,Outlook 就不认 background-image
背景图在整份规则表里待遇最严。只要有元素声明了 background-image,同时文档里没有任何 <!--[if mso]> 条件注释,检查器报的就是 error,不是 warning。修复说明指向一个 VML 兜底方案:把 v:rect 元素包在只有 Outlook 会读的条件注释里。

这个严重级别是对的,原因在失败的样子。Word 引擎丢掉声明,把底下的背景色画出来。缺图本该带上破损图标,你得到的却是一个干净的色块,占据照片本来的位置。这个色块看起来像有意的设计,于是它通过评审、发了出去,最后由客户而不是 QA 报告出来。
圆角以同样安静的方式失效。任何带 border-radius 的 a、button 或 div 都会产生一条 warning,提示语就把话讲完了:Outlook 渲染直角。4px 的圆角只是外观问题。可对一颗药丸形的行动按钮来说,在企业读者打开邮件的那个客户端里,主按钮的视觉分量被改掉了。两种情况下,引擎都是丢掉声明、留下盒子。
<picture> 出于同样的引擎原因被判 error。Word 的渲染器不做资源协商,元素的响应式变体只能塌缩成客户端猜得到的那一个,安全的替代写法是一个带明确宽高的 <img>。
严重级别不等于坏掉的程度
三个严重级别并不对应三档损坏程度,这些错位恰恰是报告里最有用的部分。<img> 缺 width 在任何级别下都是 warning,因为缺了尺寸,慢网络下会强制重排,内容会在读者拇指底下移动。<img> 缺 alt 则是 info,直到你选了「严格」,因为坏掉的是屏幕阅读器,像素本身没问题。
script 永远是 error:没有邮件客户端执行它,标签在入口就被剥掉。表单是 warning,修复说明让你改成链接到落地页。动效与媒体元素(video、audio、canvas、iframe)合并成一条 warning。锚点没写明确颜色是 info,原因就写在提示里:某些客户端会退回浏览器蓝,跟你的配色不搭。
严格度决定你能看到其中多少。「宽松」档下,过滤器保留 error,加上 Outlook 类别里的 warning,其余丢掉。设想一个模板:flex 排成的一行、一张缺 cellpadding 的表、一张缺 width 的图。宽松档只报 1 个 error,两条布局 warning 都藏了起来,因为表格和图片的发现各有自己的类别。缺陷没有变,变的是你能看到什么。这就是该看类别那一列、别去看总数的理由。
所以第一次发送之前用「严格」跑一遍,评审阶段用「平衡」。严格档会把无障碍和链接类的发现翻出来;平衡档让报告短到能读完;宽松档只回答一个问题:有没有什么是必然坏掉的。
这个检查器永远不会告诉你的事
工具在自己的文档里就诚实交代了第一项局限:它是静态检查器,没法把邮件放到真实客户端里跑。值得花那个钱的时候,就配一个渲染服务;把检查器当作便宜的那一遍,在昂贵的那一遍之前抓机械缺陷。它不测量任何像素,只做模式匹配,报告客户端会丢弃什么。

第二项局限更具体些:追踪像素检测只在图片源以 .png 结尾、且 URL 含 tracking 子串时才触发。一个从 /o.gif 发出的 1×1 像素,或者一张命名为 px1.png 的图,永远不会触发这条规则。这是拿文件名启发式顶着检测用;在信任一份「干净」报告之前,你得知道这一点,尤其当模板确实带了统计埋点。
第三项局限是覆盖面。规则集不检查邮件体积,Gmail 对整封邮件施加的 ~102 KB 截断阈值就没有被量过。它没有 preheader 规则,没有链接数量规则,对图文比例落在哪里也没有意见,包括整份模板就是一张大图、完全没有文字的情况。九个类别是扎实的地板,不是完整的审计。更多工具在 elysiatools.com 上。
这些都不会替你修好一封邮件。它只是清掉那些 Word 渲染器会默默丢弃的缺陷。所以下一轮投放发出去之前,先把模板过一遍检查器,再找一个你不掌控的客户端打开它,问一句:有没有什么承重的东西只存在于 CSS 里?如果答案是「有」,那 VML 不是怀旧,它就是解法。你的模板里,还有哪些装饰,你正拿它当结构用?
Pingback: Why 11 CSS Properties Vanish Before Your Email Reaches Outlook - COSESAI