导入失败¶
页面目标¶
帮助你快速判断当前失败是“输入不受支持”“导入方式不匹配”还是“运行期保护主动中止”。
先看这三件事¶
- 失败发生在选文件之前、选文件之后，还是进入工作区之后
- 是否弹出了明确提示文本；如果弹窗里有“复制”，先复制完整错误内容
- 失败对象是新建导入、追加修订，还是 SES
当前最常见的失败类型¶
1. 输入类型不受支持¶
常见信号：
- 直接提示扩展名不支持
- 文件选出来后没有继续导入
建议动作：
- 先确认你走的是“导入文件”还是“导入文件夹”
- 再确认输入是否属于当前支持范围；
KiCad .kicad_pro / .kicad_sch与 Gerber/Drill 包应选择包含关联文件的文件夹
2. IPC-2581 导入意图选错¶
常见信号：
- 文件本身能选中，但导入结果不符合预期
建议动作：
- 重新导入
- 在确认框里重新选择“设计”或“制造”意图
3. SES 使用方式不对¶
常见信号：
- 想把
SES当成普通文件新建导入 - 或当前文档没有可作为 base 的修订
建议动作：
- 进入目标文档的操作菜单
- 从
导入 SES发起 - 先选择 base revision
4. 大体积 IPC-2581 打开很慢，或在真实导入阶段失败¶
当前版本已经不再用保守的稳定性检查，在打开前主动拦截超大 IPC-2581 XML。
如果这类资料仍然失败，失败点现在会落在真实导入路径里，而不是“打开前先被挡住”。
建议记录：
- 失败时看到的原始错误文本，或停留的最后一个加载阶段
- 文件大小、平台、设备型号
- App 当时是仍可响应、长时间卡住，还是被系统直接终止
5. 同时已有另一个导入任务在运行¶
当前同一时刻只允许一个 PCB 导入任务运行。 如果前一个导入还没完成，新的导入请求会被拒绝并给出状态提示。
6. 同名同格式资料被判定为“未变化”¶
当前版本会对同名且同格式的导入做原始源精确比较：
- 如果新导入的原始源和当前修订完全一致，系统会提示已忽略导入
- 这不是失败，而是为了避免生成重复修订
- 如果你预期它应该形成新修订，先确认这次导入的文件内容是否真的有变化
7. DSN 局部图元几何异常（导入成功但有降级）¶
常见信号：
- 导入最终成功，文档可打开
- 但在局部区域显示不符合预期
说明：
- 这表示少量局部细节未能正常显示，但其余板内容仍可继续查看。
- 该行为用于避免整板导入直接失败或崩溃；通常只影响局部图元呈现，不影响文档整体打开。
建议动作：
- 先确认关键区域是否可正常查看与交互。
- 若影响了你关心的局部对象，请记录 message 文本、原始
DSN文件与复现步骤，交给内核侧排查几何建模/轮廓提取问题。
KiCad 相关的特殊说明¶
KiCad 板文件即使主体导入成功，若引用了缺失或不可读的 project-local 3D 资源，后续仍可能在 3D 或问题信息里看到相关 issue。 这类问题不一定阻断 2D 打开，但会影响 3D 完整性。
新建导入 KiCad .kicad_pro / .kicad_sch 时，请使用“导入文件夹”选择项目或原理图所在文件夹。资料库会优先使用顶层唯一 .kicad_pro；如果没有 .kicad_pro，才会使用顶层唯一 .kicad_sch。若文件夹里有多个顶层候选或混入制造输出，系统会要求你选择更具体的文件夹。
导入单个 KiCad .kicad_sch 所在文件夹时，资料库只保存该入口原理图实际引用到的 child sheet，以及必要的本地库/设置文件；同目录下没有引用关系的其他 .kicad_sch 不会自动加入。若某个 Sheetfile 指向缺失或不可读的 child sheet，导入会直接失败并弹出错误。
建议记录的信息¶
- 平台与设备
- 导入入口类型：导入文件 / 导入文件夹 / SES
- 原始文件类型与大小
- 错误提示原文
- 是否稳定复现
- 是否在导入前已经有其他导入任务
常见问题¶
为什么有的制造资料明明是文件夹，却也能导入？¶
因为“导入文件夹”允许目录型输入，实际是否可导入取决于应用能否把这个目录识别成支持的 KiCad 项目、Gerber/Drill 包或 ODB++ 包。
为什么导入失败后资料库里没有任何新卡片？¶
这通常说明失败发生在真正创建文档之前，例如输入不支持，或者应用未能通过基本检测。 如果导入过程中应用被强制退出，未完成的临时导入内容也会在下次启动时清理，不会作为半成品卡片出现在资料库里。
为什么第二次导入同名文件后，没有新增修订？¶
如果系统提示“未变化，已忽略导入”，说明这次导入的原始源与当前修订完全一致。当前版本会直接忽略，而不是再生成一个内容相同的新修订。
第二次再试又成功了，还要记录吗？¶
建议记录。间歇性失败同样会影响稳定性判断。