KiCad

KiCad 能够在多种硬件和操作系统上运行，但在低端硬件上执行某些任务可能会很慢或很困难。为获得最佳体验，建议使用 1920x1080 或更高分辨率的专用显卡和显示器。

有关最新的系统要求，请查看 KiCad 网站：https://kicad.org/help/system-requirements/

KiCad 创建并使用具有以下特定文件扩展名（和文件夹）的文件进行原理图和电路板编辑。

KiCad 的每个主要版本都有自己的配置，因此您可以在同一台计算机上运行多个 KiCad 版本，而不会干扰配置。首次运行新版本的 KiCad 时，系统将询问如何初始化设置：

如果检测到以前版本的 KiCad，您可以选择从该版本导入设置。系统会自动检测以前配置文件的位置，但如果需要，您可以覆盖该位置以选择其他位置。

请注意，KiCad 前一版本的原理图符号和封装库表将 不会 被导入。

如果您不想从以前的版本导入设置，也可以选择从默认设置开始。

KiCad 将设置文件存储在用户目录内的文件夹中。 每个 KiCad 版本都会使用不同版本的子文件夹。对于 KiCad 8，这些文件夹是：

现代版本的 KiCad 可以打开在早期版本中创建的文件，但只能写入最新格式的文件。这意味着，通常情况下，除了打开文件外，从以前版本迁移文件不需要特殊步骤。在某些情况下，文件的扩展名从一个 KiCad 版本更改到下一个版本。打开这些文件后，它们将以新的文件扩展名以新格式保存。旧文件不会自动删除。

原理图编辑器文档介绍了打开 旧版原理图 时的几个特别注意事项。

一般来说，一个新版本的 KiCad 创建或修改的文件 不能 被旧版本的 KiCad 打开。因此，在测试新的 KiCad 版本时保留项目的备份副本非常重要，直到您确信不再需要使用旧的 KiCad 版本。

您也可以在 单机模式 模式下运行 KiCad 编辑器工具，方法是直接从操作系统的应用程序启动器而不是从工程管理器启动这些工具。通常 不建议 在单机模式下运行工具，除非在某些特殊情况下必须这样做，例如从其他 EDA 工具导入工程时。 在单机模式下运行时，某些工程功能不可用，包括：

大多数 KiCad 设计都是从创建工程开始的。从 KiCad 工程管理器创建工程有两种方式：可以创建空工程，也可以基于现有模板创建工程。本节将介绍如何创建一个新的空工程。从模板创建工程在 《工程 - 模板，工程模板》一节中介绍。

若要创建新工程，请使用 文件 菜单中的 新建工程…​ 命令，或单击顶部工具栏中的 新建工程 按钮，或使用键盘快捷键 (默认为 Ctrl+N)。

系统将提示您输入工程名称。默认情况下，将使用相同的名称为您的工程创建一个目录。例如输入名称 MyProject，KiCad 会在其中创建 MyProject 目录和工程文件 MyProject/MyProject.kicad_pro。

如果您已经有一个存储工程文件的目录，可以在 新建工程 对话框中取消选中 为工程创建新目录 复选框。

选择工程名称后，KiCad 将在工程目录中创建以下文件：

KiCad 能够导入某些其他软件包创建的文件。 有些软件格式可以作为完整工程导入。 其他格式目前只能作为独立的原理图或电路板导入，必须手动连接到 KiCad 工程中。目前支持以下类型的工程：

要从这些工具中导入工程，请在 文件 菜单的 导入非 KiCad 工程 子菜单中选择合适的选项。

系统将提示您在导入文件浏览器对话框中选择原理图或电路板文件。导入的原理图和电路板文件应具有相同的基本文件名 (例如，project.sch 和 project.brd)。一旦选择了请求的文件，系统将要求您选择一个目录来存储生成的 KiCad 工程。

目前可在单机模式导入以下类型的文档。 要导入这些文件，请单独启动 KiCad 原理图编辑器或 PCB 编辑器（不要先打开 KiCad 工程管理器），然后选择 文件 > 导入 > 非 KiCad 原理图 或 文件 > 导入 > 非 KiCad 电路板文件。 导入 Altium 工程时，我们建议先导入 PCB，保存生成的工程，然后在单机模式的原理图编辑器窗口中导入工程后，将每个原理图页复制到工程中。

您可以使用存档工具将工程的文件存档到 zip 存档中（文件 → 存档工程…​）。

您也可以使用解压缩工具（文件 → 解压缩项目…​）来解压缩工程。将项目解压缩到当前加载的工程目录中时，工程将自动重新加载，以反映归档版本中的任何更改。

存档工具会将工程文件夹中的以下文件保存到存档中：

硬件图形抗锯齿： KiCad 可以使用不同的方法来防止使用显卡渲染时出现锯齿（锯齿线）。 不同的方法在不同的硬件上可能会有更好的效果，因此您可能需要尝试找到最适合您的方法。

软件图形抗锯齿： KiCad 还可在使用软件渲染模式时应用抗锯齿。 启用此功能可能会导致某些硬件性能不佳。

文本编辑器： 从工程树视图打开文本文件时，选择要使用的文本编辑器。

PDF 查看器： 选择打开 PDF 文件时使用的程序。

在菜单中显示图标： 在整个 KiCad 用户界面的下拉菜单中启用图标。

在编辑器中显示滚动条： 启用时，每个工具的编辑画布旁边都会显示滚动条。禁用时，不显示滚动条。

在原理图和 PCB 编辑器之间对焦跟随鼠标： 启用后，鼠标光标下的窗口将自动变为焦点。

图标比例： 设置 KiCad 中菜单和按钮所用图标的大小。 选择 自动 可根据操作系统设置自动选择合适的图标比例。

图标主题： 设置是使用为浅色窗口背景设计的图标主题，还是使用为深色窗口背景设计的图标主题。 默认设置自动将根据操作系统窗口主题的明暗程度选择主题。

高对比度模式调光因子： 设置高对比度显示模式下非聚焦项目的调光程度。

将鼠标移动到移动对象的原点： 启用后，当您开始对对象执行移动命令时，鼠标光标将被重新定位（跳转）到该对象的原点。

第一个热键选择工具： 禁用时，按下 添加导线 等命令的热键将立即在当前光标位置开始执行命令。 启用后，首次按下热键将只选择 添加导线 工具，但不会立即开始导线。

下次启动工程时记住打开的文件： 启用后，KiCad 将在重新打开工程时自动重新打开之前打开的任何文件。

自动保存： 编辑原理图和电路板文件时，KiCad 可定期自动保存您的工作。 设置为 0 可禁用此功能。

文件历史记录大小： 配置最近打开的文件列表中的条目数量

3D 缓存文件持续时间： KiCad 会创建一个 3D 模型缓存，以加快 3D 查看器的运行速度。 您可以设置在删除旧文件前保留此缓存的时间。

自动备份工程： 启用后，KiCad 工程将根据以下设置自动归档为 ZIP 文件。 存档文件将存储在工程文件夹的子文件夹中。 保存工程中的文件时会创建备份。

自动保存时创建备份： 启用后，每次自动保存文件时都将创建备份（如果以下设置允许备份）。 如果自动保存时间间隔设置为 0（禁用），则此设置无效。

保留的最大备份数： 创建新备份时，将删除最旧的备份文件，以使备份文件总数低于此限制。

每天最多备份次数： 创建新备份时，将删除当日创建的最旧备份文件，以保持低于此限制。

备份之间的最短间隔时间： 如果触发备份（例如，通过保存电路板文件），如果现有备份文件比此限制时间新，则不会创建备份。

最大备份总大小： 创建新备份文件时，将删除最旧的备份文件，以使备份文件目录的总大小低于此限制。

缩放时光标居中和跳转： 启用后，使用热键或鼠标滚轮缩放时，视图将以光标位置为中心。

使用缩放加速： 启用后，更快地滚动鼠标滚轮或触摸板会使缩放变化更快。

缩放速度： 控制滚动鼠标滚轮或触摸板一定量时的缩放变化程度。 使用 自动 设置默认值，具体取决于操作系统。

移动对象时自动平移： 启用后，在移动对象时，只要靠近画布边缘，就能平移视图。

自动平移速度： 控制移动对象时画布平移的速度。

鼠标按钮： 可以将拖动鼠标中键和右键的行为设置为缩放视图、平移视图或无影响。 您还可以根据编辑画布中是否已选中任何对象来设置拖动鼠标左键的行为。

鼠标滚轮和触摸板滚动： 可以设置在按下某些修改键时滚动鼠标滚轮或垂直移动触摸板的行为。

触摸板使用水平移动向左/右平移： 启用后，可以使用触摸板或水平滚轮（如果鼠标上有滚轮）平移视图。

可以使用此对话框自定义用于控制 KiCad 的快捷键。公用 部分中的快捷键在每个 KiCad 程序之间共享。当程序运行时，会显示每个特定 KiCad 程序的快捷键。您可以将相同的快捷键分配给不同 KiCad 程序 (例如原理图编辑器和电路板编辑器) 中的不同操作，但不能将一个快捷键分配给同一程序中的多个操作。

有许多可用命令，因此并非所有命令都默认分配了快捷键。您可以通过双击列表中的命令将快捷键添加到任何命令。如果选择已分配给其他命令的快捷键，则可以选择在所选命令上使用该快捷键，这将从冲突的命令中删除指定的快捷键。

你对快捷键分配所做的改变会在命令名称的末尾显示一个 \* 字符。 你可以通过右键单击某个特定的命令并选择 撤销更改 来撤销对该命令的更改，或者你可以通过命令列表下面的按钮撤销所有的更改。

导入快捷键

快捷键偏好设置存储在 KiCad 设置目录的 .hotkeys 文件中 (有关设置目录在操作系统上的位置，请参阅 《设置，设置》一节)。如果您在一台计算机上以您喜欢的方式配置了 KiCad 快捷键，则可以通过导入适当的 .hotkeys 文件将该配置传输到另一台计算机。

在 KiCad 中，可以使用 路径变量 定义路径。 KiCad 内部定义了一些路径变量，可用于为库、3D 图形等定义路径。

当绝对路径未知或可能发生变化时（例如，当您将工程传输到另一台计算机时），以及许多类似工程共享一个基本路径时，这非常有用。 请考虑以下可能安装在不同位置的内容：

例如，当使用 KICAD8_FOOTPRINT_DIR 路径变量时，connect.pretty 封装库的路径将被定义为 ${KICAD8_FOOTPRINT_DIR}/connect.pretty。

通过 偏好设置 → 配置路径…​ 菜单，您可以为 KiCad 的一些内置路径变量定义路径，并根据需要添加自己的路径变量来定义个人路径。

通过 偏好设置 → 管理符号库…​ 菜单，您可以管理符号库列表（符号库表）。

同样，使用 偏好设置 → 管理封装库表…​ 菜单来管理封装库列表（封装库表）。

对于每一种类型的库（符号和封装），都有2个库表：全局和工程专用。全局库表位于《配置文件位置，用户配置目录》中，包含所有工程可用的库列表。工程专用库表是可选的，包含工程专用的库列表。它位于工程目录中。

文件 → 从模板新建工程 菜单将打开工程模板选择器对话框：

单击模板的图标将显示模板信息，再单击“确定”按钮将创建新工程。 模板文件将复制到新工程位置并重命名以反映新工程的名称。

KiCad 在 KICAD8_TEMPLATE_DIR 路径变量中定义的路径下查找系统模板，在 KICAD_USER_TEMPLATE_DIR 中定义的路径下查找用户模板。不过，您可以使用对话框顶部的 文件夹 控件浏览任意目录中的模板。

KiCad 模板只是一个包含模板工程文件的目录，以及子目录 meta 中模板所需的一些元数据。包含模板文件的目录名称决定了模板的名称。根据模板创建工程时，KiCad 会将模板文件复制到新的工程目录，并重新命名这些文件以匹配新工程名称，如下所述。

模板中的所有文件都会被复制，但有两个例外：

meta 目录必须包含一个名为 info.html 的 HTML 文件，该文件将显示在 KiCad 模板浏览器中，并应包含描述模板的基本信息。支持基本的 HTML 功能，包括图像。 由 info.html 引用的任何图像也应存储在 meta 目录中。

<title> 标记决定模板选择时显示的模板名称。请注意，如果工程模板名称太长，将会被截断。显示名称不必与模板目录名称相同。

这里有一个 info.html 文件的例子：

最后，meta 可选择包含一张名为 icon.png 的图片，该图片将在模板选择对话框中用作模板的图标。图标应为 64 x 64 像素的 PNG 图像。

以下操作在 KiCad 工程管理器中是可用的。热键可以分配给偏好设置中的 快捷键 部分的任何动作。