文档版本 v2026.10.17.0

下载 PDF

导入失败

适用平台与对象

Apple 版用户；用于判断来源错误、路径不匹配与打开失败。

前置条件

保留原始输入、扩展名、所走入口和错误文字。

操作步骤

1. 确认使用 File 还是 Folder。Folder 新建要求有效 KiCad 项目，不能用来导入任意制造目录。
2. 多图纸原理图应提供完整项目；单个 .kicad_sch 不会自动补齐外部子图纸。
3. 先让云盘或文件提供器把来源下载到本地，再选择文件／目录。
4. IPC-2581 按实际用途选择设计或制造意图。
5. 若提示无变化，检查是否重复导入同名、同格式、相同字节内容；这可能是正常去重。
6. 记录失败发生在文件选择、资料入库还是 Viewer 首帧准备。等待已有导入结束后再试。

现象	下一步
文件选择器无法选择来源	核对入口、扩展名与格式覆盖
目录缺少项目文件	提供完整 .kicad_pro 项目，或改用 File 导入单板
资料库已出现文档，打开失败	保留文档，记录 Viewer 的具体阶段与错误
2D 可打开，3D 资源缺失	检查模型和项目依赖，不要把它归为全部导入失败
画面缺少关键几何	记录缺失范围和样例，不能因为打开成功就当作完整正确

结果

把问题定位到来源、入口、读取、解析或显示阶段，便于复现。

常见问题

改扩展名能解决吗？

不能。解析依赖实际内容与项目结构。

偶发失败需要记录吗？

需要。记下首次失败和重试差异，不以一次成功覆盖原始错误。

最近验证日期

2026-09-11：依据当前 Library Guide、项目实操及来源规则核对；未逐项制造错误输入。