加载慢与性能观察¶

页面目标¶

帮助你判断当前是“正常准备中”还是“异常卡住”。

当前版本里常见的等待阶段¶

资料导入到 2D 准备阶段¶

资料库顶部会显示导入 banner
工作区可能暂时切到 Data 视图
2D 在首帧发布前可能被导入遮罩挡住

Files / Finder 系统缩略图阶段¶

安装 PCB Atlas 后，iOS Files 和 macOS Finder 可能会在浏览目录时请求 PCB 文件缩略图。这个请求由系统调度，不代表主 App 已经打开，也不保证每个文件都会立刻生成。

小文件通常更快出现真实板图
设计文件会用 top + bottom 外层生成缩略图；外部留白透明，板区保留浅白底，导线、焊盘、过孔和丝印使用更清晰的深色配色
大文件、损坏文件、系统资源紧张或 Metal 不可用时，可能退回 PCB Atlas 类型卡片
PCB Atlas 自身缩略图缓存会随渲染主题版本失效；系统 Quick Look 仍可能保留自己的缩略图缓存，调试时改文件名、换目录或重新安装 App，通常比反复等待同一个文件更有效
普通 .zip 仍按系统 ZIP 类型处理，不承诺 Gerber package 原生缩略图

Files / Finder 点按预览阶段¶

iOS Files 或 macOS Finder 点开支持的单文件 PCB 资料时，会请求 PCB Atlas 的 Quick Look Preview 扩展生成一张静态大图 PNG。当前默认先出约 512 x 512 的 fast preview；如果同一文件内容、同一渲染主题版本已经有更高质量的预览缓存，系统会直接复用缓存而不是重新导入/渲染。低分辨率缩略图不会直接放大成预览图。

支持范围与系统缩略图一致：KiCad .kicad_pcb、DSN、单文件 Gerber 与单文件 Excellon Drill
SES 仍只作为主 App 打开绑定，不进入 Quick Look Preview
Preview 复用同一套 Quick Look 板图生成路径：设计文件显示 top + bottom 外层，Gerber / Excellon 仍按单文件内容显示
Preview 不再为了首帧先同步生成 2048 高质量图；需要更高质量时，优先复用已有高质量缓存
Preview 扩展在导入/渲染失败、资源受限或 Metal 不可用时，会把错误交回系统 Quick Look；最终看到的是系统通用预览或扩展失败提示，表现取决于平台

3D 场景构建阶段¶

3D 会明确显示阶段和进度，例如：

Loading
Details
View
Finishing

Import progress banner with stage and percentage

如何判断“还在正常推进”¶

可以重点看下面几项：

进度数字或阶段文本是否在变化
UI 是否还能响应基本操作
导入 banner 或 3D 加载卡片是否持续刷新

如果这三项都成立，通常属于正常等待。

哪些情况值得优先怀疑异常¶

长时间停留在同一阶段且无任何文本变化
UI 明显失去响应
同一资料在同一设备上反复停在同一位置
只有这次版本出现，历史版本没有

当前版本相关的几个事实¶

导入期间 Viewer 可能自动切到 Data，或显示覆盖当前工作区的导入遮罩，这是正常过渡行为，不代表打开失败。
如果导入长时间无响应后你强制退出应用，下一次启动会清理未完成的临时导入中转目录；已经完成的资料库文档和索引会按落盘内容重新加载。
3D 需要当前文档已经形成 board session，并包含足够板级几何；如果缺少这些输入，看到明确提示不是性能问题。
超大 IPC-2581 现在不会再被打开前的稳定性检查主动拦住；如果它真的很慢或最终失败，应按真实导入问题记录。

建议记录的信息¶

设备与平台
输入类型与大小
停留阶段
停留时长
是否还能响应操作
是否只在某个视图出现

常见问题¶

看起来在等很久，一定是故障吗？¶

不一定。大型板、首次 3D 构建、制造包识别都可能带来明显等待时间。关键是看状态是否持续推进。

为什么强调记录“停在哪个阶段”？¶

因为当前版本已经把导入和 3D 构建拆成了明确阶段，记录阶段能显著提高复现和定位效率。