MimeKit如何嵌入SVG图片而不将其作为邮件附件

云上老周

2026-8-7

解决SVG图片内嵌邮件不显示为附件的问题

你当前代码中，PNG能正常内嵌是因为MimeKit默认识别其MIME类型并标记为内嵌资源，但SVG需要显式配置才能避免被当作附件。以下是两种可行方案：

方案一：修正LinkedResource配置

显式指定SVG的MIME类型和内嵌属性，确保邮件客户端将其识别为内嵌资源而非附件：

var builder = new BodyBuilder();
var image = builder.LinkedResources.Add(logoPath);
// 显式设置SVG的MIME类型
image.ContentType = new ContentType("image", "svg+xml");
// 强制标记为内嵌资源，不显示为附件
image.ContentDisposition.Disposition = ContentDisposition.Inline;
image.ContentId = MimeUtils.GenerateMessageId();
textMsg = textMsg.Replace("{logo}", $"cid:{image.ContentId}"); // 确保HTML引用格式正确
builder.HtmlBody = textMsg;
msg.Body = builder.ToMessageBody();

关键说明：

必须指定image/svg+xml作为Content-Type，否则部分客户端会将SVG识别为未知类型的附件
设置ContentDisposition.Inline强制邮件客户端以内嵌方式渲染，而非显示为附件
HTML中引用图片必须使用cid:{ContentId}的格式，确保关联到内嵌资源

方案二：Base64直接内嵌到HTML

如果LinkedResource方式仍有问题，可以尝试将SVG转为Base64直接嵌入HTML，完全避免资源关联问题：

// 读取SVG文件内容并转为Base64
var svgContent = File.ReadAllText(logoPath);
var base64Svg = Convert.ToBase64String(Encoding.UTF8.GetBytes(svgContent));
// 替换HTML中的占位符
textMsg = textMsg.Replace("{logo}", $"data:image/svg+xml;base64,{base64Svg}");

var builder = new BodyBuilder();
builder.HtmlBody = textMsg;
msg.Body = builder.ToMessageBody();