手册版本
v2026.04.17.1
发布日期 2026-04-17
下载 PDF
导入失败¶
页面目标¶
帮助你快速判断当前失败是“输入不受支持”“导入方式不匹配”还是“运行期保护主动中止”。
先看这三件事¶
- 失败发生在选文件之前、选文件之后，还是进入工作区之后
- 是否弹出了明确提示文本
- 失败对象是新建导入、追加修订，还是 SES
当前最常见的失败类型¶
1. 输入类型不受支持¶
常见信号：
- 直接提示扩展名不支持
- 文件选出来后没有继续导入
建议动作：
- 先确认你走的是设计入口还是制造入口
- 再确认输入是否属于当前支持范围
2. IPC-2581 导入意图选错¶
常见信号：
- 文件本身能选中，但导入结果不符合预期
建议动作：
- 重新导入
- 在确认框里重新选择“设计”或“制造”意图
3. SES 使用方式不对¶
常见信号：
- 想把
SES当成普通文件新建导入 - 或当前文档没有可作为 base 的修订
建议动作：
- 进入目标文档的操作菜单
- 从
导入 SES发起 - 先选择 base revision
4. 大体积 IPC-2581 被预检拦截¶
当前实现对超大 IPC-2581 XML 有内存预检保护：
- 会结合文件大小、设备物理内存与平台类型估算峰值占用
- 如果风险明显高于安全预算，会在真正打开前直接中止
这是为了避免系统因为内存耗尽直接杀进程。
5. 同时已有另一个导入任务在运行¶
当前同一时刻只允许一个 PCB 导入任务运行。 如果前一个导入还没完成，新的导入请求会被拒绝并给出状态提示。
6. 同名同格式资料被判定为“未变化”¶
当前实现会对同名且同格式的导入做原始源精确比较：
- 如果新导入的原始源和当前修订完全一致，系统会提示已忽略导入
- 这不是失败，而是为了避免生成重复修订
- 如果你预期它应该形成新修订，先确认这次导入的文件内容是否真的有变化
7. DSN 局部图元几何异常（导入成功但有降级）¶
常见信号：
- 导入最终成功，文档可打开
- 但在开发日志/控制台里出现类似
skipping display object variant ... no valid contours could be extracted的 warning
说明：
- 这表示导入器在少量 display variant 上无法提取有效 contour，系统会跳过该局部变体并继续导入。
- 该行为用于避免整板导入直接失败或崩溃；通常只影响局部图元呈现，不影响文档整体打开。
建议动作：
- 先确认关键区域是否可正常查看与交互。
- 若影响了你关心的局部对象，请记录 warning 文本、原始
DSN文件与复现步骤，交给内核侧排查几何建模/轮廓提取问题。
KiCad 相关的特殊说明¶
KiCad 板文件即使主体导入成功，若引用了缺失或不可读的 project-local 3D 资源，后续仍可能在 3D 或诊断信息里看到相关 issue。 这类问题不一定阻断 2D 打开，但会影响 3D 完整性。
建议记录的信息¶
- 平台与设备
- 导入入口类型：设计 / 制造 / SES
- 原始文件类型与大小
- 错误提示原文
- 是否稳定复现
- 是否在导入前已经有其他导入任务
常见问题¶
为什么有的制造资料明明是文件夹，却也能导入？¶
因为制造入口允许目录型输入，实际是否可导入取决于导入器能否把这个目录识别成支持的制造包。
为什么导入失败后资料库里没有任何新卡片？¶
这通常说明失败发生在真正创建文档之前，例如输入不支持、预检被拦截，或者导入器未能通过基本检测。
为什么第二次导入同名文件后，没有新增修订？¶
如果系统提示“未变化，已忽略导入”，说明这次导入的原始源与当前修订完全一致。当前实现会直接忽略，而不是再生成一个内容相同的新修订。
第二次再试又成功了，还要记录吗？¶
建议记录。间歇性失败同样会影响稳定性判断。