To place a symbol in your schematic, use the button or the A hotkey. The Choose Symbols dialog appears and lets you select a symbol to add. Symbols are grouped by symbol library.

By default, only the symbol/library name and description columns are shown. Additional columns can be added by right-clicking the column header and selecting Select Columns.

The Choose Symbol dialog filters symbols by name, keywords, description, and all additional symbol fields according to what you type into the search field.

有一些高级筛选器可用：

如果符号指定了一个默认的封装，这个封装将在右下方预览。如果符号包括封装过滤器，可以在右边的封装下拉菜单中选择满足封装过滤器的备用封装。

选择一个要放置的符号后，该符号将被附在光标上。 左键点击原理图中所需要的位置，将符号放入原理图中。在将符号放入原理图之前，你可以通过热键或右键菜单来旋转它、镜像它和编辑它的字段。这些操作也可以在放置后进行。

如果 放置重复副本 选项被选中，在放置一个符号后 KiCad 将开始放置该符号的另一个副本。这个过程一直持续到用户按下 Esc。

对于有多个单元的符号，如果 放置所有单元 选项被选中，在放置符号后 KiCad 将开始放置该符号中的下一个单元。 这将持续到最后一个单元被放置或用户按下 Esc。

一个 《电源符号，电源符号》是一个代表与电源网络连接的符号。 这些符号被分组在 power 库中，所以它们可以使用符号选择器来放置。 然而，由于电源的放置很频繁， 工具是可用的。这个工具也类似，只是搜索是直接在 power 库和任何其他包含电源符号的库中进行。

符号可以用移动（M）或拖动（G）工具移动。这些工具作用于选定的符号，或者如果没有选定符号，则作用于光标下的符号。

移动 工具移动符号本身，而不保持与符号引脚的导线连接。

拖动 工具在移动符号时不会破坏其引脚的导线连接，因此也会移动连接的导线。

你也可以用鼠标点击并拖动符号，这取决于偏好设置中 鼠标和触摸板 部分的 左键拖动手势 设置。

符号也可以旋转（R）或在X（X）或Y（Y）方向上进行镜像。

符号的字段可以在符号的属性窗口中进行编辑。用 E 热键或通过双击符号来打开符号属性窗口。

符号属性窗口在一个表格中显示一个符号的所有字段。新的字段可以被添加，现有的字段可以被删除、编辑、重新排序、移动或调整大小。

每个字段的名称和值可以是可见的或隐藏的，并且有几个格式化选项：水平和垂直对齐、方向、位置、字体、文本颜色、文本大小和黑体/大写强调。字段的自动放置也可以在每个字段的基础上启用。对于正常显示的符号，显示的位置总是被指示的（没有旋转或镜像），并且是相对于符号的锚点而言的。

The Update Symbol from Library…​ button is used to update the schematic’s copy of the symbol to match the copy in the library. The Change Symbol…​ button is used to swap the current symbol to a different symbol in the library. These functions are described later.

编辑符号…​ 打开符号编辑器，编辑原理图中的符号副本。注意，库中的原始符号将不会被修改。编辑库中的符号…​ 按钮可以打开符号编辑器来编辑库中的原始符号。在这种情况下，原理图中的符号将不会被修改，直到用户点击 更新库中的符号…​ 按钮。

符号有几个属性，它们会影响 KiCad 其他部分对符号的处理方式。

从模拟中排除 防止该符号被包括在 SPICE 模拟中。

从 BOM 中排除 防止该元件被包括在 《BOM 导出，BOM 导出》中。

从电路板中排除 意味着该符号仅用于原理图，相应的封装不会被添加到 PCB 上。

不使用 意味着该元件不应该被连接到 PCB 上，虽然相应的封装仍然应该被添加到电路板上。如下图所示，DNP 符号在原理图中显示为不饱和状态，上面有一个红色的 "X"。

When a symbol is added to the schematic, KiCad embeds a copy of the library symbol in the schematic so that the schematic is independent of the system libraries. Symbols that have been added to the schematic are not automatically updated when the library changes. Library symbol changes are manually synced to the schematic so that the schematic does not change unexpectedly.

To update symbols in the schematic to match the corresponding symbol, use Tools → Update Symbols from Library, or right click a symbol and select Update Symbol from Library. You can also access the tool from the symbol properties dialog.

The top of the dialog has options to choose which symbols will be updated. You can update all symbols in the dialog, update only the selected symbols, or update only the symbols that match a specific reference designator, value, or library identifier. The reference designator and value fields support wildcards: * matches any number of any characters, including none, and ? matches any single character.

The middle of the dialog has options to control what parts of the symbol will be updated. You can select specific fields to update or not update, which properties of the fields to update (text, visibility, size and style, and position), and how to handle fields that are missing or empty in the library symbol. You can also choose whether to update symbol attributes, such as do not populate and exclude from simulation / bill of materials / board.

The bottom of the dialog displays messages describing the update actions that have been performed.

To change an existing symbol to a different symbol, use Edit → Change Symbols…​, or right click an existing symbol and select Change Symbol…​. This dialog is also accessible from the symbol properties dialog.

The options for the Change Symbols dialog are very similar to the Update Symbols from Library dialog.

Another way to swap existing symbols for new ones is to use Tools → Edit Symbol Library Links…​. This dialog contains a table of every symbol in the design, grouped by current library symbol. By choosing a new symbol in the New Library Reference column, you can make all instances of the existing symbol instead point to the new symbol. If the Update symbol fields from new library option is used, the contents of the existing symbols' fields will be updated to match the new symbols' fields.

The Map Orphans button attempts to automatically remap orphaned symbols to symbols with the same name in an active library. For example, if there is a symbol with the current library reference mylib:symbol123, but the mylib library cannot be found, the Map Orphans button will attempt to find a symbol named symbol123 in any of the libraries that are present. This button is only enabled if orphaned symbols are present in the schematic (see the legacy schematics section).

This dialog is primarily useful for managing symbols that appear in multiple libraries, when you want to switch from one library to another. For example, if a schematic uses symbols that are in both a global library and a project-specific library, the Symbol Library References dialog could be used to switch between using the global symbols or the equivalent project-specific symbols. It does not have features for fine-grained control of how fields are updated; for that, use the Change Symbols dialog.

符号字段表允许你在电子表格界面中查看和修改所有符号的字段值。你可以用 按钮打开符号字段表。

单元格可以用方向键导航，或者用 Tab / Shift+Tab 向右/向左移动，Enter / Shift+Enter 向下/向上移动。

通过点击和拖动可以选择一个单元格范围。选定的整个单元格范围将被复制（Ctrl+C）或粘贴到（Ctrl+V）复制或粘贴操作上。从表中复制单元格的范围对于创建 BOM 非常有用。下面将介绍复制和粘贴单元格的更多细节。

任何符号字段都可以通过左边的 显示 复选框来显示或隐藏，或者通过右键点击表格的标题。新的符号字段可以用 添加字段…​ 按钮添加。

Similar symbols can optionally be grouped by any symbol field using the Group By checkboxes. Grouped symbols are shown in a single row in the table. The grouped row can be expanded to show the individual symbols by clicking the arrow at the left of the row. The Group Symbols checkbox enables or disables symbol grouping, and the button recalculates groupings.

Symbols can be filtered using the Filter textbox at the top. The filter supports wildcards: * matches any number of any characters, including none, and ? matches any single character.

你可以使用 导出为 CSV…​ 按钮，将符号字段保存到外部文件。这可以作为一个简单的 BOM 生成工具，尽管 《BOM 导出，BOM 工具》提供了对生成的输出的更好控制。

启用自动批注后，符号被添加到原理图中时将被自动批注。你可以在 偏好设置 中 原理图编辑器 → 批注选项 窗格中选中 自动批注符号 复选框来启用自动批注。自动批注也可以通过左侧工具栏的 按钮进行切换。

当同时添加多个符号时，它们会根据 顺序 设置进行批注，按 X 或 Y 位置排序。

编号 选项为新的位号设置起始编号。 这可以是最低的可用数字，也可以是基于原理图编号的数字。

关于注解选项的更多信息，请参见《批注工具，批注工具》的文档。

批注工具会自动为原理图中的符号指定位号。要启动批注工具，请点击顶部工具栏上的 按钮。

该工具提供了几个选项来控制符号的批注方式。

范围： 选择批注是否适用于整个原理图、仅适用于当前原理图或仅适用于选定的符号。如果选择了 递归到子原理图 的选项，所选范围的子原理图中的符号将被重新批注；否则子原理图中的符号将不会被重新批注。例如，如果 递归到子原理图 和 仅选择，任何选定的子原理图中的符号将被重新批注。

选项： 选择批注是否应适用于所有符号和重置 现有的位号，或仅适用于未批注的符号。

顺序： 选择编号的方向。如果符号按 X 位置排序，原理图页面左侧的所有符号将比页面右侧的符号编号低。如果符号按 Y 位置排序，则原理图顶部的所有符号的编号将低于原理图底部的符号的编号。

编号： 选择编号位号的起点。每一个位号都会选择在起点之上的最低的未使用的数字。起始点可以是一个任意的数字（通常是 0），也可以是纸张编号乘以 100 或 1000，这样每个零件的位号就与它所在的原理图页相对应。

清除批注 按钮可以清除所选范围内的所有位号。

批注信息可以用底部的复选框进行过滤，或用 保存…​ 按钮保存到报告中。

导线用于在两点之间直接建立电气连接。 要建立连接，必须将一段导线的末端与另一段导线或一个引脚相连。只有导线的末端才能建立连接；如果一根导线穿过另一根导线的中间，就不会建立连接。

未连接的导线端有一个小方块，表示连接点。 当连接到导线端时，这个方块就会消失。未连接的引脚有一个圆圈，当进行连接时也会消失。

标签是用来给导线和引脚分配网络名称的。具有相同网络名称的导线被认为是连接在一起的，所以标签可以用来进行连接，而不需要直接画线连接。

一个网络只能有一个名称。如果有两个不同的标签放在同一个网络上，将产生一个 ERC 违规。 在网表中只使用其中一个网络名称。最终的网络名称是根据下面描述的《网络名称分配规则》决定的。

有三种类型的标签，每种都有不同的连接范围。

总线是一种在原理图中分组相关信号的方法，以简化复杂的设计。 总线可以像导线一样用总线工具画出来 ，并像信号线一样用标签命名。

在下面的原理图中，许多引脚都连接到总线上，也就是中间的蓝色粗线。

当一个符号的电源引脚是可见的，它们必须被连接，就像其他信号一样。然而，诸如门和触发器等符号有时会画出隐含的电源输入引脚，这些引脚是隐性连接的。

KiCad 会自动将类型为 "电源输入" 的隐形引脚连接到与该引脚同名的全局网络。例如，如果一个符号有一个名为 VCC 的隐藏电源输入引脚，这个引脚将被全局连接到所有原理图上的 VCC 网络。

可能有必要将不同名称的电源网络连接起来（例如，TTL 元件中的 GND 和 MOS 元件中的 VSS）。为了达到这个目的，为每个网络添加一个 《电源符号,电源符号》，并用一根导线连接它们。

如果使用隐藏的电源引脚，不建议使用本地标签进行电源连接，因为它们不会连接到其他片上的隐藏电源引脚。

电源符号是传统上用来表示与电源网连接的符号，如`VCC` 或 GND。除了作为连接网络是电源布线的视觉指示外，电源符号还可以进行全局连接：两个具有相同引脚名称的电源符号在原理图中的任何地方都可以相互连接，而不用考虑原理图。

Power symbols are virtual: they do not represent a physical component on the PCB.

在下图中，电源符号用于将电容器的正负极分别连接到 VCC 和 GND 网路上。

In the KiCad standard library, power symbols are found in the power library, but power symbols can be created in any library.

To create a custom power symbol, make a new symbol with a power input pin that is set to be invisible. Name the pin according to the desired power net. In addition, set the "Define as power symbol" symbol property. As described in the hidden power pins section, invisible power input pins make global connections based on the hidden power pin’s name. The process of creating a power symbol is described in more detail in the Symbol Editor section.

原理图中的每个网都被分配了一个名称，无论这个名称是由用户指定还是由 KiCad 自动生成。

当多个标签附加到同一个网时，最终的网络名将按以下顺序确定，从最高优先级到最低：

如果一个网络有多个同一类型的标签，则按字母顺序排序，使用第一个。

如果一个网络穿过《层次原理图,层次》的多张原理图，它将从它有层次标签或局部标签的层次结构的最高层取名。通常，局部标签优先于层次标签。

如果上面的标签类型都没有附加到网络中，那么网络的名称将根据连接的符号引脚自动生成。

在上面的截图中可以看到两个 PWR_FLAG 符号。它们向 ERC 表明，两个电源网络 VCC 和 GND 实际上连接到一个电源上，因为没有明确的电源，如连接到任何一个网络的电压调节器输出。

如果没有这两个标志，ERC 工具会诊断出：错误：输入电源引脚没有被任何输出电源引脚驱动。

PWR_FLAG 符号可以在 power 符号库中找到。通过将任何电源输出引脚连接到网络上，可以达到同样的效果。

No-connection flags () are used to indicate that a pin is intentionally unconnected. These flags prevent "unconnected pin" ERC warnings for pins that are intentionally unconnected.

Note that no-connection flags are distinct from the "unconnected" symbol pin type, although they both prevent "unconnected pin" ERC warnings on the pin in question.

网络类在 原理图设置 对话框的 网络类 面板中管理。

顶部的窗格列出了设计中存在的网络类。默认 网络类总是存在的，你可以通过 按钮添加额外的网络类，或者通过 按钮删除选定的网络类。

每个网络类可以有独特的图形属性，决定该网络类的导线如何在原理图中显示。导线和母线的厚度、颜色和线条风格（实线、虚线、点线等）都可以调整。将颜色设置为透明将使用主题的默认导线/总线颜色，该颜色可在《偏好设置颜色，偏好设置》中配置。

You can also set board design rules for each netclass, although the DRC fields are hidden by default. Right click the header row to show or hide additional columns. For more information about setting netclass design rules, see the PCB editor documentation.

The bottom pane lists pattern-based netclass assignments. Each row has a net name pattern and a netclass; nets with names that match the pattern are assigned to the specified netclass. If a net matches multiple patterns, the first match is used. Pattern-based netclass assignments are dynamic: when a new net is added that matches an existing pattern, it will be assigned to the associated netclass automatically. Net patterns can use both wildcards (* to match any number of any characters, including none, and ? to match any character) and regular expressions. The nets that match the selected pattern are displayed to the right of the pattern list.

For example, the net* pattern matches nets named net, net1, network, and any other net name beginning with net. Because * has a slightly different meaning in a regular expression (* matches zero or more of the preceding character), the net* pattern would also match a net named ne.

使用 按钮来添加网络类分配模式，或 按钮来删除模式。

您可以从原理图画布上直接创建网络类图案，而不是在原理图设置对话框中添加网络类图案。右击一个网络，选择分配网络类…​，就会出现添加网络类分配对话框。网络类模式会预先填上所选网络的名称，但如果需要，也可以改变模式。所有符合该模式的网都显示在对话框中。

作为基于模式的网络类分配的替代方法，网络类可以用 网络类指令 或 标签 以图形方式分配给原理图中的网络。网络类必须在《原理图设置网络类，原理图设置》中创建，然后才能以图形方式分配。

在下面的图片中，一个网络类指令被用来给 50R 网络类分配信号。

网络类指令是通过右边工具栏的 按钮添加的。它们的行为类似于《标签，标签》，除了它们不能被用来命名一个网络。根据指令的 网络类 字段的值，附加的网络被分配了一个网络类。`网络类`字段提供了一个设计中所有网络类的下拉列表。

如果一个指令被附加到一个总线上，总线上的所有成员都被分配到指定的网络类。

除了相关的网络类，你还可以在指令的属性中编辑指令的形状（点、圆、钻石或矩形）、方向、引脚长度 和 颜色。

《标签网络类，网络标签也可以用来给网络分配网络类》，方法是在标签中添加一个 网络类 字段。

如果超过一个不同的网络类被图形化地分配给一个网络，《ERC 检查清单，ERC 将报告一个问题》。图形化的网络类分配优先于基于模式的分配：如果一个网络与网络类模式分配相匹配，并且也有一个图形化的网络类分配，那么将使用图形化的网络类分配。

有两种文本可以被添加到原理图中，它们被称为文本（）和文本框（）。两者都是使用右侧工具栏中各自的按钮添加的。

这两种文本项目都支持多行文本和基本的格式化功能，但文本框将文本包起来以适应大纲，并有额外的格式化选项。所有的文本都有可调整的字体、颜色、大小、黑体和斜体强调，左右对齐，以及垂直和水平方向。文本框还支持水平居中，垂直对齐选项，以及彩色边框和填充。

图形矩形（）、圆形（）、弧形（）和直线（）都可以使用右侧工具栏中各自的按钮添加。

线条的宽度、颜色和样式（实线、虚线或点线）可以在每个形状（E）的属性对话框中进行配置。矩形、圆形和弧线也可以设置填充颜色并去除其轮廓。

Setting a shape’s line width to 0 uses the schematic default line width, which is configurable in Schematic Setup. Spacing for line dashes is also configurable there. Removing a line or fill color uses the color theme’s graphics color, which is configurable in Preferences.

像《画和编辑导线，导线》一样，图形线服从线的绘制模式设置（90 度，45 度，或自由角度），你可以用左边工具栏上的切换按钮来设置（，，和 ，分别）。 Shift+Space 循环浏览这些模式。

As with PCB tracks, the / hotkey switches line posture.

位图图像可以通过 按钮添加到原理图中。原理图中的图像可以被移动和缩放。属性对话框允许设置位置和比例，以及将图像转换为灰度。

文本和图形的属性可以通过 编辑文本和图形属性 对话框（工具 → 编辑文本和图形属性…​）进行批量编辑。该工具还可以修改导线和总线的视觉属性。

标题块是用页面设置工具（）编辑的。

Each field in the title block can be edited, as well as the paper size and orientation. If the Export to other sheets option is checked for a field, that field will be updated in the title block of all sheets, rather than only the current sheet.

You can set the date to today’s or any other date by pressing the left arrow button next to Issue Date. Note that the date in the schematic will not be automatically updated.

也可以选择一个原理图模板文件。

原理图编号（X/Y纸）会自动更新，但原理图页码也可以用 编辑 → 编辑原理图页码…​ 手动设置。

The formatting panel contains settings for the appearance of symbols, text, labels, graphics, and wires.

Symbol unit notation sets how each unit of a multi-unit symbol is referred to in its reference designator. By default, a different letter for each unit is appended to the reference designator with no separator, for example U1B for the second unit of symbol U1, but this can be changed. Numbers can be used instead of letters, and various separators can be used between the symbol designator and the unit identifier (., -, _, or none).

Default text size sets the default text height used by the text, text box, and label tools. Label offset ratio controls the vertical spacing between a local label’s text and the attached wire, relative to the label’s text size. This also affects the spacing between symbol pins and their pin number. Global label margin defines the size of the box around a global label, relative to the global label’s text size. Increasing the margin may be useful to avoid overlapping text with overbars (~{}) or letters with descenders, but this may cause closely packed global labels to overlap with each other.

Default line width sets the default line width for symbol graphics, if the symbol does not override the default line width. Pin symbol size scales symbol pin graphic style annotations, such as the bubble on an inverted pin.

Junction dot size sets the schematic’s default wire junction dot size. The default size can be overridden by editing an individual junction dot’s properties.

Show inter-sheet references enables or disables the display of inter-sheet references, which are a list of page numbers next to a global labels that link to other places in the schematic where the same global label appears. Show own page reference controls whether the current page is included in the list of page numbers. Standard and abbreviated determine whether to display the complete list of page numbers or only the first and last page numbers. The prefix and suffix fields add optional characters before and after the list of page numbers. In the image of an inter-sheet reference below, a prefix and suffix of [ and ], respectively, have been added.

Dashed line appearance is controlled in the Formatting section. Dash length controls the length of dashes, while Gap length controls the spacing between dashes and dots. The dash and gap lengths are relative to the line width: a gap length of 2 means twice the width of the line.

Field name templates are empty symbol fields that are automatically added to all symbols in the schematic. These can be useful when every symbol in the schematic needs additional fields beyond the fields that are defined in the library symbols, for example a field for the manufacturer’s part number.

Template fields can be set as visible or invisible, and can also be set as URL fields.

Field name templates that are defined in schematic setup apply only to the current project. Field name templates can also be defined in Preferences, which apply to all projects edited on your computer.

The Violation Severity panel lets you configure what types of ERC messages should be reported as Errors, Warnings, or ignored.

The Pin Conflicts Map allows you to configure connectivity rules to define electrical conditions for errors and warnings based on what types of pins are connected to each other. For example, by default an error is produced when an output pin is connected to another output pin.

These panels are explained in more detail in the ERC section.

The Net Classes panel allows you to manage netclasses for the project and assign nets to netclasses with patterns. Managing netclasses in this panel is equivalent to managing them in the Board Setup dialog. Nets can also be assigned to netclasses in the schematic using graphical assignments with net class directives or net labels.

Pattern-based netclass assigment is explained in more detail in the net classes section.

The Bus Alias Definitions panel allows you to create bus aliases, which are names for groups of signals in a bus. For more information about bus aliases, see the bus alias documentation.

Text replacement variables can be created in the Text Variables section. These variables allow you to substitute the variable name for any text string. This substitution happens anywhere the variable name is used inside the variable replacement syntax of ${VARIABLENAME}.

For example, you could create a variable named VERSION and set the text substitution to 1.0. Now, in any text object on the PCB, you can enter ${VERSION} and KiCad will substitute 1.0. If you change the substitution to 2.0, every text object that includes ${VERSION} will be updated automatically. You can also mix regular text and variables. For example, you can create a text object with the text Version: ${VERSION} which will be substituted as Version: 1.0.

Text variables can also be created in Board Setup. Text variables are project-wide; variables created in the schematic editor are also available in the board editor, and vice versa.

There are also a number of built-in system text variables.

Modern versions of KiCad can open schematics created in versions prior to KiCad 6.0, but the cache library file (<projectname>-cache.lib) must be present to load the schematic correctly.

Since version 6.0, KiCad stores all symbols used in a project in the schematic. This means that you can open a schematic made in KiCad 6.0 or later on any computer, even if the libraries used in the project are not installed or have changed. Modern KiCad schematic files use the .kicad_sch extension.

Prior to version 6.0, KiCad did not store symbols in the schematic. Instead, KiCad stored references to the symbols and their libraries. It also stored a copy of every symbol used by the project in a separate cache library file (<projectname>-cache.lib). As long as the cache library was included with the project, the project could be distributed without the system library files, because KiCad could load any needed symbols from the cache library as a fallback if the libraries referenced in the schematic were missing. Legacy KiCad schematic files use the .sch extension.

When you open a legacy schematic, KiCad will look in the cache library to find all of the symbols used in the schematic in the cache library. When you save the legacy schematic, KiCad will save it as a new file in the modern schematic format (.kicad_sch), with the necessary symbols embedded in the schematic itself. The original legacy schematic and the cache library will remain, unmodified, but they are no longer necessary once the schematic has been saved in the modern format.

When you open a legacy schematic, KiCad may display the Project Rescue Helper dialog. This means that one or more symbols in the cache library do not match the corresponding symbol in the external library. The dialog helps you "rescue" symbols from the cache library into your schematic, if desired. You can also open the rescue dialog at any time using Tools → Rescue Symbols…​. The cache library file must be present in order to use the rescue tool.

The rescue dialog lists all symbols that don’t match between the cache library and the external symbol library. The discrepancy can be because:

For each symbol in the list, selecting the symbol displays the reference designator and value for each instance of the symbol, and shows a visual preview of the symbol. If a corresponding symbol exists in the system symbol library, the dialog shows both copies of the symbol for comparison. If the symbol only exists in the cache library, the dialog only shows the cached symbol.

In this example, the project originally used a diode with the cathode facing left, but the library now contains one with the cathode facing right. This change would break the design, so it would be important to use the cached symbol as the original designer intended.

Pressing Rescue Symbols here will cause the selected symbols from the cache library to be saved into a special rescue library (<projectname>-rescue.kicad_sym). The corresponding symbols in the schematic will be updated to use the newly rescued symbols. Any unselected symbols will not be rescued, but their symbol linkage can be updated in the schematic later.

Alternatively, pressing Skip Symbol Rescue will exit the dialog without rescuing any symbols. KiCad will use the versions of the symbols found in the external libraries. You can run the rescue function again with Tools → Rescue Symbols…​, or manually edit symbol linkage in the symbol’s properties.

If you would prefer not to see this dialog, you can press Never Show Again. This has the same effect as pressing Skip Symbol Rescue for the current schematic and all future schematics.

If a symbol in a legacy schematic cannot be found in either the cache library or the external library, KiCad cannot rescue that symbol. A placeholder symbol is inserted into the schematic in its place, as shown below.

You can attempt to remap these orphaned symbols using the Change Symbols or Edit Symbol Library Links dialogs, but either option may require manual corrections to the schematic. These tools are explained in more detail in the Updating and exchanging symbols section.

Modern versions of KiCad can open schematics created in versions prior to KiCad 5.0, but you will need to go through a symbol remapping process to open the schematic without losing symbol information.

Since version 5.0, KiCad schematics refer to specific symbols using both the symbol and library name. Even if multiple libraries each contain a symbol with the same name, the designer’s intended symbol is unambiguously specified.

Prior to version 5.0, KiCad schematics stored only the symbol name, not the library name. Symbols in the schematic were indirectly mapped back to the original library by searching through the project’s library list for a matching symbol. When you open a pre-5.0 schematic, KiCad will attempt to automatically "remap" the symbols so that each bare symbol name is replaced with a fully-specified symbol library and symbol name pair. The original schematics will be backed up in a rescue-backup folder.

You can skip the automatic remapping, but you will need to remap the symbols yourself using the Change Symbols dialog. You can also re-run the Remap Symbols tool using Tools → Remap Legacy Library Symbols…​.

原理图之间的电气连接是通过《标签，标签》进行的。在 KiCad 中，有几种标签，每种都有不同的连接范围。

在子原理图内放置分层标签后，可以在父原理图内的子原理图符号上添加匹配的 分层引脚。然后，你可以用导线、标签和总线与分层引脚进行连接。子原理图符号中的分层引脚与子原理图本身的匹配分层标签相连。

对于子原理图中的每一个分层标签，通过点击右侧工具栏中的 按钮，然后点击原理图符号，将相应的分层标签导入原理图符号中。第一个不匹配的分层标签的原理图页码将附在光标上，它可以放在原理图符号边界的任何地方。再次点击该工具将继续导入更多的原理图页码，直到没有更多的分层标签需要从子原理图中导入。原理图页码也可以通过在原理图符号的右键菜单中选择 导入原理图页码 来导入。

你可以在原理图页码属性对话框中编辑原理图页码的属性。 通过双击原理图页码，选择原理图页码并使用 E 热键，或者右击原理图页码并选择 属性…​ 来打开这个对话框。

原理图页码的 名称 可以在文本框中编辑，也可以从子原理图的分级标签的下拉列表中选择。原理图页码的名称必须与子原理图中相应的层次标签相匹配，所以如果页码的名称被改变，标签也必须改变。

Shape changes the shape of the sheet pin, and has no electrical effect. It can be set to Input, Output, Bidirectional, Tri-state, or Passive. The pin’s font, text size, color, and emphasis (bold or italic) can also be changed.

一个简单的层次结构的例子是 KiCad 包含的 video 演示工程。根原理图包含七个独特的子原理图，每个子原理图都有分层的标签和原理图页码，将原理图与根原理图相互连接。下面是其中两个子原理图的符号。

复杂的层次结构 演示工程是一个复杂层次结构的例子。 根原理图包含两个子原理图符号，它们都指向同一个原理图文件（ampli_ht.kicad_sch）。这使得设计中包含了同一个放大器电路的两个副本。尽管这两个原理图符号指向同一个文件名，但原理图的名称是唯一的（ampli_ht_vertical 和 ampli_ht_horizontal）。在每个子原理图内，除了位号外，其他的电路都是相同的，而位号也是唯一的。

这个工程不包含原理图的引脚连接。根原理图和子原理图之间的唯一连接是用《电源符号，电源符号》进行的全局电源连接。然而，如果适合设计，复杂层次结构中的原理图可以包括原理图页码的连接。

flat_hierarchy 演示工程是一个扁平化层次结构的例子。根原理图包含两个唯一的子原理图符号，没有分层的原理图页码。在这个工程中，根原理图除了容纳子原理图外没有任何作用，子原理图只是作为原理图中的附加页使用。

在上面的截图中，有三个错误。

选择一个 ERC 标记会在窗口底部的信息窗格中显示违规描述。

在电源引脚上出现 "输入电源引脚未被任何输出电源引脚驱动" 的错误是很常见的，如下面的例子所示，即使电源引脚似乎正确地连接到电源导线。这种情况发生在通过连接器或其他元件提供电源的设计中，这些连接器或元件没有被标记为电源输出。在这些情况下，ERC 不会检测到任何连接到网络的输出电源引脚，而会判断输入电源引脚没有被电源驱动。

为了避免这个警告，请在这样的电源网络上将网络连接到 PWR_FLAG 符号上，如下例所示。PWR_FLAG 符号可以在 power 符号库中找到。或者，将任何电源输出引脚连接到该网；PWR_FLAG 只是一个具有单一电源输出引脚的符号。

接地网络通常也需要一个 PWR_FLAG，因为电压调节器的输出被声明为电源输出，但其接地引脚通常被标记为电源输入。因此，除非使用 PWR_FLAG 符号，否则地线可能看起来没有与电源相连。

关于电源引脚和电源标志的更多信息，请参见《电源标记，PWR_FLAG 文档》。

《原理图设置，原理图设置》中的 违规严重性 面板让你配置哪些类型的 ERC 信息应被报告为错误、警告或忽略。

《原理图设置，原理图设置》中的 引脚冲突图 面板允许你配置连接规则，根据哪些类型的引脚相互连接来定义错误和警告的电气条件。例如，默认情况下，当一个输出引脚与另一个输出引脚连接时，会产生错误。

可以通过点击矩阵中所需要的方块来改变规则，使其在各种选择中循环：允许、警告、错误。

The table below lists the electrical rules that KiCad checks and the default violation severity for each check. All severities are configurable.

可以通过点击 ERC 对话框中的 保存…​ 按钮来生成和保存 ERC 报告文件。ERC 报告文件的扩展名为 .rpt。下面给出一个 ERC 报告文件的例子。

与其单独编辑每个符号的属性，符号字段表可以用来在一个地方查看和编辑设计中所有符号的属性。这包括通过编辑每个符号的 封装 字段来分配封装。

符号字段表可以通过 工具 → 编辑符号字段…​，或者通过顶部工具栏上的 按钮进入。

`封装`字段在这里的作用与符号属性窗口的作用相同：可以直接编辑，也可以用封装库浏览器直观地选择封装。

关于符号字段表的更多信息，请参见《符号字段表，关于编辑符号属性》一节。

下面的图片显示了封装分配工具的主窗口。

顶部的工具条包含以下命令：

下表列出了封装分配工具的键盘命令：

要手动将一个封装与一个元件联系起来，首先在元件（中间）窗格中选择一个元件。然后在封装（右）窗格中选择一个封装，双击所需封装的名称。封装将被分配给选定的元件，而下一个没有分配封装的元件将被自动选择。

当所有的元件都有封装时，点击 OK 按钮来保存分配并退出工具。或者，点击 取消，放弃更新的赋值，或者点击 应用，保存原理图并继续，保存新的赋值，而不退出工具。

封装分配工具允许你在一个外部文件中存储封装分配，并在以后加载这些分配，甚至在不同的工程中。这使你能够自动将符号与适当的封装联系起来。

外部文件被称为等效文件，它存储了一个符号值到相应的封装的映射。等效文件通常使用 .equ 文件扩展名。等效文件是具有简单语法的纯文本文件，必须由用户用文本编辑器来创建。语法描述如下。

你可以在 "封装分配工具" 中点击 偏好设置 → 管理 "封装关联文件" 来选择使用哪些等值文件。

相关的环境变量显示在窗口的底部。当 相对 路径选项被选中时，这些环境变量将被自动用于使所选等效文件的路径与项目或封装库相对。

一旦所需的等效文件以正确的顺序载入，就可以通过点击封装分配工具顶部工具栏上的 按钮来进行自动封装分配。

所有在加载的等效文件中找到数值的符号都将自动分配其封装。然而，已经分配了封装的符号将不会被更新。

封装分配工具包含一个封装查看器。点击顶部工具栏上的 按钮可以启动封装查看器，并显示选定的封装。

顶部的工具条包含以下命令：

左边的工具条包含以下命令：

该工具有几个选项可以控制其行为。

该工具有几个选项可以控制其行为。

通过从 PCB 编辑器中导出 CMP 文件（文件 → 导出 → 封装关联（.cmp）文件…​）并在原理图编辑器中导入（文件 → 导入 → 封装分配…​），也可以将选择变化从 PCB 同步到原理图。

打印图样： 在打印的原理图中包括图样的边框和标题块。

输出模式： 以彩色或黑白方式打印原理图。

打印背景色： 包括打印的原理图中的背景色。包括在打印的原理图中的背景颜色。这个选项只有在 只以黑白打印 被禁用时才会启用。禁用此选项。

使用不同的颜色主题进行打印： 选择不同的颜色方案进行打印，与在原理图编辑器中选择的显示方案不同。与在 "原理图编辑器" 中显示时选择的颜色方案不同，用于打印。

页面设置…​： 打开一个页面设置对话框，用于设置纸张大小和方向。

预览： 打开一个打印预览对话框。

关闭： 关闭对话框，不打印。

打印： 打开系统打印对话框。

输出目录： 指定保存绘图文件的位置。如果这是一个 相对路径，它是相对于项目目录创建的。

输出格式： 选择要绘制的格式。有些格式有不同的选项。

页面大小： 设置用于绘制输出的页面大小。这可以被设置为匹配原理图的尺寸或其他页面尺寸。

绘制图纸： 在打印的原理图中包括图样表边框和标题块。

输出模式： 设置输出为彩色或黑白。不是所有的输出格式都支持彩色。

绘图背景色： 包括绘图输出中的原理图背景色。绘制的输出中。如果输出格式不支持彩色，或者输出模式是黑白的，那么背景色将不会被绘制出来。不支持彩色，或输出模式是黑白的，则不会绘制背景色。

颜色主题： 选择用于绘制输出的颜色主题。

默认线宽： 选择没有指定厚度的线的默认宽度。厚度的线的默认宽度（厚度设置为 0 的线）。有设定厚度的线 的线条将以该厚度绘制。

位置和单位： 设置绘图仪原点和单位。这个选项只 适用于 HPGL 输出。

笔宽： 设置绘图仪的笔宽。这个选项只适用于 HPGL 输出。

绘制后打开文件： 在绘制完成后自动打开绘制的输出文件。

绘图的 PDF 有几个互动功能。

默认情况下，BOM 工具呈现三个输出脚本选项。

额外的生成器脚本与 KiCad 一起安装，但默认情况下不会在生成器脚本列表中填入。这些脚本的位置取决于操作系统，并可能根据安装位置而有所不同。

通过点击 按钮，可以在 BOM 生成器脚本列表中添加其他脚本。点击 按钮，可以删除脚本。 按钮在文本编辑器中打开所选的脚本。

关于创建和使用自定义 BOM 生成器的更多信息，请参见 《自定义网表和 BOM 格式， 高级文档》。

KiCad 提供了几种额外的方法来生成 BOM，尽管推荐使用 BOM 工具。

网表是通过导出网表对话框（文件 → 导出 → 网表…​）导出的。

KiCad 支持以多种格式导出网表。KiCad、OrcadPCB2、CADSTAR、Spice 和 Spice Model。每种格式都可以通过选择窗口顶部的相应标签来选择。一些网表格式有额外的选项。

点击 导出网表 按钮，会提示输入网表文件名并保存网表。

其他网表格式的自定义生成器可以通过点击 添加生成器…​ 按钮添加。自定义生成器是由 KiCad 调用的外部工具，例如 Python 脚本或 XSLT 样式表。关于自定义网表生成器的更多信息，请参见《自定义网表和 BOM 格式，添加自定义网表生成器》部分。

下面是 KiCad 模拟演示中的 sallen_key 工程的原理图。

该原理图的 KiCad 格式网表如下：

在 Spice 格式中，网表如下：

第一次运行 KiCad 原理图编辑器时，如果在 KiCad 配置文件夹中没有找到全局符号表文件 sym-lib-table，KiCad 将引导用户设置一个新的符号库表。这个过程将在《初始配置》中描述。

符号库只有在它们被添加到全局或工程专用的符号库表中时才能使用。

通过点击 按钮并选择一个库或点击 按钮并输入库文件的路径来添加一个库。选定的库将被添加到当前打开的库表中（全局或特定工程）。可以通过选择所需的库条目并点击 按钮来删除库。

这个 和 按钮在库表中上下移动所选库。这并不影响符号库浏览器、符号编辑器或添加符号工具中库的显示顺序。

通过取消第一列中的 活动 复选框，可以使库不活动。不活动的库仍然在库表中，但不会出现在任何库的浏览器中，也不会从磁盘加载，这可以减少加载时间。

通过点击范围内的第一个库，然后 Shift - 点击范围内的最后一个库，就可以选择一个库的范围。

每个库必须有一个独特的昵称：在同一个表中不允许有重复的库昵称。然而，昵称可以在全局和工程库表中重复。工程表中的库比全局表中的同名库更有优先权。

库的昵称不一定要与库的文件名或路径有关。冒号字符（:）不能在库的昵称或符号名称中使用，因为它被用作昵称和符号之间的分隔符。

每个库条目必须有一个有效的路径。路径可以定义为绝对的、相对的，或者通过《环境变量替换,环境变量替换》来定义。

必须选择适当的库格式，以便正确读取库。"KiCad" 格式用于 KiCad 6+ 版库（.kicad_sym 文件），而 "Legacy" 格式用于 KiCad 旧版本的库（.lib 文件）。遗留库是只读的，但可以通过 迁移库 按钮迁移到 KiCad 格式的库（见《迁移库，迁移遗留库》一节）。

有一个可选的描述字段，用于添加库条目的描述。选项字段目前不使用，所以添加选项在加载库时不会有任何影响。

符号库表支持环境变量的替换，这允许你定义包含自定义路径的环境变量来存储你的库。通过在符号库路径中使用 ${ENV_VAR_NAME} 的语法，支持环境变量的替换。

默认情况下，KiCad 定义了几个环境变量，这些变量在 工程管理文档 中描述。环境变量可以在 偏好设置 → 配置路径…​ 对话框中进行配置。

在符号库表中使用环境变量，可以在不破坏符号库表的情况下重新定位库，只要在库的位置改变时更新环境变量即可。

${KIPRJMOD} 是一个特殊的环境变量，总是展开为当前工程目录的绝对路径。${KIPRJMOD} 允许将库存储在工程文件夹中，而不必在工程库表中使用绝对路径。这使得重新定位工程而不破坏其工程库表成为可能。

符号库可以全局定义，也可以专门为当前加载的项目定义。在用户的全局表中定义的符号库总是可用的，并存储在用户的 KiCad 配置文件夹中的 sym-lib-table 文件中。工程专用的符号库表只对当前打开的工程文件有效。

每种方法都有其优点和缺点。在全局表中定义所有的库意味着它们在需要时总是可用的。这样做的缺点是，加载时间会增加。

在工程的基础上定义所有的符号库，意味着你只有工程所需的库，这减少了符号库的加载时间。缺点是你总是要记住添加每个工程所需的每个符号库。

一种使用模式是在全局范围内定义常用的库，并在工程专用的库表中定义工程所需的库。对于如何定义库没有任何限制。

遗留库（.lib 文件）是只读的，但它们可以被迁移到 KiCad 6 版库（.kicad_sym）。6.0.0 以上的 KiCad 版本不能查看或编辑 KiCad 6 版本的库。

通过在符号库表中选择传统库并点击 迁移库 按钮，可以将其转换为 KiCad 6 库。通过 Ctrl - 点击或 shift -点击，可以一次选择和迁移多个库。

库也可以通过在符号编辑器中打开它们并将其保存为一个新的库来一次转换。

当加载一个在符号库表实施之前创建的原理图时，KiCad 会尝试将原理图中的符号库链接重新映射到适当的库表符号。 这个过程的成功与否取决于几个因素：

符号是一个元件的原理图。一个符号由以下部分组成：

符号库是由一个或多个符号组成的。一般来说，这些符号按功能、类型和/或制造商进行逻辑分组。

符号可以从同一库中的另一个符号衍生出来。派生符号共享基础符号的图形形状和引脚定义，但可以覆盖基础符号的属性字段（值、封装、封装筛选器、数据手册、描述等）。派生符号可用于定义与基本部件相似的符号。例如，74LS00、74HC00 和 7437 符号都可以从 7400 符号衍生出来。在以前的 KiCad 版本中，派生符号被称为别名。

KiCad 提供了一个符号编辑工具，允许你创建库，在库之间添加、删除或转移符号，将符号导出到文件，并从文件中导入符号。

一般来说，设计一个符号的流程包括：

符号编辑器的主窗口如下所示。它包括三个用于快速访问常用功能的工具条和一个符号查看/编辑区。 不是所有的命令都可以在工具栏上使用，但所有的命令都可以在菜单中使用。

这个 按钮显示或隐藏可用库的列表，可以选择一个活动库。当一个符号被保存时，它将被放在这个库中。

点击左侧工具栏上的 图标，可以切换库和符号的树状视图。点击一个符号就可以打开该符号。

修改后的符号可以保存在当前库或不同的库中。

要在当前库中保存修改后的符号，请点击 图标。修改的内容将被写入现有的符号中。

要把符号的变化保存为一个新的符号，请点击 文件 → 另存为…​。 符号可以保存在当前库或不同的库中。可以为该符号设置一个新的名称。

要创建一个只包含当前符号的新文件，请点击 文件 → 导出 → 符号…​。这个文件将是一个标准库文件，只包含一个符号。

图形元素创建了一个符号的视觉表现，不包含电气连接信息。图形元素是用以下工具创建的:

主窗口右侧的垂直工具条允许你放置设计一个符号的表现形式所需的所有图形元素。

符号最多可以有两种主体样式（一个标准符号和一个备用符号，通常被称为 "德摩根等同"）和/或每个封装有一个以上的单元（例如逻辑门）。有些符号每个封装可以有一个以上的单元，每个单元有不同的符号和引脚配置。

例如，考虑一个有两个开关的继电器，它可以被设计成有三个不同单元的符号：线圈、开关 1 和开关 2。 设计一个每个封装有多个单元的符号和/或备用的主体样式是非常灵活的。一个引脚或一个主体符号项目可以是所有单元所共有的，也可以是特定单元所特有的，或者它们可以是两个符号表示所共有的，所以是特定的符号表示。

默认情况下，引脚是特定于一个单元和主体样式的。当一个引脚是所有单位或所有主体款式所共有的，它只需要被创建一次。主体样式的图形和文字也是如此，它们可能是每个单元所共有的，但通常是每个主体样式所特有的）。

要向一个符号添加额外的单元，在符号属性对话框中将 单元编号 属性设置为适当的数字。默认情况下，符号单元被命名为 单元 A、单元 B 等，但你可以使用 编辑 → 设置单元显示名称…​ 为当前单元设置一个任意的名称。

要添加一个备用的主体样式，请在符号属性对话框中设置 具有备用的主体样式（德摩根） 属性。

你可以通过点击 按钮来创建和插入一个引脚。可以通过双击引脚来编辑引脚的属性。你也可以删除或移动你已经添加的引脚。必须小心地创建引脚，因为任何错误都会对 PCB 设计产生影响。

所有库中的符号都定义有四个默认字段。每当创建或复制一个符号时，就会创建位号、值、封装分配和数据表链接字段。 只有位号是必需的。

The Footprint field, if used, contains a reference to a footprint for the symbol. The format is LIBNAME:FOOTPRINTNAME, where LIBNAME is the name of the footprint library in the footprint library table (see the Footprint Library Table section in the PCB Editor manual) and FOOTPRINTNAME is the name of the footprint in the library LIBNAME.

在库中定义的符号通常只有这四个默认字段。额外的字段，如供应商、零件编号、单位成本等，可以添加到库中的符号中，但一般是在原理图编辑器中完成，这样额外的字段就可以应用到原理图中的所有符号。

Power symbols are symbols that are used to label a wire as part of a global power net, like VCC or GND. The behavior of power symbols is described in the electrical connections section. Power symbols are handled and created the same way as normal symbols, but there are several additional considerations described below.

将电源符号放在一个专门的库中可能是有用的。KiCad 的符号库将电源符号放在 power 库中，用户可以创建库来存储自己的电源符号。如果在符号的属性中勾选了 定义为电源符号 框，该符号就会出现在原理图编辑器的 添加电源符号 对话框中，以便于访问。

下面是一个 GND 电源符号的例子。

电源符号包括一个标记为不可见的 "电源输入" 类型的引脚。 它们还必须检查 定义为电源符号 的属性。 《隐藏的电源引脚,隐形的电源输入引脚》有一个特殊的属性，即根据引脚名称进行隐性的全局连接。

要创建一个电源符号，请使用以下步骤：

创建一个新的电源符号的一个更简单的方法是使用另一个符号作为起点，《从另一个符号创建一个符号，如前面所述》。

符号编辑器可以检查你的符号中的常见问题。使用顶部工具栏上的 按钮运行符号检查器。

符号检查器检查的是：

Resistor, inductor, and capacitor models can be inferred, which means that KiCad will detect that they are passives and automatically assign an appropriate simulation model. Therefore they do not require any special settings; users only need to set the Value field of the symbol.

KiCad infers simulation models for symbols based on the following criteria:

Inferred models are ideal models. If the simulation requires a non-ideal model, you must explicitly assign a model.

KiCad offers several standard simulation models. They do not require an external model file. The following devices are available:

To add a built-in model to a symbol, open the Simulation Model Editor dialog (Symbol Properties → Simulation Model…​) and select Built-in SPICE model.

Refer to the ngspice documentation for more details about these models.

Device sets the type of device to simulate: a resistor, BJT, voltage source, etc. This value is stored in the symbol’s Sim.Device field.

Type selects the type of model to use for the device. Most devices have several types of models to choose from, which may vary in their degree of accuracy, which characteristics they are optimized for, and what parameters they have available. Refer to the ngspice documentation for details. This value is stored in the symbol’s Sim.Type field.

The parameters tab displays the parameters of the model and lets you edit them. For example, a resistor’s resistance, a voltage source’s waveform, a MOSFET’s width and length, etc. Any parameters that differ from the model’s defaults are stored in the symbol’s Sim.Params field.

The code tab displays the generated SPICE model as it will be written to the SPICE netlist for simulation.

The Save parameter '<parameter name>' in Value field checkbox uses the symbol’s Value field for storing parameters instead of the Sim.Params field. This may make it easier to edit simple models from the schematic, without opening the Simulation Model Editor. This option is only available for ideal passive models (R, L, C) and DC sources. If the field Sim.Params exists in the symbol, it will take priority over the Value field.

KiCad can load SPICE models from external files. The models must be in a standard SPICE format and not encrypted.

To load a model from an external file, open the Simulation Model Editor dialog (Symbol Properties → Simulation Model…​) and select SPICE model from file.

File is the path to the model file to use. The path can be absolute or relative to the project folder. The path can also be relative to the value of SPICE_LIB_DIR if you have defined that path variable. The library filename is saved in the symbol’s Sim.Library field.

Model is the name of the desired model in the model file. If the file contains multiple models, they will all be listed in the dropdown. The selected model is listed in the symbol’s Sim.Name field.

Parameters can be overridden (or additional parameters specified) using the parameters tab. All parameters specified in the selected model or the parameters tab are stored in the symbol’s Sim.Params field.

The code tab displays the generated SPICE model as it will be written to the SPICE netlist for simulation.

IBIS (I/O Buffer Information Specification) files are an alternative to SPICE models for modeling the behavior of input/output buffers on digital parts. In order to load an IBIS file, users should follow the procedure for SPICE library models, but provide a .ibs file.

File is the path to the model file to use. The path can be absolute or relative to the project folder. The path can also be relative to the value of SPICE_LIB_DIR if you have defined that path variable. The library filename is saved in the symbol’s Sim.Library field. If an IBIS model file is loaded, the remaining fields in the dialog will relate to the IBIS model.

Component selects which component from the IBIS file to use, as IBIS files can contain multiple components. The component name is saved in the symbol’s Sim.Name field.

Pin selects which pin in the IBIS model to simulate. The selected pin must be mapped to a symbol pin in the Pin Assignments tab. The chosen pin’s number is saved in the symbol’s Sim.Ibis.Pin field.

Model is the list of models available for the selected pin, for example an input or an output. The chosen model name is saved in the symbol’s Sim.Ibis.Model field.

Type selects what the pin should do in the simulation. A pin can be a passive device that doesn’t drive any value; it can be a DC driver that drives high, low, or high-impedance; or it can be a rectangular wave or PRBS driver. This value is stored in the symbol’s Sim.Type field.

The Parameters tab lets you see and edit the parameters of the model. For each parameter, you can switch between a minimum, typical, or maximum value, as defined in the IBIS file. You can also choose the parameters of the driven waveform, depending on the pin’s chosen type. Any parameters that differ from the defaults are stored in the symbol’s Sim.Params field.

Simulation models may have their pins numbered differently than the corresponding symbol. For example, SPICE models for diodes usually consider pin 1 to be the anode, while schematic symbols are usually drawn with pin 1 as the cathode.

You can use the Simulation Model Editor’s Pin Assignments tab to map the symbol’s pins to the simulation model pins.

The left column displays the name and number of each symbol pin. For each symbol pin, you can select the corresponding pin from the simulation model in the dropdown in the right column.

When you use a subcircuit model, the dialog displays the model’s code under the pin assignments for use as a reference while assigning pins.

To run a simulation, open the SPICE simulator dialog by clicking Inspect → Simulator in the schematics editor window or using the button in the top toolbar.

该对话框分为几个部分：

Workbooks are files that store information about the simulation environment, including simulation setup parameters and the list of displayed signals. They can be used to store the setup for a set of analyses, which can then be reloaded and rerun at a later time.

You can save and load a workbook using File → Save Workbook and File → Open Workbook.

Before running a simulation, you need to select a simulation type and choose the simulation parameters. This can be done using Simulation → Settings…​ or the Sim Command button () and then selecting one of the available analysis types:

Analysis types are further explained in the ngspice documentation.

An alternative way to configure a simulation is to type SPICE directives into text fields on schematics. Any text field directives related to a simulation command are overridden by the settings selected in the dialog. This means that once a simulation has run, the dialog overrides the schematic directives until the simulator is reopened.

Once the simulation command is set, users can start a simulation with Simulation → Start Simulation (Ctrl+R) or the Run/Stop Simulation button ().

It is possible to change passive (R, L, C) values using sliders to graphically adjust them. Whenever the slider is set to a new position, the simulation is run with the new parameters and plots are updated. In order to add a slider for a component, use Simulation → Tune Component Value or the button in the toolbar, and then click on the component to tune.

KiCad’s simulator offers two ways to export results:

要创建一个数据基础库，你必须创建一个配置文件，其中包含 KiCad 连接到你的数据库并从表中获取数据的必要信息。 将下面的模板复制到一个新文件中，并以 kicad_dbl 为扩展名保存。 然后你可以使用配置符号库对话框将此文件添加到你的全局符号库表中。

创建配置文件并将其添加到符号库表中后，您可以使用符号选择器从数据库表中放置元件。 从数据基础库中放置的元件可以使用 "从库中更新符号" 功能进行更新，该功能将更新数据库中被改变的任何字段，以及更新源库中被改变的基本符号。

请注意，数据库表所引用的任何源库也必须存在于符号库表中，这样数据基础库才能发挥作用。 如果你想把一个库只作为数据基础库的符号源，你可以通过清除 "管理符号库" 对话框中的 "可见" 复选框将其从符号选择器中隐藏起来。

新的网表生成器可以通过点击 添加生成器…​ 按钮添加到 导出网表 对话框中。

新的生成器需要一个名称和一个命令。名称显示在标签中，只要点击 导出网表 按钮，就会运行该命令。

当网表生成时，KiCad 会创建一个中间的 XML 文件，其中包含原理图中所有的网表信息。然后运行生成器命令，以将中间网表转换为所需的网表格式。

网表命令必须正确设置，以便网表生成器脚本将中间网表文件作为输入并输出所需的网表文件。确切的网表命令将取决于所使用的生成器脚本。下面描述了《生成器命令行格式，命令格式》。

Python 和 XSLT 是创建自定义网表生成器的常用工具。

KiCad 还使用中间网表文件，通过 《BOM 导出，生成 BOM 工具》生成 BOM。

通过点击 按钮，可以在 BOM 生成器脚本列表中添加其他脚本。点击 按钮，可以删除脚本。 按钮在文本编辑器中打开所选的脚本。

用 Python 和 XSLT 编写的生成器脚本可以包含一个头注释，描述生成器的功能和用法。这个头注释会作为每个生成器的描述显示在 BOM 对话框中。头部注释必须包含字符串 @package。该字符串之后直到注释结束的所有内容都被用作生成器的描述。

当添加新的生成器脚本时，KiCad 会自动填充命令行字段，但根据生成器脚本的情况，可能需要手工调整命令行。KiCad 试图从生成器脚本标题中的示例命令行自动确定输出文件扩展名。

网表或 BOM 导出器的命令行定义了 KiCad 将运行以生成所选输出文件的命令。

对于使用 xsltproc 的网表导出器，例如：

xsltproc -o %O.net /usr/share/kicad/plugins/netlist_form_pads-pcb.asc.xsl %I

对于使用 Python 的 BOM 导出器，一个例子是：

/usr/bin/python3 /usr/share/kicad/plugins/bom_csv_grouped_by_value.py "%I" "%O.csv"

某些字符序列（如`%I` 和 %O）在命令行中具有特殊含义，因为 KiCad 在执行命令之前将它们替换为文件名或路径。

当输出 BOM 文件和网表时，KiCad 会创建一个中间网表文件，然后运行一个单独的工具，将中间网表后期处理成所需的网表或 BOM 格式。

中间网表使用 XML 语法。它包含有关设计的大量数据。根据输出（BOM 或网表），完整中间网表文件的不同子集将包含在最终输出文件中。

中间网表文件的结构详述 《中间网表结构，如下》。

由于从中间网表文件到输出网表或 BOM 的转换是文本到文本的转换，因此可以使用 Python、XSLT 或任何其他能够将 XML 作为输入的工具编写后处理过滤器。

此示例提供了网表文件格式的概念。

下面包括一些使用 XSLT 的网表导出器的例子。

XSLT 本身是一种 XML 语言，非常适用于 XML 转换。http://xmlsoft.org/XSLT/xsltproc.html[xsltproc 程序] 可以用来读取中间的 XML 网表输入文件，应用样式表来转换输入，并将结果保存在输出文件中。使用 xsltproc 需要一个使用 XSLT 惯例的样式表文件。整个转换过程由 KiCad 处理，在它被配置为以特定方式运行 xsltproc 之后。

描述 XSL 变换（XSLT）的文件可在此获得：http://www.w3.org/TR/xslt