预检

导出前检查 SVG 字形，通过红、黄、绿状态了解检查结果。

预检有助于发现可能导致生成字体不稳定、难以映射或视觉错位的问题。

检查内容

• Unicode 冲突。
• 重复的字形名称。
• 空 SVG 文件。
• 没有可见填充或描边轮廓的 SVG。
• 异常的 SVG 画布尺寸。
• 缺少 viewBox。
• 图形超出 SVG 画布。
• 图形超出预期的基线、升部或降部边界。
• 不支持的 SVG 元素和属性。
• 外部 SVG 资源。
• 字形复杂度限制。

状态颜色

• 绿色：已就绪。
• 黄色：警告。导出前请检查。
• 红色：错误。字形可能无效或不受支持。

构建行为

预检是审查步骤，并非无条件阻止构建。

发现问题时，可以只构建通过检查的字形，也可以继续使用全部字形，让原生构建引擎尝试处理。导出期间，构建引擎仍可能拒绝不支持或不安全的输入。

常见修复方法

• 将可编辑 SVG 文字转换为轮廓。
• 从 SVG 中移除位图。
• 展平裁剪路径、蒙版、滤镜和不透明度效果。
• 添加稳定的 viewBox。
• 将图形保持在画布以内。
• 使用唯一的字形名称。
• 分配唯一的 Unicode 值，除非有意替换源字体中的字形。
• 简化过于精细的路径。

图标字体提示

图标字体的图形位置往往与文字字形不同。基线或降部警告可能来自有意的设计，但仍值得检查，因为对齐不一致很容易使图标字体显得杂乱。