搜索 Search on Documentation

搜索查询参考

Updated: 五月 12, 2026

本文档是 Workspace 硬件设计搜索语言中所用语法、运算符和约定的参考指南。搜索查询基于一种熟悉的 field:value 语法，可用于执行快速、简单的搜索，也可用于构建功能强大且精确的查询。

搜索语法与指南

以下参考信息按搜索目标类型分组（元件、连接等），每个部分均包含用法类别子类型、使用示例以及相应的示例查询。

元件搜索

Use Category	Application Example	Query
Basics	通过 Designator 查找已知元件。	`R14`
	通过 Designator 查找特定的 IC 元件。	`designator:U7`
	通过名称/注释查找元件（例如：ERJ-2RKF1002X，或 "Capacitor 100nF +/-20% 50V 0402"]）。	`comment:ERJ-2RKF1002X`
	通过其 Value 参数查找元件（例如：100nF 或 4.7k）。	`value:100nF`
	查找采用特定物理封装的元件（例如：QFN-48）。	`package:0402`
	查找使用特定 PCB 封装名称的元件。	`footprint:RESC0402`
Identifiers	查找表面贴装器件（SMD）元件。	`mounting:smd`
Identifiers	查找所有通孔技术（THT）元件。	`mounting:tht`
Types	查找所有无源元件（电阻、电容、电感）。	`type:passive`
	查找所有有源元件（IC、晶体管、二极管）。	`type:active`
	查找所有分类为连接器的元件。	`type:connector`
Connections	查找包含特定引脚名称或编号的元件。	`pin:SCLK`
Connections	查找包含指定方向引脚的元件。（例如：input、output、IO 等）。同时也会查找具有指定方向的端口。	`direction:output`
Parametric	查找具有特定属性或参数（例如：Tolerance）且值不限的元件。	`has:tolerance`
	查找参数具有特定值的元件	`tolerance:1%`
	查找数值参数位于某个范围内的元件。筛选。请注意，带空格的参数名称必须加引号。	`"Voltage Rating":[3V to 5.5V]`
	查找位于 Top 层且具有特定功率额定值参数的元件。	`power:63mW layer:Top`

网络搜索

Use Category	Application Example	Query
Basics	按名称查找已知网络。	`GND`
Basics	按名称查找特定电源网络（例如：VCC、GND、VSENSE）。	`net:VCC3`
Classes	查找属于某个网络类的所有网络。	`netclass:analog`
	查找特定差分对的网络。	`diffpair:USB_SYS`
	查找差分对类中的所有网络对。	`diffpairclass:USB`

连通性

Use Category	Application Example	Query
Simple Search	查找元件 U3 及与其连接的所有内容。信号路径中的无源器件（例如终端电阻和耦合电容）会被旁路。	`connectsTo:U3`
Simple Search	查找网络 'SYS_CLK' 及与其连接的所有内容。	`connectsTo:SYS_CLK`
Advanced Search	查找连接到元件 U12 的 5 号引脚的特定网络。	`connectsTo:U12.5`
	查找元件 U3 及与其连接的所有内容，但不要旁路信号路径中的无源器件（即：阻止默认的 `connectsto` 行为）。	`connectsToDirect:U3`
	查找特定 PCB 层上的所有网络。筛选	`type:net layer:L3`

设计对象

Use Category	Application Example	Query
General Types	查找特定类型的对象 [例如：pad、via、track]。	`object:pad`
General Types	查找特定网络上的特定对象（例如：地网络中的过孔）。筛选	`object:via net:GND`
Advanced	查找 PCB 中间层上的走线（trace）。（即：不是 Top 或 Bottom 层）。筛选	`object:track -layer:Top -layer:Bottom`
	查找所有指定为输出的引脚。筛选	`direction:output object:pin`
	查找所有矩形形状类型的焊盘。筛选	`object:pad shape:rectangle`

逻辑与范围筛选

Use Category	Application Example	Query
Wildcards	查找名称中在 'VCC' 后包含多个字符的所有网络（例如：VCC1、VCC_Digital、VCC_Analog）。	`net:VCC*`
Wildcards	查找 Designator 中在 'C1' 后包含单个字符的所有元件（即：电容 C11 到 C19）	`C1?`
Logic Combinations	查找 Top 层上的电容。请注意，搜索表达式之间的空格表示隐式 AND。	`type:Capacitor AND layer:Top`
	查找使用 0402 或 0603 封装的元件。	`package:0402 OR package:0603`
	显示与 U1 的所有连接，但不包括连接到 GND 网络的那些。请注意，'-' 字符等同于 'NOT' 逻辑限定符（-term:value）。	`connectsto:U1 NOT Layer:GND`
Parenthesis Logic	查找使用 0402 或 0603 封装的元件。	`package:(0402 OR 0603)`
Parenthesis Logic	查找 PCB 中间层上的走线（trace）。（即：不是 Top 或 Bottom 层）。	`object:track -layer:(Top or Bottom)`
Ranges	查找长度大于指定长度的 PCB 走线。请注意，'>' 字符会替代术语中的冒号。	`object:Track tracklength>100mm`
	查找孔径大于或等于指定直径的 PCB 焊盘。	`object:Pad holesize>=0.6mm`
	查找数值位于指定范围内的电阻。请注意使用方括号。	`R* Value:[100k to 200k]`
	查找长度在 1mm 到 1.5mm 之间的 PCB 网络。将包括连接（焊盘、过孔、引脚等）。	`NetLength:[1mm to 1.5mm]`

层级与分组搜索

Use Category	Application Example	Query
Logical Groups	查找 'DecouplingCaps' 元件类中的所有元件。	`componentClass:DecouplingCaps`
Logical Groups	查找属于 'DDR_DATA' 网络类的所有网络。	`netClass:DDR_DATA`
Physical Groups	查找指定 PCB 层（例如：Mid 3）上的所有实体。	`layer:"Mid 3"`
Physical Groups	查找 PCB 上 'RF_Shield' room 内的所有元件。	`room:RF_Shield`

物理设计

Use Category	Application Example	Query
Physical Properties	查找走线长度大于 50mm 的高速网络。筛选	`netClass:HighSpeed netlength:>50mm`
	显示宽度大于 10 mil 的板级走线（track）。筛选	`object:track trackwidth:>10mil`
	查找钻孔孔径小于 8 mil 的过孔。筛选	`object:via holesize:<8mil`

文档搜索

Use Category	Application Example	Query
Document Objects	查找设计 PCB 文档（例如：'Module1'）上的所有对象。	`document:module1.pcbdoc`
	查找 'Power' 原理图文档上的所有对象。	`sheet:power.schdoc`
	查找指定原理图上的电阻。	`sheet:power.schdoc type:resistor`

库管理

Use Category	Application Example	Query
Status	查找具有 PCB 封装但没有 3D 模型的所有元件。筛选	`has:footprint -has:model3d`
Status	查找任何没有仿真模型的元件。	`-has:simulation_model`
Parts Source	从特定库来源查找已使用的元件（例如：Workspace、内部零件库存、project.IntLib）。	`Library_Path:”Company Stock”.`

适合打印版本

AI-Localized

AI 翻译

如您发现任何问题，请选中相关文本/图片，并按 Ctrl + Enter 键向我们提交反馈。

Content