文档版本 v2026.08.31.0

下载 PDF

Workbench

页面目标

帮助你用同一块侧边面板完成显隐控制、选择过滤、对象浏览和局部聚焦。

支持的平台

• iOS / iPadOS：17.0 或更高版本。
• macOS：14 或更高版本。

适合谁阅读

• 需要控制显隐、筛选和对象定位的用户
• 需要验证 Workbench 在 2D 和板级 3D 路径中表现的测试人员

准备条件

• 一个板文档已经在工作区打开
• Workbench 可见，并且状态视图可用

操作步骤

1. 先从 Visibility 开始缩小板子的可见范围。
2. 使用 Selection Filter 限制哪些对象可以被点选。
3. 使用 Objects 搜索、选择，并执行 Locate、Highlight、Isolate 或 Clear 等动作。

结果

• Workbench 可以帮你减少视觉噪声、更快找到目标，并驱动聚焦动作，同时不接管对象详情展示。

当前 Workbench 的结构

默认情况下，Workbench 包含三块主要内容：

1. Visibility
2. Selection Filter
3. Objects

它们的默认状态是：

• Visibility 展开
• Selection Filter 折叠
• Objects 展开

Workbench 会按状态类型路由：PCB 文档显示 Visibility / Selection Filter / Objects / Board Problems，原理图文档显示 Sheets / Search / Selection / Details / Problems。下面先说明 PCB Workbench，再说明原理图 Workbench。

原理图 Workbench 可以做什么

原理图 Workbench 面向查看优先的 KiCad 原理图 / 项目流程，不显示 PCB 专属的显隐和规则控制。

不引用子 sheet 的独立 .kicad_sch 可以通过 Import File 直接进入原理图 Workbench；引用子 sheet 时必须改用含有效 .kicad_pro 的 Import Folder。打开 .kicad_pro 项目时，应用优先打开与项目同名的原理图；没有同名原理图时按路径排序选择一个可用原理图。只有项目不含可用原理图时才进入 PCB Viewer，同时在 Project 中保留原理图、库、设置文件以及所选目录中的其他常规文件。

Sheets

• 显示当前项目 sheet 树、面包屑和顶层 / 子 sheet。
• 点击可打开的 sheet 会切换当前 2D 原理图画布。
• 缺失或无法打开的 sheet 会保留问题状态，而不是静默失败。

Search

• 支持 Current Sheet 和 Whole Project 两种范围。
• Facet 包含 Symbols / Nets / Labels / Text / Markers。
• 点击结果会选择对象；定位时会按需要先切换 sheet，再居中或适配目标边界。

Selection / Details

• 显示从搜索、sheet 导航或画布点选得到的原理图对象。
• 常用动作包括 Locate / Highlight / Clear。
• 同一 KiCad 项目包含 PCB 且当前选择具有精确关联对象时，会显示“在 PCB 中查看”；单画布会跳转并提供返回操作，双画布则由选择自动联动。
• 画布点选和 Workbench 选择共用同一状态，不会产生两套相互竞争的选择。

Problems

• 汇总原理图导入问题、暂不支持的内容，以及所需视图数据不可用时的明确提示。
• 如果缺少完整所需数据，界面会报告不可用原因，而不是在应用层猜对象列表。

Visibility 可以做什么

• 切换显示预设
• 调整 stackup 查看方式
• 显示或隐藏层组、单层、语义列和技术层
• 在 2D Display Grid 中按全局、层组或单层控制 DRC 标记
• 开关 Rat / Board Boundary / Place Boundary / Assembly Outline
• 修改图层颜色，或重置为默认值

2D Display Grid 中的 DRC

PCB 板完成第一帧准备后，应用会在后台运行当前板的 DRC。运行期间状态区会显示“正在准备 DRC”或执行进度；完成后，有定位证据的结果会在 2D 画布上显示为红色圆圈与叉号，成对证据还会带连接线。

• DRC 列只出现在 PCB 的 2D Visibility Display Grid，不出现在原理图或 3D 控制中。
• 点击 DRC 列标题可统一显示或隐藏全部 DRC 标记。
• 点击层组或单层行中的 DRC 单元格，可只控制对应层的标记；没有标记的单元格不可用。
• All 预设也会纳入 DRC 标记状态。重新打开板或切换运行时会话时，DRC 会按新板重新计算，不沿用旧板结果。

DRC 标记是当前完整分析结果的显示层。隐藏标记不会修改板数据，也不会重新解释或删除 DRC finding；分析未完成或返回未知层时，应用会显示明确错误，而不是发布部分标记。

实时 DRC 只对保留设计级铜对象、网络与规则语义的原生、DSN 和 KiCad 来源运行。Gerber、Excellon、ODB++、IPC-2581 等制造输出包含已经合成的层图形，应用不会把这些图形与焊盘、走线或过孔的合法重叠重新判成短路；这类来源会明确报告缺少可用于设计规则判定的铜模型，并且不会发布 DRC 标记。

当你处于 3D 时，这里还会额外显示一个 3D 小节，用于板面和辅助显示设置，包括 Show 3D models。开启后，可渲染的导入 3D 模型会优先显示；模型缺失、格式不支持或无法渲染时，才会显示简化元件体或问题记录。

Selection Filter 可以做什么

• 快速切换到 All / None / Default
• 限制哪些对象类别可以被点选
• 在需要区分 track/segment 重叠命中时显示 Pick Candidates

默认过滤保留最常见的表面目标和已布线铜对象，适合大多数日常浏览。

Objects 可以做什么

Objects 是当前版本最直接的对象浏览器。你可以：

• 在不同分类之间切换
• 输入文字过滤对象
• 从结果列表中选择目标
• 对当前选择执行动作

当前分类包括：

• Nets
• Layers
• Via Definitions
• Rule Classes

Objects 主面板只保留轻量动作：

• Locate
• Highlight
• Clear

需要运行时数据的详情通过 Details 显式打开。弹窗加载完成且当前对象类型支持时，Isolate 会出现在弹窗中。

当前职责边界

Workbench 负责：

• 显隐
• 筛选
• 搜索
• 本地对象浏览
• 聚焦 / 高亮 / 清除动作

Details 负责：

• 按需构建或复用运行时查询会话
• 展示基于会话的对象详情与网络分析
• 对支持的运行时对象执行隔离

Workbench 不会再因为选择对象而隐式创建 runtime session。

使用建议

• 先调 Visibility，再调 Selection Filter，最后用 Objects 搜索，命中率通常最高。
• 找不到目标时，先检查显隐或选择过滤是否过严。
• 记录问题时，用 Workbench 缩小目标，再回到 2D 完成实际详情查看和复制。

常见问题

为什么这里没有对象详情面板了？

当前设计把详情卡移回 2D，让 Workbench 专注在过滤和定位上。

为什么主 Objects 面板里没有 Isolate？

主面板是本地对象浏览器，不应该因为选择对象而隐式创建 runtime session。打开 Details 后，如果加载出的 runtime 对象支持隔离，弹窗内会显示 Isolate。

为什么进入 3D 后会看到额外的显隐控制？

因为工作区处于 3D 时，Workbench 会暴露额外的板级 3D 显示选项，包括模型显示相关控制。