使用MimeKit在邮件中嵌入自定义Web字体遇src属性丢失问题

问题根源 #

你看到的src属性丢失并非MimeKit发送环节的问题——从导出的.eml文件内容正常就能证明，邮件本身的格式是正确的。真正原因是Outlook网页端（包括多数Outlook系列客户端）会主动过滤@font-face规则里的src属性，这是微软为了邮件安全和渲染一致性设置的限制，很多主流邮件客户端都有类似的过滤逻辑，防止恶意字体或不必要的嵌入资源加载。

自定义字体在邮件中的可行性 #

目前绝大多数邮件客户端对@font-face的支持非常有限：

• Outlook全系列（网页、桌面、移动端）基本不支持通过cid引用嵌入的字体文件；
• 少数客户端（如Apple Mail、Thunderbird）可能支持，但也要注意字体格式（woff2的支持并非全覆盖）；
• 更稳妥的替代方案是使用系统预装的web安全字体（比如Arial、Helvetica、Times New Roman等），或者对标题类文本采用图片替换的方式来实现自定义字体效果。

排查与验证方向 #

1. 确认邮件发送正确性：你已经通过导出.eml查看原始内容确认规则正常，这一步可以排除MimeKit代码的问题；
2. 跨客户端测试：用Apple Mail或Thunderbird打开邮件，验证@font-face是否生效，以此区分是发送问题还是客户端兼容限制；
3. 无错误日志可查：这不是代码报错，是客户端的主动过滤行为，没有公开的错误信息可以查看。

代码优化建议（仅针对兼容支持的客户端） #

虽然对Outlook无效，但如果要覆盖少数支持的客户端，可以补充设置LinkedResource的媒体类型，确保客户端能正确识别字体文件：

var linkedResource = body.LinkedResources.Add($"font{fontUrlIndex}", font.Stream);
linkedResource.ContentType = new ContentType("font", "woff2");

内容的提问来源于stack exchange，提问作者Daniel Kamiński