SVG 在设计机正常、离线机缺图，怎样检查外部依赖

SVG在设计机正常、离线机缺图，应先查文件是否引用了外部图片、字体或样式。一个扩展名为.svg的文件不等于所有资源都已打包：相对路径需要对应目录，网络地址需要可用网络和访问条件，内部片段引用才指向同一文件中的对象。

先确定文件与环境

本文用本地小图链接与data URI内嵌图片作对照，不连接远程服务器。SVG作为网页内联或作为图片加载，能否访问外部资源还受宿主模式与实现限制；浏览器打开成功不能替代离线引擎导入。测试时以实际发布包根目录为基准，不借用制作机的下载目录或编辑器缓存。

操作与判断

1. 文本检查href、旧式xlink:href、CSS中的url及字体src，按内部片段、相对路径、绝对文件路径、网络地址、内嵌数据分类。不要只搜索.png，因为链接可能没有常见扩展名。

2. 先将linked.svg与tile.png一起放入隔离目录打开，再只复制SVG到另一测试目录，观察差异。这个动作应在测试副本完成；不要删除正式包中的图片来制造缺失。

3. 对照embedded.svg，核对内嵌数据是否被目标引擎支持。内嵌能减少路径依赖，但会增加文件体积，也不能保证SVG里的字体、滤镜或其他外部引用已经处理。

4. 采用发布工具支持的收集或打包流程，重新枚举所有引用，再在断网条件和独立测试目录导入。把缺失引用保留成错误列表，不自动从互联网补文件让测试暂时通过。

输入对照与结果边界

样例	图片引用	复制时要求
linked.svg	tile.png相对路径	一并带上tile.png
embedded.svg	data URI	图片字节已内嵌
#shape	内部片段示意	同文档存在对应ID

附件audit.py实际枚举image的href并确认tile.png存在，属于明确限定的XML引用检查。它不解析所有CSS语法、不递归扫描外部SVG、不解析脚本拼出的地址，因此“未发现外链”不能写成完全自包含认证。对复杂设计稿，应结合原导出器资源清单与目标加载日志。

下载并复核

外部图片引用SVG、对应原创图片、内嵌图片对照SVG、有限范围只读引用检查、执行结果。

下载两份SVG和tile.png放在同一目录，再运行audit.py。输出可比较relative与embedded分类。使用你的文件时先备份，按脚本的有限检查范围解释结果；项目内另记录资源根、网络条件、导入模式、失败资源URL与目标错误信息，不把本地文件存在当作引擎已经读取成功。

已实际生成、解析外链与内嵌两个SVG，并确认本地依赖存在。未测试目标引擎的网络策略，也未声明扫描覆盖所有CSS与脚本引用。

失败时怎样继续

断网时只有字体图标消失，要查字体资源和私用区映射，不能把所有文字转为图片后就宣称问题已定位。若相对路径包含大小写差异，需在接收文件系统复核；若引用已内嵌仍空白，查格式、MIME类型和宿主限制。某些工具会在保存时保留旧绝对路径，发布副本也要重新检查。

交付包应可在独立目录按说明打开，不需要原设计机临时帮忙。把允许保留的网络依赖及离线替代方式列清，对没有离线资源的部分明确标记受阻。后续修改SVG后重新跑引用检查，并用目标渲染器实测，而不是沿用上一个版本的截图。

相关背景可看展厅更换供应商时，怎样核对工程文件能否继续维护，继续从多媒体播放专题查找相关流程；需要结合项目确认时可查看工程对接咨询。

一级出处

• SVG外部引用按URL和基准地址解析，单文件并不必然自包含。

来源核对日期：2026-10-24。来源支持所述机制；本文合成输入与本地计算只证明所列文件及算法，不代表目标软件或现场设备已验收。