教程 ↗

三个 SVG 字重看起来相似,为什么路径结构仍不一致?

用原创轻、常规、重字重样例,在浏览器定位路径命令错配并复核修复,解释路径顺序、坐标点位、描边与变换的检查边界。

英文 SVG 字重结构检查器显示重字重的第二条路径命令错配

一个空心方框加一条横杠,轻、常规、重三个字重都能画出来。导出后,重字重的横杠也可能看起来正确,但 SVG 使用的路径命令已经换了一套。如果下一步要让不同字重的轮廓逐段对应,只数路径或坐标点位就会漏掉这种变化。

本文用两条原创路径演示一次完整的检查与修复。打开 SVG 字重结构预检查,可以选择三个本地文件,也可以粘贴源码。工具以常规字重为基准,给出路径清单和逐项差异;整个比较在当前浏览器内进行。

这里讨论普通 SVG 的 XML 与路径结构。SF Symbols 的名称来自可能遇到这个问题的自定义符号工作流;本文的样例是独立原创 SVG,没有使用 Apple 模板。Apple 的模板格式、插值、光学对齐和实际导入仍有各自要求,这个预检查的结果只覆盖下文列出的项目。

先复现:数量相同,命令不同

下载原创样例包,解压后会看到 matching/、mismatch/、repaired/ 和 malformed/ 四个目录。每组都有 light.svg、regular.svg、heavy.svg。样例在 CC0 1.0 下提供,可自行改动;包内 README 说明了来源与预期结果。

  1. 在工具的 Light、Regular、Heavy 三个位置分别选择 matching/ 中的对应文件,点击比较结构。
  2. 换成 mismatch/ 中的三个文件,再比较。
  3. 观察路径清单和差异表。三份文件都有 2 条路径、15 条展开命令、12 个坐标点位,但差异表会定位到 Heavy 的第 2 条路径。

常规字重横杠的命令是:

<path id="bar" d="M 32 46.5 H 68 V 53.5 H 32 Z"/>

错配的重字重横杠写成:

<path id="bar" d="M 32 47 L 68 47 L 68 53 L 32 53 Z"/>

两者都有五条命令,横竖方向却采用不同表达。检查器显示的序列分别是 M H V H Z 与 M L L L Z。这一行结果说明“第二条路径使用了不同命令结构”;它还没有判断这两条轮廓是否应当对应,更没有评价视觉质量。

修复要保留重字重自己的几何尺寸

在实际设计中,应从同一份路径结构继续调整坐标,减少在某个字重里单独重画或转换路径造成的结构漂移。这个样例的修复是在 Heavy 的第二条路径恢复 M H V H Z,同时把横杠厚度设置为重字重的 10 个 viewBox 单位:

<path id="bar" d="M 32 45 H 68 V 55 H 32 Z"/>

这也修正了错配样例中横杠偏薄的问题。结构检查只提示命令变化;具体厚度仍由绘图者确定。若为了消除报告差异而直接复制常规字重全部坐标,会把重字重的几何设计一起丢掉。

选择 repaired/ 中的三个文件重新运行,差异表消失,清单保持 2 / 15 / 12。这次浏览器结果显示支持的结构检查没有差异。继续交给目标应用前,还应逐个查看轮廓的对应关系与视觉结果。

英文检查器读取修复后的三个 SVG,显示支持的结构检查没有差异

修复后仍保留各字重的坐标,统一的是命令结构。

检查器怎样从文本得到报告

读取文件只调用浏览器的 File.text();之后先检查字节与安全边界,再用 DOMParser 以 image/svg+xml 解析成独立文档。源码不会插入当前页面作为 SVG,也没有轮廓预览。这样可以保留待查原文,并避免为了看形状而执行文件中的内容。

通过格式检查后,工具按文档顺序读取 path。每条路径的 d 被拆成命令与有限数值,检查参数数量,然后展开隐式重复。比如 M0 0 10 0 10 10Z 中,第一个坐标对是 M,后两个是隐式 L,报告序列为 M L L Z。多组 L 参数也展开成多条命令。相对命令和绝对命令保持原样,因此 m l z 与 M L Z 会显示为差异。

报告项得到什么阅读时的条件
路径数量与常规字重相比是否少了或多了路径合并路径也会改变数量;先确认路径的设计角色
路径 ID / 顺序线索相同位置的两个非空 ID 是否不同没有 ID 时仍按位置比,无法自动识别被交换的同结构轮廓
命令序列展开后的命令字母及大小写几何上相同的 H/V 与 L 表达仍会不同
坐标点位每条命令所占的终点与控制点槽位C 计 3,Q 计 2,Z 计 0;它不是编辑器节点数或去重后的顶点数
描边路径及祖先继承的 stroke、width、cap、join任一对照有描边就提示关注,即使两端属性一致
变换路径及祖先的原始 transform 链工具保留声明,不计算变换后的坐标;任一端有变换就提示

JSON 报告包含每个字重的路径摘要、差异和检查版本。点击“下载 JSON”保存到自己的设备,或复制报告供下一步核对。路径 ID 会进入报告,文件名和完整源码不会写入 JSON;报告可能包含你自己的设计标识,应按自己的资料管理方式保存。

描边与变换提示是一种检查策略:相同 d 仍可能因 stroke-width 或祖先 scale() 而产生不同轮廓。看到提示时,回到原始绘图文件决定是否需要展开描边、应用变换,再重新导出。检查器保持输入原样,不自动替你转换图形。

支持范围与失败恢复

当前版本支持 svg、g、path,以及 title、desc 元信息。属性限制在路径数据、ID、画布/viewBox 和有限的表现属性;外链、事件属性、实体、CSS、嵌入内容与未知节点会被拒绝。常见 rect、circle、use、defs 也不在这一版中。可以在可信的绘图环境把形状转换为独立轮廓,再检查导出文件,保留原文件以供对照。

每份输入最多 256 KiB、256 条路径、4,096 个元素、32 层嵌套;每条路径最多 65,536 字符和 4,096 条命令,每个文件最多 32,768 条命令。数值必须有限且绝对值不超过 10⁹。预算先限制工作量,复杂 SVG 应先缩小范围。它没有服务器或云端兜底。

选择 malformed/ 的文件会得到 XML 错误,同时保留已有输入和结果。粘贴或编辑源码后,上一次报告仍显示,旁边会标明需要重新比较,复制和下载暂时停用;可以继续修正,或点击“恢复上次比较”回到最后一次有效输入。取消选文件、超限或读取失败都不会替换现有内容。只有主动清空才会删除这次比较。模块未加载或 JavaScript 关闭时,比较按钮保持禁用,页面说明不会提交文件。

输入、文件名、源码与报告没有进入页面 URL、长久存储或计算请求。网页资源与现有访问统计仍有自己的网络请求;统计记录访问、导航与参与时间,工具没有把这些 SVG 数据注册为统计字段。离开页面会清除本次输入和报告,下载产生的 Blob URL 也会释放。

没有差异之后还要检查什么

命令序列一致时,两条路径依然可能朝不同方向绘制、从不同顶点开始,或把本应对应的两个轮廓对调。不同 fill-rule 也可能改变空洞。当前报告不比较坐标、面积、绕向、填充规则、尺寸/viewBox 是否一致或轮廓自交;相同签名只说明命令结构一致。

如果你的目的包括 SF Symbols,请继续按 Apple SF Symbols 官方页面 的资源与目标应用流程核对模板和实际导入。本次预检查没有进行原生 Apple 软件实测。对普通 Web 图标,这份清单更适合用来发现导出过程的路径合并、顺序线索和命令漂移,再回到设计源文件做有目的的修复。

实现细节可对照 MDN 的 SVG path 说明与 W3C 路径数据语法。完整路径语法比本工具已验证的子集更广;紧凑圆弧等未通过本解析器的写法可能需要改为显式、带分隔的参数。

← 返回列表