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

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

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

这些文件中包含大量重要设计信息，尤其是工程文件 (.kicad_pro)、原理图文件 (.kicad_sch) 和电路板文件 (.kicad_pcb)。其他文件也可能需要包含。在分发工程时，应始终包含这些文件。某些文件无需与工程一起分发，例如工程本地设置文件 (.kicad_prl) 或 fp-info-cache 文件。无需分发的文件在下方表格中有所标注。

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

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

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

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

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

现代版本的 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 工程管理器与 Git 版本控制工具集成，用于跟踪工程中的更改。它可以与现有的本地 Git 仓库配合使用，从远程仓库克隆工程，或在现有工程中创建新仓库。您可以使用该工具提交工程中的更改，从远程仓库推送和拉取代码，以及切换分支。

如果您打开一个已经使用 Git 进行版本控制的工程，即该工程属于现有的 Git 仓库，您可以直接使用 KiCad 的版本控制功能来跟踪工程中的更改，无需进行额外配置。当前活动分支会显示在工程名称旁边，而工程中每个文件的版本控制状态会在工程文件工作区中以图形方式显示。例如，图标 表示文件未更改， 表示文件有未提交的更改，而 表示文件未被跟踪。如果工程不属于 Git 仓库，则不会显示任何图标。

Accelerated graphics antialising: KiCad can use different methods to prevent aliasing (jagged lines) when rendering using a graphics card. Different methods may look better on different hardware, so you may want to experiment to find the one that looks best to you.

Fallback graphics antialiasing: KiCad can also apply antialiasing when using the fallback graphics mode. Enabling this feature may result in poor performance on some hardware.

Text editor: Choose a text editor to use when opening text files from the project tree view.

PDF viewer: Choose a program to use when opening PDF files.

Show icons in menus: Enables icons in drop-down menus throughout the KiCad user interface.

Show scrollbars in editors: When enabled, scrollbars are displayed next to the editing canvases in each tool. When disabled, scrollbars are not shown.

Focus follows mouse between schematic and PCB editors: When enabled, the window under the mouse cursor will automatically become focused.

Icon scale: Sets the size of the icons used in menus and buttons throughout KiCad. Choose Automatic to pick an appropriate icon scale automatically based on your operating system settings.

Icon theme: Sets whether to use the icon theme designed for light window backgrounds or dark window backgrounds. The default setting of Automatic will choose the theme based on the lightness of the operating system window theme.

High-contrast mode dimming factor: Sets how much non-focused items are dimmed in high-contrast display mode.

Warp mouse to origin of moved object: When enabled, the mouse cursor will be repositioned (warped) to the origin of an object when you start a move command on that object.

First hotkey selects tool: When disabled, pressing the hotkey for a command such as Add Wire will immediately start the command at the current cursor location. When enabled, pressing the hotkey the first time will just select the Add Wire tool but will not immediately begin a wire.

Remember open files for next project launch: When enabled, KiCad will automatically re-open any files that were previously open when a project is re-opened.

Auto save: When editing schematics and board files, KiCad can automatically save your work periodically. Set to 0 to disable this feature.

File history size: Configure the number of entries in the list of recently-opened files

3D cache file duration: KiCad creates a cache of 3D models in order to speed up the 3D viewer. You can configure how long to keep this cache before deleting old files.

Automatically backup projects: When enabled, KiCad projects will be archived to ZIP files automatically according to the settings below. The archives will be stored in a subfolder of the project folder. Backups are created when saving files in the project.

Create backups when auto save occurs: When enabled, a backup will be created every time an automatic file save occurs (if the backup is permitted by the settings below). This setting has no effect if the auto save interval is set to 0 (disabled).

Maximum backups to keep: When creating a new backup, the oldest backup file will be deleted to keep the total number of backup files below this limit.

Maximum backups per day: When creating a new backup, the oldest backup file created on the current day will be deleted to stay below this limit.

Minimum time between backups: If backup is triggered (for example, by saving a board file), the backup will not be created if an existing backup file is newer than this limit.

Maximum total backup size: When creating a new backup file, the oldest backup files will be deleted to keep the total size of the backup files directory below this limit.

Center and warp cursor on zoom: When enabled, zooming using the hotkeys or mouse wheel will cause the view to be centered on the cursor location.

Use zoom acceleration: When enabled, scrolling the mouse wheel or touchpad faster will cause the zoom to change faster.

Zoom speed: Controls how much the zoom changes for a given amount of scrolling the mouse wheel or touchpad. Use Automatic to set a default value depending on your operating system.

Automatically pan while moving object: When enabled, the view can be panned while moving an object by moving close to the edge of the canvas.

Auto pan speed: Controls how fast the canvas pans while moving an object.

Mouse buttons: You can set the behavior of dragging the middle and right mouse buttons to zoom the view, pan the view, or have no effect. You can also set the behavior of dragging the left mouse button depending on whether or not any objects are already selected in the editing canvas.

Mouse wheel and touchpad scrolling: You can set the behavior of scrolling the mouse wheel or vertical motion of the touchpad while pressing certain modifier keys.

Pan left/right with horizontal movement: When enabled, you can pan the view using the touchpad or horizontal scroll wheel (if present on your mouse).

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

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

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

Importing hotkeys

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

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

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

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

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

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

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

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

要添加新任务，请单击任务列表下的 按钮。在出现的添加新任务对话框中，选择所需的任务类型。您可以在底部的 筛选器 文本框中输入内容，过滤列表中显示的工作类型。

选择作业并按下 确定 后，将出现该类型输出的设置对话框。每个作业设置对话框提供的选项与从原理图或电路板编辑器手动生成该类型输出时相同。

接受作业设置对话框后，作业将被添加到作业列表中，您可以选择更改新作业的默认描述。要稍后更改作业描述或设置，请右键单击列表中的作业并选择 编辑作业描述 或 编辑作业设置…​。双击一项作业也可编辑其设置。要删除作业，请选择作业并单击 按钮。要对列表重新排序，请选择一项作业，然后使用 或 按钮将其上移或下移。

在添加作业集目标之前，无法从作业集生成任何输出。创建作业集时会自动创建一个目标，但您可以根据需要添加任意多个目标。

要添加作业集目标，请单击目的地列表下的 按钮。出现添加新目标对话框后，选择目标类型：

选择输出类型后，将出现 “目标” 选项对话框。

在这里，您可以选择哪些作业将作为此作业集目标的一部分运行，以及用于存储这些作业的文件夹或存档名称。默认情况下，所有作业都将启用。您还可以为目标设置一个描述，以便显示在 “目标” 列表中。输出路径控制作业生成的文件的保存位置。此处的路径可以是工程目录的绝对路径或相对路径，可以使用 《kicad 环境变量，路径变量》 或某些文本变量（${PROJECTNAME}、${CURRENT_DATE} 和 工程文本变量）。作业配置中定义的文件名是相对于作业集目标目录或归档根目录而言的。

单击对话框中的 确定 后，新的作业集目标就会添加到目的地列表中。您可以单击现有作业集目标的 按钮修改该目标，或单击其 按钮删除该目标。

配置好作业和目标后，您可以单击所需目标的 生成 按钮，生成一组单独的输出。单击 生成所有目标 按钮，可以同时运行所有目标。

如果作业集目标成功运行并生成其输出，则会显示一个蓝色检查符，表示上次运行成功。如果作业集目标未成功完成，则会显示红色感叹号，表示运行不成功。单击成功/失败指示符将显示作业集运行日志对话框，其中显示作业集目标中每个作业的状态。单击特定作业将显示该作业的日志输出（如果有的话）。

可提供以下类型的作业：

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

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

KiCad 会在 KICAD9_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 图像。

仓库中的所有包都显示在 PCM 的 仓库 选项卡中。 您可以通过选择选项卡顶部的下拉列表中的仓库来选择要浏览的仓库。默认情况下，仅启用 KiCad 官方仓库。

包被分为四个类别，每个类别在 仓库 标签下都有其专属的标签页：

窗口左侧的列表显示了每个类别中的软件包。您可以通过在软件包列表顶部的筛选框中输入内容来过滤软件包列表。按下 刷新 按钮可从在线仓库重新加载软件包列表。

当您在列表中选择一个软件包时，右侧会显示该软件包的相关信息。其中包括软件包的描述、许可证信息以及开发者的联系方式，还提供了报告错误和提交其他反馈的途径。

软件包信息还包括一个表格，列出了当前可用的软件包版本。对于每个版本，表格中显示了软件包的大小、其状态以及是否与您使用的 KiCad 版本兼容。

一个软件包的状态可以是以下几种之一，具体由软件包的开发者标明：

默认情况下，版本表仅显示与您当前使用的 KiCad 版本兼容的软件包版本。您可以通过勾选 显示所有版本 复选框，查看软件包的所有版本，包括那些与您的 KiCad 版本不兼容的版本。如果某个软件包有多个版本可供选择，您可以自行决定安装哪个版本。

当您决定安装一个软件包时，请在软件包的描述页面点击 安装 按钮。如果有多个版本的软件包可供选择，请在安装前在版本表中选择所需的版本。您还可以在软件包列表中点击 安装 按钮来安装最新版本。这并不会立即安装软件包；相反，软件包会被排队等待稍后安装，并显示在 待处理 标签页中。直到您点击 应用待处理更改 按钮时，软件包才会被安装，该按钮会一次性安装所有待处理的软件包。

要从待安装列表中移除单个软件包，请在 待处理 选项卡中选择该软件包，然后按下 按钮。若要取消所有待安装软件包的安装，请点击 放弃待处理更改 按钮。

一旦安装了一个包，它就会列在 已安装 标签页中。在此标签页中，您可以查看已安装包的列表，并更新或卸载其中的任何一个。

如果有任何软件包有新版本可用，工程管理器中的 PCM 图标会显示一个指示器，显示可用更新的数量。

要将某个包更新到不同版本，请在其版本表中选择新版本，然后点击 更新 按钮。您还可以在已安装包列表中，点击其 卸载 按钮旁边的下拉菜单中的 更新，将包更新到最新版本。要更新所有已安装的包，请点击已安装包列表顶部的 全部更新 按钮。如果在其下拉菜单中选择了 锁定包，则该包将不会被更新。

要卸载一个软件包，请在已安装软件包列表中或软件包的描述页面上点击其 卸载 按钮。

与安装过程类似，当您点击 更新 或 卸载 按钮时，软件包并不会立即更新或卸载。相反，该操作会被排入 待处理 标签页中，直到您单独应用每个更改或点击 应用待处理更改 按钮。

最后，您可以通过点击包描述底部的 下载 按钮并选择保存包的位置来下载包而不安装它。这使您可以在安装之前检查包中的文件。要安装已下载但尚未安装的包，请点击 从文件安装…​ 按钮并选择该包。打开包目录 按钮将在 KiCad 安装包的文件夹中打开文件浏览器。

默认情况下，PCM 仅使用 KiCad 官方仓库。您可以通过点击 仓库 选项卡顶部的 管理…​ 按钮来添加第三方仓库或移除现有仓库。

要添加仓库，请点击 按钮并指定仓库的完整 URL。要移除仓库，请选中它并按下 按钮。使用 和 按钮可以重新排列列表中的仓库顺序。

如果您移除了默认的 KiCad 官方仓库，可以通过点击图片旁边的下拉菜单中的 添加默认仓库 按钮轻松重新添加它 。

要为 PCM 创建软件包，请按照以下链接中的说明操作：https://dev-docs.kicad.org/en/addons/index.html。这些说明解释了如何为任何仓库创建 PCM 软件包，包括但不限于 KiCad 官方仓库。它们还解释了 KiCad 仓库中包含的软件包的规则，以及如何向该仓库提交软件包。第三方仓库使用相同的软件包格式，但可能有不同的提交规则和流程。

要创建您自己的仓库，请按照在 https://go.kicad.org/pcm/schemas/v1 发布的模式发布一个仓库 JSON 文件。

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