元件模板

Updated: 十月 15, 2026

概览

已连接的 Workspace 中的元件模板可提供可重复使用的设置和参数，帮助简化 Altium Designer 中的元件创建流程。本文介绍如何组织元件模板条目、选择命名和生命周期方案，以及通过直接编辑来定义模板并将其保存到 Workspace。此外，还将介绍参数可见性、默认值、必填字段以及设计人员覆盖权限的相关控制选项。继续阅读，开始构建可重复使用的模板，让元件定义更加一致。

- 了解如何设置 Workspace 文件夹和元件模板条目，并为其配置适当的命名、修订和生命周期方案。
- 了解模板如何控制元件参数，包括必填值和只读默认值。
- 探索如何直接编辑模板，并将其作为新的修订版保存回 Workspace。

使用 AI 深入了解：

为简化元件创建流程，Altium Designer 可与您连接的工作区配合使用，支持在该工作区中创建和定义 Component Templates （元件模板条目）。正如原理图模板可为引用它的原理图图纸预定义信息一样，元件模板由工作区库元件引用，并提供定义该元件时使用的预定义设置。

元件模板在开发时尤其注重参数信息，让您能够在一个位置定义一组参数，供引用该模板的元件使用。通过模板，您可以控制哪些参数可见、填写默认值，甚至将必要参数标记为必填项。保存元件时，系统会执行验证检查，以确保符合要求。

模板中许多设置的默认值可以锁定为只读，也可以有选择地允许设计人员在定义元件时覆盖。

元件模板也是创建通用元件的基础。有关详细信息，请参阅创建通用元件页面。

能否访问元件模板取决于软件许可。有关详细信息，请参阅页面右侧的 Note 框。

此类元件模板直接在工作区中创建。创建元件模板并将数据保存到其某个修订版后，即可重复使用该模板来创建一个或多个元件。

文件夹类型

创建用于存储元件模板的文件夹时，可以指定文件夹类型。这不会影响文件夹中的内容——发布元件模板始终会生成相应的元件模板条目。它只是提供一个直观的“提示”，表明文件夹中存储的内容，便于在工作区中浏览并查找特定内容。要指定某个文件夹用于存储元件模板，请在编辑文件夹对话框中定义文件夹属性时，将其 Folder Type 设置为 Component Templates。

指定文件夹类型（即其预期用途），可在浏览工作区时直观地指示该文件夹的内容。

条目命名方案

父文件夹的另一个重要方面是其采用的 Item Naming Scheme。它定义了在该文件夹中创建的每个条目的唯一 ID 格式。系统提供了多种默认示例方案，使用文件夹类型（CTC——元件模板集合）或内容类型（CMPT——元件模板）的缩写代码：

$CONTENT_TYPE_CODE-001-{0000}——例如，CMPT-001-0001。
$CONTENT_TYPE_CODE-001-{A00}——例如，CMPT-001-A01。
$FOLDER_TYPE_CODE-001-{0000}——例如，CTC-001-0001。
$FOLDER_TYPE_CODE-001-{A000}——例如，CTC-001-A001。

使用默认命名方案时，软件会扫描整个工作区及现有内容的标识符，然后根据该方案自动分配下一个可用的唯一 ID。这可以在手动创建元件模板时节省大量时间。

您还可以直接在字段中输入自定义方案，为文件夹定义命名规则，但必须确保可变部分用花括号括起来（例如 CMP-TMP-{0000}）。

父文件夹的条目命名方案会应用于该文件夹中创建的每个条目的唯一 ID。

可以随时更改父文件夹采用的 Item Naming Scheme。修改后的方案将应用于此后在该文件夹中新创建的所有内容。

内容类型

创建用于存储元件模板的目标元件模板条目时，请确保在创建新条目对话框中，将其 Content Type 设置为 Component Template。如果您在 Component Templates 类型的文件夹中创建条目，则创建时可从右键快捷菜单中选择此内容类型。

在 Component Templates 文件夹中创建元件模板——快捷菜单中提供了正确的 Content Type。

条目生命周期定义和修订版命名

定义元件模板时，请务必分别指定元件模板所使用的生命周期管理类型，以及其修订版所采用的命名方案。

定义各个方案时，可以在 Content Types 对话框中从全局层面定义并启用控制，指定哪些内容类型可以使用特定的生命周期定义或修订版命名方案。分配给元件模板使用的默认方案分别为：Generic Lifecycle 和 1-Level Revision Scheme。

一旦将模板定义保存到元件模板条目的初始修订版中，就无法再更改该条目的这些方案。

在 Create New Item 对话框中，分别使用 Lifecycle Definition 和 Revision Naming Scheme 字段指定所需方案。

如果某个定义或方案启用了按内容类型控制生命周期定义和修订版命名方案使用范围的选项，而元件模板内容类型未设置为使用该定义或方案，则相应的下拉列表中将不会提供该定义或方案。

为手动创建的元件模板选择生命周期定义和修订版命名方案。

在工作区的各类设计内容中遵循标准的修订版命名方案和生命周期定义，可确保对这些内容进行顺畅、一致的管理。

建议在元件模板定义中添加名称和描述。搜索工作区时会使用这些信息，帮助您快速了解元件模板所提供的内容。

保存元件模板

Related page: 创建和编辑内容

到目前为止，我们已从相关文件夹和内容类型的角度，介绍了工作区对元件模板的支持。您可以通过简化的流程，将实际定义的元件模板保存到此类元件模板条目的某个修订版中。

借助工作区对直接编辑的支持，您可以编辑元件模板，并将其保存到新建元件模板条目的初始修订版中。直接编辑使您不必再单独管理受版本控制的源数据。您只需使用临时编辑器，即可编辑受支持的内容类型；该编辑器会直接从工作区加载最新的源数据。编辑完成后，该实体将保存（或重新保存）到其父条目的下一个计划修订版中，随后临时编辑器关闭。您的硬盘上不会留下文件，无需担心使用的源数据是否正确或是否为最新版本，也无需维护单独的版本控制软件。工作区会妥善处理这一切，确保数据完整性，并大幅加快数据更改流程。

创建元件模板条目时，您可以选择在创建后编辑元件模板，并将其保存到该条目的初始修订版中。为此，请启用 “创建新条目”对话框底部的 Open for editing after creation 选项（默认已启用）。条目创建后，临时元件模板编辑器将打开，并在主设计窗口中将 .CMPT 文档显示为活动文档。该文档将根据条目及其修订版命名，格式为： <Item><Revision>.CMPT（例如 CMPT-0001-1.CMPT）。

直接从工作区编辑元件模板初始修订版的示例——临时元件模板编辑器提供了用于定义元件模板的文档。

使用该文档根据需要定义元件模板。有关详细操作信息，请参阅定义模板。

直接编辑时，可通过 Quick Access Bar（位于主应用程序窗口左上角）或 Component Template Standard 工具栏便捷地使用以下三个相关控件：

– Save Active Document。使用此按钮可在本地保存对文档所做的任何更改。如果您希望稍后返回继续修改，再最终保存到工作区，可以先使用此按钮保存当前更改。
/ – Save to Server。使用此按钮可将定义好的元件模板保存到工作区，并存储在目标元件模板条目的初始（计划）修订版中。此时将显示 Edit Revision 对话框，您可以根据需要更改名称、描述并添加发布说明。保存后，文档和编辑器将关闭。包含源元件模板的文档 *.CMPT 将存储在该条目的修订版中。

在 Projects 面板中，元件模板条目右侧也提供了一个便于使用的 Save to Server 控件。
/ – Discard Local Changes。如果希望取消编辑并放弃所做的任何更改，请使用此按钮。文档和编辑器将关闭，不会向目标元件模板条目发布任何内容。

这些控件也以命令形式提供，包括 Save（快捷键：Ctrl+S）、Save to Server（快捷键：Ctrl+Alt+S）和 Discard Local Changes，可从主 File 菜单以及 Projects 面板中元件模板条目的右键菜单访问。

保存在工作区中的数据包含源元件模板，该模板定义在元件模板文件（<Item><Revision>.CMPT）中。

已定义并保存回工作区的元件模板示例。

继承元件模板

在高级设置对话框中启用 UI.ComponentTemplateInheritance 选项后，即可使用此功能。

如果子类型未链接元件模板，则可以使用根元件类型的元件模板。构建元件类型层次结构时，元件子类型将继承分配给根/父元件类型的元件模板。

CMPT（元件模板）编辑器

要在 Altium Designer 中访问元件模板编辑器，必须安装 Component Template Editor 软件扩展。此扩展默认随 Altium Designer 一起安装，也可以手动安装或移除。

有关管理扩展的更多信息，请参阅 Extending Your Installation 页面（Altium Designer Develop、Altium Designer Agile、Altium Designer）。

定义模板

元件模板编辑器主要分为两个区域，如下图所示，后文将分别概述。

元件模板编辑器大致可分为两个主要区域。

Upper Region – 用于为引用该模板的元件定义元件级选项（生命周期、命名和文件夹选项）。
Lower Region – 用于定义引用该模板的元件所使用的参数。

指定元件选项

编辑器的上半部分用于定义以下元件属性的默认值：

Lifecycle Definition – 选择要应用于使用该模板创建的元件的生命周期定义。下拉字段列出了工作区中定义的、允许元件使用的所有定义。
Revision Naming – 选择要应用于使用该模板创建的元件的修订版命名方案。下拉字段列出了工作区中定义的、允许元件使用的所有方案。

如果已为任何定义/方案启用按内容类型控制生命周期定义和修订版命名方案使用情况的选项，而 Component 内容类型未设置为使用某个特定的定义/方案，则该定义/方案将不会出现在相应的下拉列表中。
Component Naming – 使用此字段为使用该模板创建的元件定义默认的条目命名方案，确保生成的元件在工作区中具有唯一 ID。此处的条目将用作自动命名元件的模板（在元件编辑器的 Single Component Editing 模式下使用关联的 Id 字段，在元件编辑器的 Batch Component Editing 模式下使用 Item ID 字段）。软件将扫描整个工作区及现有内容的标识符，然后根据该方案自动分配下一个可用的唯一 ID。系统提供了默认的条目命名方案 CMP-{00000}，当然，您也可以在此字段中输入自己的方案，但需确保将可变部分括在花括号中（例如 CMP-001-{0000}）。
Default Folder – 指定目标工作区中用于存储已保存元件的默认文件夹。为此，单击 Choose 按钮，打开 Choose Folder 对话框（Explorer 面板的一种形式），然后在其中浏览并选择工作区中的现有文件夹，或即时创建新文件夹。

没有用于设置目标工作区的字段，因为目标工作区已在程序中固定为元件模板修订版所在的工作区。

每个属性的 Allow override 选项可用于单独控制用户在元件编辑器中定义元件时是否能够更改该属性（启用时可更改，禁用时不可更改）。

引用此模板时，此区域中指定的条目将用于预填元件编辑器中相应的字段（如有）：

Single Component Editing mode – Component 区域的 Advanced Settings 区中的 Id 和 Folder 字段。
Batch Component Editing mode – 位于文档选项对话框的 Document Options 选项卡上，并因此用于预填元件定义区域的 Component 区中的 Item ID 和 FolderPath 字段。

引用此模板时，这些条目将用于预填在元件编辑器的 Single Component Editing 模式（左）和 Batch Component Editing 模式（右）下编辑元件时的相应字段。

定义参数

编辑器的下半部分专门用于定义和管理供引用此模板的元件使用的参数。

元件模板中定义的参数示例。

默认系统参数

创建新的元件模板时，默认会包含各种系统参数，如下图所示，后文将详细介绍。

新建元件模板中包含的默认系统级参数。

ComponentType – 此参数允许您指定元件类型。这有助于利用工作区强大的搜索功能进行有针对性的搜索。该功能不仅支持按元件类型搜索，还支持利用可识别单位的元件参数进行更智能的搜索。使用 Components 面板浏览您自己工作区中的元件时，元件的 Categories 分组源自与各元件关联的 ComponentType 参数。单击关联的 Default Value 字段，然后单击按钮，打开 Choose component type 对话框。在其中选择所需的元件类型，然后单击 OK，所选类型将作为 ComponentType 参数的值填入主参数表格。

Choose component type 对话框显示了在 Preferences 对话框的数据管理 – 元件类型页面上定义的元件类型集合。单击 Choose component type 对话框底部的按钮，可访问此首选项页面，您可以在其中添加新的类型和子类型，或编辑和删除现有类型，使此列表更符合您的需求。

元件模板示例，其中 ComponentType 系统参数设置为 Diodes。

此参数的数据类型设置为 ComponentType，且无法修改。此外，ComponentType 参数无法删除。选中单元格并使用 Delete 键可清除其值。
SCHLIB 和 PCBLIB – 这两个参数分别用于指定默认的符号模型和封装模型。单击每个参数关联的 Default Value 字段，然后单击按钮，打开用于选择所需模型的对话框。

请注意，您选择的是模型，而不是该模型的某个特定修订版。这样，使用此模板的元件将始终使用所选模型的最新修订版。

在模板中指定符号和封装模型。

这些参数的数据类型分别设置为 SCHLIB 和 PCBLIB，且无法修改。此外，模型参数无法删除。选中单元格并使用 Delete 键可清除其值。
Name 和 Description – 这两个参数分别用于定义元件的名称和描述。在每个参数关联的 Default Value 字段中输入所需的字符串。

在模板中指定 Name 和 Description 参数。

这两个参数的数据类型均设置为 Text，且无法修改。此外，这些参数也无法删除。

支持复制粘贴系统参数，并可在模板文档之间进行粘贴。

在元器件模板中选择一个或多个参数，然后使用所选参数右键菜单中的 Copy 命令（快捷键：Ctrl+C）。随后，可使用右键菜单中的 Paste 命令（快捷键：Ctrl+V）将复制的参数粘贴到另一个元器件模板中。

SCHLIB、Name 和 Description 系统参数已在 Diodes 元器件模板中选中并复制。

这些参数已粘贴到另一个元器件模板（Zeners）中，其值也已应用于相应参数。

添加新的用户参数

要在列表中添加新的用户参数，请单击按钮（或使用右键上下文菜单中的 Add 命令），该参数将添加到当前列表的底部。

向模板中添加新用户参数的示例。

网格列表通过以下信息显示每个参数：

Name – 使用此字段为参数命名，通常应使用能够表达其用途的有意义的名称。初次添加时，参数会被赋予默认名称（Parameter、Parameter 1、Parameter 2 等）。
Type – 参数的类型。此项最初默认为 Text，但支持多种支持单位的数据类型，以及便于定义多个封装的 PCBLIB 类型和便于定义线束接线元器件的 HarnessWiring 类型。还支持可用字典中定义的参数类型 – 了解更多。
Visible – 启用此选项（新添加参数的默认状态），可在元器件编辑器中编辑一个或多个元器件时（配置为 Batch Component Editing 模式），为该参数启用相应的 Show 选项。这进而控制元器件编辑器下方区域中该参数对应列的显示，该区域用于定义元器件本身。使用编辑器的 Single Component Editing 模式定义元器件时，此属性不起作用。
Read Only – 启用此选项可将参数设为只读。编辑引用该模板的元器件时，该参数的值将无法编辑。
Required – 启用此选项可将参数设为“必填参数”。编辑引用该模板的元器件时，必须为该参数定义一个值，否则无法保存元器件。在元器件编辑器中，如果此类参数尚未输入值，其值单元格会以红色边框标示（在 Batch Component Editing 模式下），或显示图标（在 Single Component Editing 模式下）。
Default Value – 使用此字段输入参数的默认值。
- 如果参数被标记为必填（启用了 Required 选项），同时又被设为只读（启用了 Read Only 选项），则 MUST 输入默认值。否则，在编辑引用该模板的元器件时，该参数会被标记为未赋值，但由于该参数为只读、无法编辑，因此无法解决此问题。在解决此问题之前，无法将此元器件模板的新修订版保存到工作区。
- 编辑元器件的修订版时，如果现有用户自定义参数与所链接元器件模板中的某个参数同名，则该参数将被替换为模板中的版本。该参数的任何现有值都将保留（不会被模板中的默认值覆盖）。
Description – 为参数添加描述，例如简要说明其用途。如果模板中的某个参数定义了描述，则元器件编辑器的 Single Component Editing 中的 Parameters 区域将相应显示 Description 列。

参数列表还支持简单的复制和粘贴操作，便于复制一个或多个现有用户参数。粘贴的参数将添加到列表底部。

支持标准的复制（Ctrl+C）和粘贴（Ctrl+V）快捷键，也可以从右键菜单中使用这些命令。可以使用标准的 Ctrl+Click 和 Shift+Click 方式选择多个用户参数，以执行复制粘贴操作。

要从列表中删除一个或多个用户参数，请选中各个参数，然后单击

按钮，或使用右键上下文菜单中的 Remove 命令。

列的顺序和宽度

可以自定义列的顺序。单击列标题，并将其水平拖动到所需的新位置。有效位置会通过垂直位置箭头突出显示。

单击并拖动列标题右侧的分隔线，可以调整该列的宽度。

排序

单击某一列的标题，可以按该列对参数进行排序。单击一次可按升序排序（基于该列的内容）。再次单击可按降序排序。

可以按多个列进行排序。在参数已按某一列排序的情况下，对另一列执行 Shift+Click，即可按该列的内容进行“次级排序”。

要取消某一列的排序，请对其标题执行 Ctrl+Click。

可识别单位的元件参数数据类型

元件模板编辑器支持为元件模板（*.CMPT）中定义的元件参数指定明确的数据类型。此外，这些数据类型能够识别单位，并支持多种常用的单位前缀。因此，您可以使用多种格式输入参数值，例如 2.2k、2k2、4M、2.5GHz，工作区具备相应的智能识别能力，可识别这些输入所代表的数值。

元件模板的这一特性有助于通过服务器的高级搜索功能进行精准搜索。此功能不仅支持按元件类型搜索，还支持通过范围搜索实现更智能的查找。借助可识别单位的元件参数，您可以快速定义搜索条件，例如查找电容量介于 47uF 和 220uF 之间的所有电容器。

使用 Components 面板搜索您自己的元件时，可识别单位的参数也可用于智能筛选。

展开以下折叠部分，了解有关可识别单位的参数的更多信息。

支持的单位

在元件模板中定义用户参数时，支持以下可识别单位的数据类型：

大多数数据类型都有单位（括号中所示）。如果在输入参数值时未指定单位，则会采用该单位。

整数
小数
安培 (A)
面积 (mm²)
比特
坎德拉 (cd)
摄氏度 (C)
分贝 (dB)
法拉 (F)
克 (g)
亨利 (H)
赫兹 (Hz)
焦耳 (J)
流明 (lm)
米 (m)
毫米 (mm)
欧姆
百分比 (%)
帕斯卡 (Pa)
巴 (bar)
磅每平方英寸 (psi)
转每分钟 (rpm)
秒 (s)
西门子 (S)
温度系数 (ppm/°C)
特斯拉 (T)
伏特 (V)
瓦特 (W)

支持的单位前缀

下表列出了为支持单位的参数类型输入值时可使用的单位前缀。

前缀	名称	数值（科学计数法）	数值（常规表示法）
T	太拉	1 x 10¹²	1,000,000,000,000
G	吉伽	1 x 10⁹	1,000,000,000
M	兆	1 x 10⁶	1,000,000
k	千	1 x 10³	1,000
m	毫	1 x 10^-3	1 / 1,000
u	微	1 x 10^-6	1 / 1,000,000
n	纳	1 x 10^-9	1 / 1,000,000,000
p	皮	1 x 10^-12	1 / 1,000,000,000,000
f	飞	1 x 10^-15	1 / 1,000,000,000,000,000

请注意，根据参数类型的不同，部分或全部单位前缀可能不适用。例如，百分比不能使用任何单位前缀。如果使用了无效的单位前缀，软件会发出提示。

添加支持单位的元件参数

向模板添加参数时（单击 Parameters 区域中的），使用对应的 Type 字段从下拉列表中选择所需的支持单位的数据类型。

为元件模板中的用户参数选择受支持的单位感知数据类型。在此示例中，参数类型为 Ampere。

为使用支持单位的数据类型的元件参数输入值时，无论是作为元件模板中的 Default Value，还是作为元件定义中的所需值，都需要考虑以下事项：

您可以使用多种不同格式输入值：
- 仅输入数值（例如 10）。请注意，如果数据类型带有单位，系统会自动应用该单位。带有单位的类型会在名称后面的括号中显示其单位。
- 以科学计数法输入数值（例如 1e10、1E6）。
- 输入数值和单位（例如 10F)）。
- 输入带前缀的数值（例如 10k）。系统会自动添加适当的单位（如适用）。
- 输入带前缀和单位的数值（例如 10kF）。
- 以典型工程格式输入带前缀的数值（例如，对于电阻：2k2、2K2、10r2、10R2）。该值会自动进行相应的规范化处理（例如，2K2 将变为 2.2k）。
输入前缀和/或单位时，数值后可以带空格，也可以不带空格（例如 10uF 或 10 uF）。空格会被自动去除。

请注意，工程缩写不区分大小写，因此输入 2k2 与输入 2K2 相同，输入 100R 与输入 100r 相同。唯一的例外是 M（兆）和 m（毫）。

数据验证

当元件参数使用支持单位的数据类型时，系统会根据指定的数据类型验证输入值。这可确保使用该数据类型所对应的正确计量单位。例如，类型为 Celsius 的参数不能具有 10V 这样的值！

只要使用了支持单位的数据类型的元件参数并为其提供了值，系统就会执行验证：

在元件模板中为参数定义默认值时。
在元件编辑器中定义元件时为参数指定值时。
在已保存的搜索方案中配置基于参数值的范围搜索时。

在元件模板编辑器中执行数据验证的示例。

字典定义的参数数据类型

字典是包含多个预定义值的自定义参数类型。字典由工作区管理员在工作区浏览器界面的 Settings – Vault – Dictionaries 页面上管理。在元件模板编辑器中，从 Type 下拉列表中选择 Add New Dictionary 选项，或单击 Parameters 区域右上角的 Manage Dictionaries 控件，即可访问该页面。

您也可以通过以下方式访问 Settings – Vault – Dictionaries 页面：在 Preferences 对话框的数据管理 – 字典页面中单击 Manage Dictionaries 控件；或在 Preferences 对话框的数据管理 – 服务器页面中，单击当前活动工作区或已知工作区对应的 Properties 控件，然后从菜单中选择 Dictionaries 条目。
当为参数选择了字典定义的类型时，也可以单击该参数在 Type 列中的单元格，然后单击按钮 ()，以访问 Settings – Vault – Dictionaries 页面。

从元件模板编辑器访问工作区浏览器界面中的字典管理页面。

进一步了解如何通过工作区浏览器界面管理字典（Altium 365 工作区、Enterprise Server 工作区）。

已定义的字典可在 Type 下拉列表中作为参数类型使用。

在“类型”下拉列表中选择字典定义的参数类型。

为所选字典定义类型设置的值可在 Default Value 下拉列表中找到。选择所需的值作为参数的默认值，或选择 <None>。

从所选字典定义类型的已定义值中选择一个默认值。

将元件模板保存到工作区时，系统会验证默认值。如果默认值与字典不一致（例如，该值已从字典中移除，随后又打开了使用该值的模板进行编辑），则该默认值将在“默认值”列中以红色高亮显示，并且在尝试将模板保存回工作区时，Messages 面板中会显示错误消息。
如果元件参数的值与字典不一致（例如，在元件模板中，该参数的类型已从文本切换为字典定义类型，而当前元件值与所选字典定义类型中的任何值都不匹配），则在元件编辑器中编辑元件时，该参数将被高亮显示：在编辑器的单元件编辑模式下编辑元件时，不一致的参数值旁会显示感叹号图标；在编辑器的批量元件编辑模式下编辑元件时，该参数值将以红色高亮显示。请确保所有元件参数均与模板值一致，否则将无法将元件保存为下一修订版。
如果在所连接工作区的浏览器界面中更改了字典，则需要断开与工作区的连接并重新连接，才能在 Altium Designer 中体现这些更改。有关更多信息，请参阅访问您的工作区页面。

定义多个封装

元件模板编辑器还支持在元件模板中定义多个 PCB 封装。您可以指定任意数量的封装模型链接，这对于希望创建引用 3 个封装的元件的用户而言非常实用，可满足 IPC 对不同密度等级的要求：L（最少，即最小铜量）、M（最多，即最大铜量）和 N（标称，即中等铜量）。

要向模板添加额外的封装模型定义，请单击添加新参数，然后在 Type 字段对应的下拉菜单中选择 PCBLIB 条目。

将新添加参数的 Type 设置为 PCBLIB，即可将其转换为封装模型定义。

参数名称将从 Parameter 更改为 PCBLIB n，其中 n 是下一个可用的整数，用于区分多个封装模型（例如 PCBLIB 1、PCBLIB 2，依此类推）。与 PCBLIB 条目关联的模型将作为默认模型。在定义元件时，将封装引入元件编辑器后，默认封装模型会通过模型预览窗口左上角的图标（在 Single Component Editing 模式下）以及 Required Models/Parameters 区域中的 PCBLIB (default) 条目（在 Batch Component Editing 模式下）加以标识。

在元件编辑器（Single Component Editing 模式）中使用所引用的元件模板定义元件的示例。模板定义了三个封装模型，这些模型会被引入元件定义中。请注意，在定义元件时，模板中的 PCBLIB 模型条目被用作默认封装模型（通过其左上角的图标加以标识）。将鼠标悬停在图像上，可查看在元件编辑器的 Batch Component Editing 模式下定义同一元件的情况。在此情况下，默认封装称为 PCBLIB (default)。

元件模板的导入和导出

可以将现有元件模板文件（*.CMPT）或元件库文件（*.CMPLIB）导入元件模板编辑器，也可以将正在编辑的元件模板导出为元件模板文件（*.CMPT）。使用元件编辑器主菜单中的 File » Import » Component Template、File » Import » Component Library 和 File » Export 命令选择所需操作，然后在打开的标准 Windows 对话框中浏览到所需位置，选择要导入的文件或指定要导出的文件的名称。

复用元件模板

使用元件模板的某个修订版——更准确地说，是从当前正在编辑的元件修订版中引用元件模板的某个修订版——可以通过以下方式实现。

一个元件一次只能引用一个元件模板。

创建新元件时

使用主菜单中的 File » New » Component 命令创建新元件时，可以在 Create new component 对话框中选择模板。

创建新元件时，从所有可用模板的列表中快速链接元件模板。

在元件编辑器中手动链接

在元件编辑器中复用元件模板修订版的方式取决于编辑器的工作模式。

在单元件编辑模式下

在元件编辑器的此模式下编辑单个元件时，请从 Template 字段对应的下拉菜单中选择所需的元件模板，该字段位于编辑器 Component 区域的 Advanced Settings 分组中。列表按名称列出元件所在工作区中当前可用的所有元件模板，并在括号中标明其最新修订版。选择所需模板即可应用。

使用元件编辑器的 Single Component Editing 模式编辑元件修订版时，从所有可用模板的菜单中快速链接元件模板。

在批量元件编辑模式下

可通过以下两种方式，将元件模板的某个修订版“关联”到当前正在编辑的元件修订版：

在文档选项对话框（Edit » Document Options）的 Template 选项卡中操作。单击 Item Revision 字段右侧的 Choose 按钮。这将打开 Choose Item 对话框（资源管理器面板的一种呈现形式）。使用此对话框浏览并选择所需元件模板的修订版。单击 OK 后，将在元件修订版与元件模板的目标修订版之间建立链接。返回 Document Options 对话框的 Template 选项卡，即可看到此链接。

手动将元件链接到目标工作区中元件模板的某个修订版。

可以随时更改所使用的元件模板——单击 Choose，然后选择其他元件模板的某个修订版。

所链接的元件模板条目修订版的状态会显示在 Document Options 对话框的 Template 选项卡上。如果所链接的条目有更新的修订版可用，请单击按钮以使用该最新修订版。
从元件编辑器中与 Required Models/Parameters 区域关联的 Add 菜单操作。Templates 子菜单按名称列出元件所在 Workspace 中当前可用的所有元件模板，并在括号中标明其最新修订版。单击某个条目，即可创建指向该元件模板最新修订版的链接。同样，您可以在 Document Options 对话框的 Templates 选项卡上确认此链接。

从包含所有可用模板的菜单中快速链接元件模板。

从 Workspace 的 Components 文件夹继承

您可以指定一个元件模板，自动应用于 Workspace 中某个 Components 文件夹内存储的所有元件及其修订版。

只能为 Components 类型的文件夹定义默认元件模板。

在编辑文件夹对话框中定义文件夹属性时，使用 Component Template 字段指定所需模板。该字段的下拉列表按名称列出 Components 文件夹所在 Workspace 中当前可用的所有元件模板，并在括号中标明其最新修订版。选择一个条目，即可为此后在该文件夹中创建的每个元件建立指向该元件模板最新修订版的链接。

指定默认元件模板，将其应用于父级 Components 文件夹中创建的所有元件。

如不使用此功能，请将 Component Template 字段保留或设置为 None。

如果在文件夹级别选择了元件模板，则在其下的子文件夹中创建元件时，默认也会使用同一模板。这便于子文件夹中的所有元件快速继承模板。

将元件的某个修订版保存到 Workspace 时，实际上会锁定所使用的元件模板的特定修订版，与该修订版建立强关联，除非手动更改。

使用元件模板对元件模型和参数的影响

编辑元件的某个修订版时，如果链接或引用了元件模板的某个修订版，元件编辑器中的模型和参数将发生以下变化：

引用模板中定义的模型会添加到 Models 区域（Single Component Editing 模式）和 Model Links 区域（Batch Component Editing 模式）。
现有的已引用模型将予以保留，除非有意手动更改，否则元件会继续使用该模型。
引用模板中定义的参数会添加到 Parameters 区域（Single Component Editing 模式）和 Required Models/Parameters 区域（Batch Component Editing 模式）。

在元件编辑器中使用 Single Component Editing 模式（左）和 Batch Component Editing 模式（右）时，链接到元件模板某个修订版后的参数示例。

所有源自所引用元件模板的参数均使用图标（Single Component Editing 模式）和图标（Batch Component Editing 模式）加以区分。此外，仅在批量元件编辑模式下，每个基于模板的参数的 Show 选项均遵循模板中相应 Visible 选项的状态。

基于模板的参数无法删除。

您可以根据需要自由添加其他用户参数。
仅在 Batch Component Editing 模式下，设置为显示的基于模板的参数会集中显示在编辑器的元件定义区域中，并以 Template Parameters 作为标题文本。

在元件编辑器的 Batch Component Editing 模式下，基于模板的示例参数在元件定义区域中的显示效果。
对于已标记为只读的基于模板的参数，其值字段不可编辑。对于所有其他未标记为只读的基于模板的参数，您可以根据需要自由更改其值。

当元件编辑器处于 Single Component Editing 模式时，只读模板参数在 Parameters 区域中使用图标加以区分。
如果某个基于模板的参数已标记为必填，但未在模板中赋值，则其值字段会显示红色边框（在 Batch Component Editing 模式下），或包含图标（在 Single Component Editing 模式下），提醒您必须为该参数赋值。只有为所有必填参数定义值后，才能将元件保存到 Workspace。

当元件编辑器处于 Single Component Editing 模式时，必填模板参数在 Parameters 区域中使用图标加以区分。

重新保存元件模板

您随时可以返回 Workspace 中元件模板的任意修订版并直接编辑。右键单击该修订版，然后从右键菜单中选择 Edit 命令。临时编辑器将再次打开，并打开该修订版中包含的模板以供编辑。根据需要进行更改，然后将元件模板保存为该条目的下一个修订版。

右键单击元件模板本身的顶层条目，将编辑该模板的最新修订版。

访问用于直接编辑元件模板现有修订版的命令。

下载已保存的数据

要下载元件模板某个修订版中存储的数据，请在 Explorer 面板中右键单击该修订版，然后从右键菜单中选择 Operations » Download 命令。元件模板文件将下载到所选目录下的一个子文件夹中，该子文件夹以条目修订版 ID 命名。您可以在其中的 Released 文件夹中找到该文件。

从元件模板本身的顶层条目访问 Download 命令，即可下载该模板最新修订版中存储的元件模板文件。

单击 Download from Server 对话框中的 Explore 按钮，即可快速打开下载文件夹。

软删除

连接到 Workspace 后，您可以使用灵活的删除功能，直接在 Altium Designer 的 Explorer 面板中移除元件模板。右键单击面板中的元件模板条目，然后从右键菜单中选择 Delete Item 命令。随后将显示 Delete Items 对话框，供您确认删除。此操作实际上是“软删除”，即将元件模板移至 Workspace 的 Trash 区域。Trash 本质上是一个回收站，Workspace 中的任何内容都可以通过软删除操作移入其中。该区域与 Workspace 的其余部分隔离。

借助软删除功能，您可以删除当前正在使用的元件模板。

您可以一次删除多个元件模板。使用标准多选操作（Shift+Click、Ctrl+Click）选择所有需要删除的元件模板，然后右键单击并从右键菜单中选择 Delete Items 命令。

对元件模板执行软删除。该模板将移至 Workspace 的 Trash 区域。

要继续删除，请单击按钮。该条目将被移除，随后会显示 Deletion Summary 对话框，确认删除成功。如果删除过程中出现问题，系统会向您提示。

通过这种方式删除的所有内容都可以在工作区浏览器界面的 Trash 页面上找到。请注意，您只能查看由您本人软删除的内容。管理员可以查看 Trash 页面的全部内容，即所有已软删除的内容。

关于已软删除的元件模板，需要注意以下事项：

该元件模板在设计软件和 Web 界面中均不可用。
所有使用该元件模板的位置都会显示该元件模板已被删除。
如果您具有编辑权限，可以从 Trash 页面恢复或永久删除元件模板。只有在该模板未被父条目使用时，才能将其永久删除。

请注意，如果您已软删除某个元件模板（即将其移至 Trash），则可以再次创建同名的新元件模板。如果之后恢复原始元件模板，而其原始名称已被占用，系统将为其名称添加整数后缀，以确保其名称在工作区内保持唯一。

适合打印版本

AI 翻译

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

功能可用性

您可使用的功能取决于您所采用的 Altium 解决方案——Altium Develop、Altium Agile Teams、Altium Agile Enterprise，或 Altium Designer（在有效订阅期内）。

如果您在实际软件中未看到文档中介绍的某项功能，请联系 Altium Sales 了解更多信息。

旧版文档

Altium Designer 文档不再提供版本区分。如果您需要访问 Altium Designer 旧版本的文档，请前往其他安装程序页面的旧版文档部分。