文档版本
v2026.07.07.0
下载 PDF
导入失败¶
页面目标¶
帮助你快速判断当前失败是输入不受支持、导入路径不匹配，还是应用为了保护状态而主动停止。
支持的平台¶
- iOS / iPadOS：17.0 或更高版本。
- macOS：14 或更高版本。
适合谁阅读¶
- 导入路径表现不符合预期的用户
- 需要分流导入失败、忽略导入或降级导入结果的测试人员
准备条件¶
- 你手里有具体导入 case、提示信息或复现路径
- 如果可能，请保留触发问题的源文件和准确导入路径
操作步骤¶
- 先判断失败发生在选文件前、选文件后，还是进入工作区后。
- 检查使用的是哪条导入路径，以及来源资料是否应该被这条路径支持。
- 对照下面的失败模式，包括未变化重复导入和 DSN 局部降级提示。
- 重试前记录准确提示信息和来源上下文。
结果¶
- 你可以把问题缩小到输入不支持、路径不匹配、保护性停止、未变化重复导入或局部降级导入。
先看这三件事¶
- 失败发生在选文件之前、选文件之后，还是进入工作区之后？
- 应用是否显示了明确错误信息？
- 这次操作是新建导入、追加修订，还是 SES？
当前最常见的失败类型¶
1. 输入类型不受支持¶
常见信号：
- 应用直接提示扩展名不支持
- 选中文件后流程停止
建议动作：
- 先确认你走的是设计路径还是制造路径
- 再确认输入属于当前支持集合
2. IPC-2581 导入意图选错¶
常见信号：
- 文件可以选中，但导入后的行为不是你预期的类型
建议动作：
- 重新导入
- 重新选择它应该作为设计侧资料还是制造侧资料处理
3. SES 使用方式不对¶
常见信号：
- 想把
SES当成普通新文档导入 - 或当前文档没有可用基础修订
建议动作：
- 打开目标文档菜单
- 从
Import SES发起 - 先选择一个有效基础修订
4. 大体积 IPC-2581 打开很慢，或在真实导入阶段失败¶
当前版本不再用保守的内存稳定性检查，在打开前主动拦截超大 IPC-2581 XML。
如果这类来源仍然失败，失败现在会发生在真实导入路径里，而不是打开前被拒绝。
建议动作：
- 记录准确错误文本或最后可见加载阶段
- 记录文件大小、平台和设备型号
- 说明应用当时是仍可响应、停滞，还是被系统终止
5. 已有另一个导入任务正在运行¶
当前版本同一时间只允许一个 PCB 导入任务。如果前一个导入还没完成，下一个导入请求会被状态提示拒绝。
6. 同名同格式输入被判定为未变化¶
同一文档名和同一格式再次导入时，当前版本会比较原始源字节：
- 如果新导入的原始源与当前修订完全一致，应用会提示导入被忽略，因为没有变化
- 这不是失败，而是为了避免重复修订
- 如果你预期产生新修订，请确认文件内容确实发生了变化
7. DSN 成功导入后出现局部几何降级¶
常见信号：
- 导入最终成功，文档也能打开
- 但某些局部细节没有按预期显示
这表示：
- 少量局部细节无法显示，但板子其他内容仍然可用
- 这种行为是为了避免整板导入失败或崩溃，通常只影响局部渲染，而不是整个文档
建议动作：
- 先确认受影响区域对你的任务是否仍然可用
- 如果缺失几何很关键，请记录提示文本、原始
DSN和复现步骤，便于后续调查
KiCad 相关的特殊说明¶
即使 KiCad 板文件在 2D 意义上导入成功，缺失或不可读的项目本地 3D 资源仍可能在后续 3D 或问题详情中暴露出来。这不一定阻断 2D 打开，但可能降低 3D 完整性。
建议记录的信息¶
- 平台和设备
- 导入路径类型：design / manufacturing / SES
- 原始文件类型和大小
- 原始错误文本
- 是否稳定复现
- 当时是否已有另一个导入任务在运行
常见问题¶
为什么有些制造资料明明是文件夹，却也能导入？¶
因为制造路径接受目录型输入。能否导入取决于应用能否把目录识别为支持的制造包。
为什么导入失败后资料库里没有新卡片？¶
这通常表示失败发生在创建文档之前，例如输入不支持、稳定性检查拒绝或应用检测失败。
为什么第二次导入同名文件后没有新增修订？¶
如果应用提示因为没有变化而忽略导入，说明新导入的原始源与当前修订完全一致。当前版本会跳过它，而不是创建重复修订。
第二次再试又成功了，还要记录吗？¶
要记录。间歇性失败同样会影响稳定性评估。