BIMI 对 SVG logo 文件格式的具体技术要求

BIMI 要求品牌以 SVG（Scalable Vector Graphics）格式提供 Logo 文件。SVG 不是普通的图片格式，BIMI 对 SVG 文件有一系列严格要求。如果文件不满足规范，邮箱服务商不会显示 Logo。本文将详细介绍这些技术要求。

一、核心要求

1. 纯矢量 — 严禁嵌入位图

SVG 文件必须完全由矢量路径（path）组成，不得包含嵌入的位图（如 PNG、JPEG、GIF 的 Base64 编码）。邮箱服务商在显示 Logo 时会验证这一点，包含位图的 SVG 会被拒绝。

<!-- 禁止的行为：SVG 中包含 Base64 图片 -->
<image href="data:image/png;base64,iVBORw0KGgo..." />

2. viewBox 要求

• 最小 viewBox 尺寸：96x96
• 推荐 viewBox 尺寸：600x600（留出足够的缩放空间）
• viewBox 的宽高比必须为 1:1（正方形）
• SVG 的 width 和 height 属性建议设为 "100%"

3. 颜色空间

• 必须使用 sRGB 颜色空间
• 颜色代码可使用十六进制（#FF0000）、RGB（rgb(255,0,0)）或命名颜色（red）
• 支持使用 fill 和 stroke 属性着色
• 建议使用扁平化设计（无渐变）以获得最佳小尺寸显示效果

4. 字体处理

• 严禁嵌入字体文件（包括 @font-face 引用或 SVG 字体）
• 所有文本必须转换为 path（路径）
• 这一要求确保 Logo 在任何设备上保持一致外观

二、文件结构要求

2.1 根元素

<svg xmlns="http://www.w3.org/2000/svg"
     viewBox="0 0 600 600"
     width="100%" height="100%">

2.2 禁止的元素和属性

• <script> — 严禁包含 JavaScript
• <foreignObject> — 外部对象（如 HTML 嵌入）
• 外部引用（如 href="http://..." 外部资源）
• CSS @import 语句
• 非标准的 SVG 扩展标签

2.3 推荐的文件大小

建议 SVG 文件大小不超过 32KB，最好的效果在 5-20KB 范围内。过大文件可能影响加载速度和邮箱服务商的处理。

三、小尺寸显示优化

BIMI Guidelines v1.1 新增了小尺寸显示优化指南：

• 最小描边宽度建议 ≥ 1.5px（考虑到缩小到 40x40px 时仍可见）
• 避免过于复杂的细节（如多行小文字、微小的渐变过渡）
• 使用足够的对比度（建议对比度 ≥ 3:1）
• 在 40x40px 分辨率下线框仍应可辨识

四、深色模式备用 Logo

BIMI Guidelines v1.1 新增的深色模式支持要求：

• 深色模式 SVG 必须与浅色模式使用相同的 viewBox 尺寸
• 深色模式 Logo 应使用浅色/白色为主的配色
• 深色模式的 SVG 也需要通过 CA 验证

五、验证工具

建议使用以下工具验证 SVG 是否符合 BIMI 规范：

• BIMI Inspector（官方工具）
• SVG 验证器（W3C Nu HTML Checker）
• 通过各 CA 的预检工具测试 SVG