管理符号库

符号库包含创建原理图时使用的符号集合。 原理图中的每个符号由一个全名唯一标识，该全名由库昵称和符号名称组成。 一个例子是 “音频：AD1853”。

符号库表

符号库表包含 KiCad 知道的所有库文件的列表。 符号库表由全局符号库表文件和项目特定符号库表文件构成。

加载符号时，Eeschema 使用库昵称（在我们的示例中为 “音频”）来查找符号库表中的库位置。

下图显示了符号库表编辑对话框，可以通过调用 首选项 菜单中的 管理符号库表 条目来打开该对话框。

全局符号库表

全局符号库表包含始终可用的库列表，与当前加载的项目文件无关。 该表保存在用户主文件夹的文件符号列表文件中。 此文件夹的位置取决于所使用的操作系统。

项目特定符号库表

项目特定符号库表包含专门用于当前加载的项目文件的库列表。 项目特定符号库表只能在与项目文件一起加载时进行编辑。 如果未加载项目文件或当前项目路径中没有符号库表文件，则会创建一个空表，可以对其进行编辑，然后将其与项目文件一起保存。

初始配置

第一次运行 Eeschema 并且在用户的主文件夹中找不到全局符号表文件 sym-lib-table 时，Eeschema 将尝试复制存储在系统的 KiCad 模板文件夹中的默认符号表文件 sym-lib-table 到用户主文件夹中的文件 sym-lib-table。 如果找不到默认模板 sym-lib-table 文件，则会出现一个对话框，提示输入 sym-lib-table 文件的备用位置。 如果未找到 sym-lib-table 或解除对话框，则将在用户的主文件夹中创建空符号库表。 如果发生这种情况，用户可以手动复制 sym-lib-table 或手动配置表。

添加表项

为了使用符号库, 必须首先将其添加到全局表或项目特定表中。特定于项目的表仅适用于打开项目文件的情况。

每个图书馆条目必须有一个独特的昵称。

这不必以任何方式与实际库文件名或路径相关。 冒号 “:” 和 “/” 字符不能在库昵称中的任何位置使用。 每个库条目必须具有有效的路径和/或文件名，具体取决于库的类型。 路径可以定义为绝对，相对或环境变量替换（参见下面的部分）。

必须选择适当的插件类型才能正确读取库。 KiCad 目前仅支持旧版符号库文件插件。

还有一个描述字段用于添加库条目的描述。 此时不使用选项字段，因此在加载库时添加选项将不起作用。

• 请注意，您不能在同一个表中包含重复的库昵称。 但是，您可以在全局和项目特定的符号库表中包含重复的库昵称。

• 当出现重复的昵称时，项目特定的表条目将优先于全局表条目。

• 在项目特定表中定义条目时，包含这些条目的 sym-lib-table 文件将写入当前打开的项目文件的文件夹中。

环境变量替代

符号库表的最强大功能之一是环境变量替换。 这允许定义符号库存储在环境变量中的自定义路径。 使用库路径中的语法 $\{ENV_VAR_NAME\} 支持环境变量替换。

默认情况下，在运行时 KiCad 定义 两个环境变量 ：

• KIPRJMOD 环境变量，始终指向当前打开的项目目录。 KIPRJMOD 无法修改。

• KICAD_SYMBOL_DIR 环境变量。 这指向使用 KiCad 安装的默认符号库的路径。

您可以重写 KICAD_SYMBOL_DIR, 方法是在 “首选项/配置路径” 中自己定义它, 该路径允许您替换自己的库, 以取代默认的 KiCad 符号库。

KIPRJMOD 允许您在没有项目路径的情况下存储库 必须定义绝对路径（并不总是已知） 项目特定符号库表中的库。

使用模式

符号库可以全局定义，也可以专门定义到当前加载的项目。 用户全局表中定义的符号库始终可用，并存储在用户主文件夹的 sym-lib-table 文件中。 项目特定符号库表仅对当前打开的项目文件有效。

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

在项目特定的基础上定义所有符号库意味着您只有项目所需的库，这会减少符号库加载时间。 缺点是您必须始终记住添加每个项目所需的每个符号库。

一种使用模式是全局定义常用库，而库只需要项目特定库表中的项目。 对如何定义库没有限制。

遗留项目重新映射

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

• 原理图中使用的原始库仍然可用，并且在符号添加到原理图时保持不变。

• 在检测到所有恢复行动时，执行所有恢复行动以创建恢复库或使现有恢复库保持最新状态。

• 项目符号缓存库的完整性尚未损坏。