三个 SVG 字重看起来相似,为什么路径结构仍不一致?
用原创轻、常规、重字重样例,在浏览器定位路径命令错配并复核修复,解释路径顺序、坐标点位、描边与变换的检查边界。

一个空心方框加一条横杠,轻、常规、重三个字重都能画出来。导出后,重字重的横杠也可能看起来正确,但 SVG 使用的路径命令已经换了一套。如果下一步要让不同字重的轮廓逐段对应,只数路径或坐标点位就会漏掉这种变化。
本文用两条原创路径演示一次完整的检查与修复。打开 SVG 字重结构预检查,可以选择三个本地文件,也可以粘贴源码。工具以常规字重为基准,给出路径清单和逐项差异;整个比较在当前浏览器内进行。
这里讨论普通 SVG 的 XML 与路径结构。SF Symbols 的名称来自可能遇到这个问题的自定义符号工作流;本文的样例是独立原创 SVG,没有使用 Apple 模板。Apple 的模板格式、插值、光学对齐和实际导入仍有各自要求,这个预检查的结果只覆盖下文列出的项目。
先复现:数量相同,命令不同
下载原创样例包,解压后会看到 matching/、mismatch/、repaired/ 和 malformed/ 四个目录。每组都有 light.svg、regular.svg、heavy.svg。样例在 CC0 1.0 下提供,可自行改动;包内 README 说明了来源与预期结果。
- 在工具的 Light、Regular、Heavy 三个位置分别选择
matching/中的对应文件,点击比较结构。 - 换成
mismatch/中的三个文件,再比较。 - 观察路径清单和差异表。三份文件都有 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。这次浏览器结果显示支持的结构检查没有差异。继续交给目标应用前,还应逐个查看轮廓的对应关系与视觉结果。

修复后仍保留各字重的坐标,统一的是命令结构。
检查器怎样从文本得到报告
读取文件只调用浏览器的 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 路径数据语法。完整路径语法比本工具已验证的子集更广;紧凑圆弧等未通过本解析器的写法可能需要改为显式、带分隔的参数。