KiCad Nightly 参考手册

本文档的版权归 (C) 2023-2024 所有,由下列贡献者提供。您可以根据 GNU 通用公共许可证 (http://www.gnu.org/licenses/gpl.html) 版本 3 或更高版本或知识共享署名许可证 (http://creativecommons.org/licenses/by/3.0/) 版本 3.0 或更高版本的条款分发和/或修改它。

本指南中的所有商标均属于其合法所有者。

Contributors

Graham Keeth

翻译人员

taotieren <[email protected]>, 2019-2025.

Feedback

KiCad 项目欢迎与软件或其文档相关的反馈、错误报告和建议。有关如何提交反馈或报告问题的更多信息,请参阅 https://www.kicad.org/help/report-an-issue/ 上的说明

Software and Documentation Version

本用户手册基于 KiCad 9.99 版本。其他版本的 KiCad 在功能和界面外观上可能存在差异。

文档修订版:bee131f6

KiCad 命令行界面简介

KiCad 提供了一个命令行界面,可以通过运行 kicad-cli 二进制文件来使用。使用命令行界面,您可以以自动化方式对原理图、PCB、符号和封装执行许多操作,例如绘制 PCB 设计中的 Gerber 文件或将符号库从传统文件格式升级到现代格式。

在 macOS 上,kicad-cli 可执行文件位于 /Applications/KiCad/KiCad.app/Contents/MacOS/kicad-cli

kicad-cli 命令包含 6 个子命令: fpjobsetpcbschsymversion。每个子命令都可以有自己的子命令和参数。例如,要从 PCB 导出 Gerber 文件,您可以运行 kicad-cli pcb export gerbers example.kicad_pcb

您可以添加 --help-h 标志来查看有关每个子命令的信息。例如,运行 kicad-cli pcb -h 打印有关 pcb 子命令的使用信息,而 kicad-cli pcb export gerbers -h 专门打印 pcb export gerbers 子命令的使用信息。

封装命令

fp 子命令将封装导出为另一种格式,或将封装库升级到 KiCad 封装文件格式的当前版本。

封装导出

fp export svg 命令将指定库中的一个或多个封装导出到 SVG 文件中。

Usage: kicad-cli fp export svg [--help] [--output OUTPUT_DIR] [--layers LAYER_LIST] [--define-var KEY=VALUE] [--theme VAR] [--footprint FOOTPRINT_NAME] [--sketch-pads-on-fab-layers] [--hide-DNP-footprints-on-fab-layers] [--sketch-DNP-footprints-on-fab-layers] [--crossout-DNP-footprints-on-fab-layers] [--black-and-white] INPUT_DIR

位置参数:

INPUT_DIR

要导出的封装库目录(.pretty)。

可选参数:

-h, --help

显示封装 SVG 导出命令的帮助信息。

-o <output dir>, --output <output dir>

导出文件的输出目录。当未使用此参数时,文件将导出到当前目录。

-l <layer list>, --layers <layer list>

从封装中导出的层名的逗号分隔列表,例如 F.Cu,B.Cu。如果未指定层,则导出所有层。层名可以指定为规范层名(F.CuIn.1F.Fab 等)或用户定义(自定义)层名,但规范层名优先匹配。

-D <variable name>=<value>, --define-var <variable_name>=<value>

添加或覆盖项目变量定义。可多次使用以定义多个变量。

-t <theme name>, --theme <theme name>

用于导出的主题名称。如果未指定主题,则使用封装编辑器当前选择的主题。

--fp <footprint>, --footprint <footprint>

从库中导出的特定封装的名称。当未使用此参数时,库中的所有封装都会被导出。

--sp, --sketch-pads-on-fab-layers

在正面和背面 Fab 层上绘制焊盘轮廓及其编号。

--hdnp, --hide-DNP-footprints-on-fab-layers

不要在 Fab 层上绘制 DNP 封装的文本和图形。

--sdnp, --sketch-DNP-footprints-on-fab-layers

在 Fab 层上以草图模式绘制 DNP 封装的图形。

--cdnp, --crossout-DNP-footprints-on-fab-layers

在 Fab 层上的 DNP 封装的外框上画一个 "X",并划掉其位号。

--black-and-white

以黑白形式导出封装。

封装升级

fp upgrade 命令将指定的封装库从旧的 KiCad 封装格式或非 KiCad 封装格式转换为当前版本 KiCad 的原生格式。如果输入库已经采用当前文件格式,则不会采取任何操作。

支持的输入封装格式为:

  • KiCad 封装库(包含 .kicad_mod 文件的 .pretty 文件夹)

  • KiCad(5.0 之前版本)封装库(.mod.emp

  • Altium 封装库 (.PcbLib)

  • Altium 集成库 (.IntLib)

  • CADSTAR PCB 存档文件 (.cpa)

  • EAGLE XML 库 (.lbr)

  • EasyEDA (JLCEDA) 标准版文件 (.json)

  • EasyEDA (JLCEDA) 专业版文件 (.elibz, .epro, .zip)

  • GEDA/PCB 库(包含 .fp 文件的文件夹)

Usage: kicad-cli fp upgrade [--help] [--output OUTPUT_DIR] [--force] INPUT_DIR

位置参数:

INPUT_DIR

要升级的封装库目录。对于 KiCad 格式的封装库,这是 .pretty 目录,而不是 .kicad_mod 文件。

可选参数:

-h, --help

显示封装升级命令的帮助信息。

-o <output dir>, --output <output dir>

升级后的封装的输出目录。当未使用此参数时,升级后的封装将覆盖原始封装。

--force

即使输入库已采用当前文件格式,仍需重新保存该库。

jobset 命令

jobset run 命令用于运行预先定义的 jobset

Usage: kicad-cli jobset run [--help] [--stop-on-error] [--file JOB_FILE] [--output OUTPUT] INPUT_FILE

位置参数:

INPUT_FILE

与 jobset 配合使用的工程文件。

可选参数:

-h, --help

显示 jobset 命令的帮助信息。

--stop-on-error

由于任务按顺序执行,当某个任务失败时,将停止后续任务的执行。如果未指定此选项,则在任何任务失败后,后续任务将继续执行。

-f <jobset file>, --file <jobset file>

要运行的 jobset 文件(.kicad_jobset)。

--output <output ID>

要生成的作业集输出。如果未指定输出,则将生成所有输出。输出通过唯一标识符进行指定。当未使用 --output 选项时,每个输出的标识符将由 jobset run 命令打印。该标识符还可在 .kicad_jobset 文件的输出 id 键下找到。

PCB 命令

pcb 命令用于执行设计规则检查或将电路板导出为多种其他文件格式,包括制造文件和 3D 文件。

PCB DRC

pcb drc 命令对电路板执行设计规则检查并生成报告。

Usage: kicad-cli pcb drc [--help] [--output OUTPUT_FILE] [--define-var KEY=VALUE] [--format FORMAT] [--all-track-errors] [--schematic-parity] [--units UNITS] [--severity-all] [--severity-error] [--severity-warning] [--severity-exclusions] [--exit-code-violations] INPUT_FILE

位置参数:

INPUT_FILE

用于运行 DRC 的电路板文件。

-h, --help

显示 DRC 命令的帮助信息。

-o <output filename>, `--output <output filename>

生成的 DRC 报告的输出文件名。当未使用此参数时,输出文件名将与输入文件相同,文件扩展名根据所选格式不同,分别为 .rpt.json

-D <variable name>=<value>, --define-var <variable_name>=<value>

添加或覆盖项目变量定义。可多次使用以定义多个变量。

--format <format>

报告文件格式。可选格式为 report(默认)或 json

--all-track-errors

为每条布线报告所有错误。

--schematic-parity

检查 PCB 与原理图之间的对齐情况。

--units <unit>

报告中使用的单位。可选单位包括 mm(默认)、inmils

--severity-all

报告所有 DRC 违规行为。这相当于使用所有其他 DRC 严重性选项。

--severity-error

报告所有错误级别的 DRC 违规项。此选项可与其他 DRC 严重性选项结合使用。

--severity-warning

报告所有警告级别的 DRC 违规。这可以与其他 DRC 严重性选项结合使用。

--severity-exclusions

报告所有被排除的 DRC 违规行为。这可以与其他 DRC 严重性选项结合使用。

--exit-code-violations

根据是否存在 DRC 违规情况返回退出代码。如果未发现任何违规,退出代码为 0;如果发现任何违规,退出代码为 5。

PCB BREP (OCCT) 导出

pcb export brep 命令将电路板设计导出为 BREP(OCCT 原生边界表示)3D 模型文件。

Usage: kicad-cli pcb export brep [--help] [--output OUTPUT_FILE] [--define-var KEY=VALUE] [--force] [--no-unspecified] [--no-dnp] [--grid-origin] [--drill-origin] [--subst-models] [--board-only] [--cut-vias-in-body] [--no-board-body] [--no-components] [--component-filter VAR] [--include-tracks] [--include-pads] [--include-zones] [--include-inner-copper] [--include-silkscreen] [--include-soldermask] [--fuse-shapes] [--fill-all-vias] [--min-distance MIN_DIST] [--net-filter VAR] [--user-origin VAR] INPUT_FILE

位置参数:

INPUT_FILE

导出电路板文件。

可选参数:

-h, --help

显示 BREP 导出命令的帮助信息。

-o <output filename>, --output <output filename>

输出文件名。当未使用此参数时,输出文件名将与输入文件相同,并带有 .brep 文件扩展名。

-D <variable name>=<value>, --define-var <variable_name>=<value>

添加或覆盖项目变量定义。可多次使用以定义多个变量。

-f, --force

覆盖输出文件。

--no-unspecified

排除具有 “未指定” 封装类型的元件的 3D 模型。

--no-dnp

排除具有 “DNP” 属性的元件的 3D 模型。

--grid-origin

将网格原点作为输出文件的原点。

--drill-origin

将钻孔原点作为输出文件的原点。

--subst-models

如果存在同名的 STEP 或 IGS 模型,则用它们替换封装中的 VRML 模型。

--board-only

仅将电路板本身包含在生成的模型中;排除所有元件模型。

--cut-vias-in-body

即使导电层未导出,仍需在电路板本体上开孔。

--no-board-body

排除电路板主体。

--no-components

排除元件的 3D 模型。

--component-filter <reference designator list>

仅包含与以下位号列表匹配的元件 3D 模型(以逗号分隔,支持通配符)

--include-tracks

在导出时包含外层导电层上的布线和过孔(耗时)。

--include-pads

在导出时包含焊盘(耗时)。

--include-zones

在导出时包含敷铜(耗时)。

--include-inner-copper

在导出时包含内导体层中的元素。

--include-silkscreen

在导出时将丝印图形作为一组平面图形包含在内。

--include-soldermask

在导出时将阻焊层作为一组平面。

--fuse-shapes

在导出时将重叠的几何体合并在一起(耗时)。

--fill-all-vias

请勿通过导电层上的过孔进行切割。

--min-distance <min distance>

将两个点视为位于同一位置的误差。默认值:0.01mm

--net-filter <net filter>

仅包含与该通配符匹配的网络中的铜对象。

--user-origin <output origin>

指定输出文件的自定义原点,包括 X 和 Y 坐标。例如,1x1in1x1inch25.4x25.4mm。默认单位为毫米。

PCB 钻孔文件导出

pcb export drill 命令从电路板导出钻孔文件。

Usage: kicad-cli pcb export drill [--help] [--output OUTPUT_DIR] [--format FORMAT] [--drill-origin DRILL_ORIGIN] [--excellon-zeros-format ZEROS_FORMAT] [--excellon-oval-format OVAL_FORMAT] [--excellon-units UNITS] [--excellon-mirror-y] [--excellon-min-header] [--excellon-separate-th] [--generate-map] [--map-format MAP_FORMAT] [--gerber-precision VAR] INPUT_FILE

位置参数:

INPUT_FILE

导出电路板文件。

可选参数:

-h, --help

显示钻孔文件导出命令的帮助信息。

-o <output dir>, --output <output dir>

钻孔文件的输出目录。当未使用此参数时,钻孔文件将保存在当前目录中。

--format <format>

钻孔文件格式。可选格式为 excellon(默认)或 gerber

--drill-origin <origin>

钻孔文件的坐标原点。可选项包括 absolute(默认)使用电路板的绝对原点,或 plot 使用电路板的钻孔/布局原点。

--excellon-zeros-format <format>

钻孔文件的零导格式。可选项包括 decimal(默认十进制)、suppressleading(抑制前导)、suppresstrailing(抑制后导) 或 keep。仅适用于 Excellon 格式钻孔文件。

--excellon-oval-format <format>

控制椭圆形孔的钻孔模式。可选模式为 routealternate(默认)。仅适用于 Excellon 格式的钻孔文件。

-u <units>, --excellon-units <units>

钻孔文件的单位。可选单位为 mm(默认)或 in。仅适用于 Excellon 格式钻孔文件。

--excellon-mirror-y

将钻孔文件在 Y 方向上镜像。仅适用于 Excellon 格式的钻孔文件。

--excellon-min-header

在钻孔文件中使用最小的钻头。仅适用于 Excellon 格式的钻孔文件。

--excellon-separate-th

为电镀孔和非电镀孔分别生成钻孔文件。 仅适用于 Excellon 格式的钻孔文件。

--generate-map

除了钻孔文件外,还生成一个映射文件。

--map-format <format>

映射文件格式。可选格式包括 pdf(默认)、gerberx2psdxfsvg

--gerber-precision <precision>

钻孔文件的精度(位数)。有效选项为 56(默认值)。仅适用于 Gerber 格式的钻孔文件。

PCB DXF 导出

pcb export dxf 命令将电路板设计导出为 DXF 文件。

Usage: kicad-cli pcb export dxf [--help] [--output OUTPUT_FILE] [--layers LAYER_LIST] [--drawing-sheet SHEET_PATH] [--define-var KEY=VALUE] [--exclude-refdes] [--exclude-value] [--sketch-pads-on-fab-layers] [--hide-DNP-footprints-on-fab-layers] [--sketch-DNP-footprints-on-fab-layers] [--crossout-DNP-footprints-on-fab-layers] [--subtract-soldermask] [--use-contours] [--use-drill-origin] [--include-border-title] [--output-units UNITS] [--drill-shape-opt VAR] [--common-layers COMMON_LAYER_LIST] [--mode-single] [--mode-multi] [--plot-invisible-text] INPUT_FILE

位置参数:

INPUT_FILE

导出电路板文件。

可选参数:

-h, --help

显示 DXF 导出命令的帮助信息。

-o <output filename>, --output <output filename>

输出文件名。当未使用此参数时,输出文件名将与输入文件相同,并带有 .dxf 文件扩展名。

-l <layer list>, --layers <layer list>

从封装中导出的层名称的逗号分隔列表,例如 F.Cu,B.Cu。必须至少指定一个层。层名称可以指定为规范层名称(如 F.CuIn.1F.Fab 等)或用户自定义(自定义)层名称,但规范层名称将优先匹配。

--drawing-sheet <sheet path>

用于绘制的图纸路径,覆盖板文件中指定的图纸。

-D <variable name>=<value>, --define-var <variable_name>=<value>

添加或覆盖项目变量定义。可多次使用以定义多个变量。

--erd, --exclude-refdes

从绘制中排除封装位号。

--ev, --exclude-value

从绘制中排除封装值。

--sp, --sketch-pads-on-fab-layers

在正面和背面 Fab 层上绘制焊盘轮廓及其编号。

--hdnp, --hide-DNP-footprints-on-fab-layers

不要在 Fab 层上绘制 DNP 封装的文本和图形。

--sdnp, --sketch-DNP-footprints-on-fab-layers

在 Fab 层上以草图模式绘制 DNP 封装的图形。

--cdnp, --crossout-DNP-footprints-on-fab-layers

在 Fab 层上的 DNP 封装的外框上画一个 "X",并划掉其位号。

--subtract-soldermask

从没有阻焊层的区域去除丝印。

--uc, --use-contours

使用轮廓绘制图形对象。

--udo, --use-drill-origin

使用钻孔/放置文件的原点进行绘制。

-ibt, --include-border-title

在绘制中包含图纸边框和标题栏。

--ou <unit>, --output-units <unit>

输出单位。可选单位为 mmin(默认)。

--drill-shape-opt <shape>

钻孔标记在图中的形状。选项包括:0 表示不显示钻孔标记,1 表示显示小标记,或 2 表示显示实际大小的标记(默认)。

--cl <layer list>, --common-layers <layer list>

以逗号分隔的图层名称列表,用于在所有图层上绘制,例如 F.Cu,B.Cu。图层名称可以指定为标准图层名称(如 F.CuIn.1F.Fab 等)或用户自定义(自定义)图层名称,但标准图层名称将优先匹配。

--mode-single

生成一个单一文件,其中输出参数路径作为完整的目录和文件名路径。COMMON_LAYER_LIST 在此模式下不生效。相反,LAYER_LIST 控制所有绘制的图层。

--mode-multi

生成一个或多个与 KiCad 图形用户界面(GUI)绘制功能类似的文件。指定的输出路径用于指定一个目录,用于存放生成的文件。

--plot-invisible-text

强制绘制值和位号,即使它们不可见。此参数自 KiCad 9.0.1起已废弃且无效。它将在未来版本的 KiCad 中被移除。要绘制不可见文本,请编辑电路板以使文本不再不可见。

PCB GenCAD 导出

pcb export gencad 命令将电路板设计导出为 GenCAD 文件。

Usage: kicad-cli pcb export gencad [--help] [--output OUTPUT_FILE] [--define-var KEY=VALUE] [--flip-bottom-pads] [--unique-pins] [--unique-footprints] [--use-drill-origin] [--store-origin-coord] INPUT_FILE

位置参数:

INPUT_FILE

导出电路板文件。

可选参数:

-h, --help

显示 DXF 导出命令的帮助信息。

-o <output filename>, --output <output filename>

输出文件名。当未使用此参数时,输出文件名将与输入文件相同,并带有 .cad 文件扩展名。

-D <variable name>=<value>, --define-var <variable_name>=<value>

添加或覆盖项目变量定义。可多次使用以定义多个变量。

-f, --flip-bottom-pads

翻转底部封装 padstacks。

--unique-pins

生成唯一的引脚名称。

--unique-footprints

为每个封装实例生成一个新形状(不要重复使用形状)。

--use-drill-origin

使用钻孔/放置文件的原点作为原点。

--store-origin-coord

将原始坐标保存到文件中。

PCB Gerber 文件导出:每个文件包含多个层

pcb export gerbers 命令将电路板设计导出为 Gerber 文件,每个文件对应一层。

请注意,Gerber 导出命令有两个不同的版本,即 gerbergerbersgerber 命令将多个 PCB 层绘制到一个 Gerber 文件中,而 gerbers 命令则将多个 Gerber 文件绘制出来,每个文件对应一个 PCB 层。通常情况下,gerbers 命令是用于 PCB 制造的正确命令。

Usage: kicad-cli pcb export gerbers [--help] [--output OUTPUT_FILE] [--layers LAYER_LIST] [--drawing-sheet SHEET_PATH] [--define-var KEY=VALUE] [--exclude-refdes] [--exclude-value] [--include-border-title] [--sketch-pads-on-fab-layers] [--hide-DNP-footprints-on-fab-layers] [--sketch-DNP-footprints-on-fab-layers] [--crossout-DNP-footprints-on-fab-layers] [--no-x2] [--no-netlist] [--subtract-soldermask] [--disable-aperture-macros] [--use-drill-file-origin] [--precision PRECISION] [--no-protel-ext] [--plot-invisible-text] [--common-layers COMMON_LAYER_LIST] [--board-plot-params] INPUT_FILE

位置参数:

INPUT_FILE

导出电路板文件。

可选参数:

-h, --help

显示 Gerber 导出命令的帮助信息。

-o <output dir>, --output <output dir>

导出文件的输出文件夹。当未使用此参数时,文件将导出到当前目录。

-l <layer list>, --layers <layer list>

从电路板中绘制的层名称的逗号分隔列表,例如 F.Cu,B.Cu。如果未使用此参数,将绘制所有层。 每个层将生成一个单独的输出文件。层名可以指定为标准层名(如 F.CuIn.1F.Fab 等)或用户自定义(自定义)层名,但标准层名将优先匹配。

--drawing-sheet <sheet path>

用于绘制的图纸路径,覆盖板文件中指定的图纸。

-D <variable name>=<value>, --define-var <variable_name>=<value>

添加或覆盖项目变量定义。可多次使用以定义多个变量。

--erd, --exclude-refdes

从绘制中排除封装位号。

--ev, --exclude-value

从绘制中排除封装值。

--ibt, --include-border-title

包含图纸边框和标题栏。

--sp, --sketch-pads-on-fab-layers

在正面和背面 Fab 层上绘制焊盘轮廓及其编号。

--hdnp, --hide-DNP-footprints-on-fab-layers

不要在 Fab 层上绘制 DNP 封装的文本和图形。

--sdnp, --sketch-DNP-footprints-on-fab-layers

在 Fab 层上以草图模式绘制 DNP 封装的图形。

--cdnp, --crossout-DNP-footprints-on-fab-layers

在 Fab 层上的 DNP 封装的外框上画一个 "X",并划掉其位号。

--no-x2

请勿使用扩展的 X2 格式。

--no-netlist

请勿包含网表属性。

--subtract-soldermask

从没有阻焊层的区域去除丝印。

--disable-aperture-macros

禁用光圈宏。

--use-drill-file-origin

使用钻孔/放置文件原点而非绝对原点。

--precision <precision>

Gerber 文件的精度(位数)。有效选项为 56(默认值)。

--no-protel-ext

使用 .gbr 文件扩展名,而非 Protel 文件扩展名(如 .gbl.gtl 等)。

--plot-invisible-text

强制绘制值和位号,即使它们不可见。此参数自 KiCad 9.0.1起已废弃且无效。它将在未来版本的 KiCad 中被移除。要绘制不可见文本,请编辑电路板以使文本不再不可见。

--cl <layer list>, --common-layers <layer list>

以逗号分隔的图层名称列表,用于在所有图层上绘制,例如 F.Cu,B.Cu。每个指定的图层都会包含在每个输出文件中。图层名称可以指定为标准图层名称(如 F.CuIn.1F.Fab 等)或用户自定义(自定义)图层名称,但标准图层名称将优先匹配。

--board-plot-params

使用电路板文件中已配置的 Gerber 绘制设置。

PCB Gerber 文件导出:每个文件包含多个层

pcb export gerber 命令将一个或多个电路板层导出到单个 Gerber 文件中。

请注意,Gerber 导出命令有两个不同的版本,即 gerbergerbersgerber 命令将多个 PCB 层绘制到一个 Gerber 文件中,而 gerbers 命令则将多个 Gerber 文件绘制出来,每个文件对应一个 PCB 层。通常情况下,gerbers 命令是用于 PCB 制造的正确命令。
pcb export gerber 命令在 KiCad 9.0 中已废弃,并在 KiCad 10.0 中将被移除。请改用 pcb export gerbers 命令。

Usage: kicad-cli pcb export gerber [--help] [--output OUTPUT_FILE] [--layers LAYER_LIST] [--drawing-sheet SHEET_PATH] [--define-var KEY=VALUE] [--exclude-refdes] [--exclude-value] [--include-border-title] [--sketch-pads-on-fab-layers] [--hide-DNP-footprints-on-fab-layers] [--sketch-DNP-footprints-on-fab-layers] [--crossout-DNP-footprints-on-fab-layers] [--no-x2] [--no-netlist] [--subtract-soldermask] [--disable-aperture-macros] [--use-drill-file-origin] [--precision PRECISION] [--no-protel-ext] [--plot-invisible-text] INPUT_FILE

位置参数:

INPUT_FILE

导出电路板文件。

可选参数:

-h, --help

显示 Gerber 导出命令的帮助信息。

-o <output filename>, --output <output filename>

输出文件名。当未使用此参数时,输出文件名将与输入文件相同,并带有 .gbr 文件扩展名。

-l <layer list>, --layers <layer list>

从电路板中绘制的层名称的逗号分隔列表,例如 F.Cu,B.Cu。所有层都将在输出文件中绘制。至少必须指定一个层。层名称可以指定为标准层名称(F.CuIn.1F.Fab 等)或用户自定义(自定义)层名称,但标准层名称将优先匹配。

--drawing-sheet <sheet path>

用于绘制的图纸路径,覆盖板文件中指定的图纸。

-D <variable name>=<value>, --define-var <variable_name>=<value>

添加或覆盖项目变量定义。可多次使用以定义多个变量。

--erd, --exclude-refdes

从绘制中排除封装位号。

--ev, --exclude-value

从绘制中排除封装值。

--ibt, --include-border-title

包含图纸边框和标题栏。

--sp, --sketch-pads-on-fab-layers

在正面和背面 Fab 层上绘制焊盘轮廓及其编号。

--hdnp, --hide-DNP-footprints-on-fab-layers

不要在 Fab 层上绘制 DNP 封装的文本和图形。

--sdnp, --sketch-DNP-footprints-on-fab-layers

在 Fab 层上以草图模式绘制 DNP 封装的图形。

--cdnp, --crossout-DNP-footprints-on-fab-layers

在 Fab 层上的 DNP 封装的外框上画一个 "X",并划掉其位号。

--no-x2

请勿使用扩展的 X2 格式。

--no-netlist

请勿包含网表属性。

--subtract-soldermask

从没有阻焊层的区域去除丝印。

--disable-aperture-macros

禁用光圈宏。

--use-drill-file-origin

使用钻孔/放置文件原点而非绝对原点。

--precision <precision>

Gerber 文件的精度(位数)。有效选项为 56(默认值)。

--no-protel-ext

使用 .gbr 文件扩展名,而非 Protel 文件扩展名(如 .gbl.gtl 等)。

--plot-invisible-text

强制绘制值和位号,即使它们不可见。此参数自 KiCad 9.0.1起已废弃且无效。它将在未来版本的 KiCad 中被移除。要绘制不可见文本,请编辑电路板以使文本不再不可见。

PCB GLB 导出

pcb export glb 命令将电路板设计导出为 GLB(二进制 glTF)3D 模型文件。

Usage: kicad-cli pcb export glb [--help] [--output OUTPUT_FILE] [--define-var KEY=VALUE] [--force] [--no-unspecified] [--no-dnp] [--grid-origin] [--drill-origin] [--subst-models] [--board-only] [--cut-vias-in-body] [--no-board-body] [--no-components] [--component-filter VAR] [--include-tracks] [--include-pads] [--include-zones] [--include-inner-copper] [--include-silkscreen] [--include-soldermask] [--fuse-shapes] [--fill-all-vias] [--min-distance MIN_DIST] [--net-filter VAR] [--user-origin VAR] INPUT_FILE

位置参数:

INPUT_FILE

导出电路板文件。

可选参数:

-h, --help

显示 GLB 导出命令的帮助信息。

-o <output filename>, --output <output filename>

输出文件名。当未使用此参数时,输出文件名将与输入文件相同,并带有 .glb 文件扩展名。

-D <variable name>=<value>, --define-var <variable_name>=<value>

添加或覆盖项目变量定义。可多次使用以定义多个变量。

-f, --force

覆盖输出文件。

--no-unspecified

排除具有 “未指定” 封装类型的元件的 3D 模型。

--no-dnp

排除具有 “DNP” 属性的元件的 3D 模型。

--grid-origin

将网格原点作为输出文件的原点。

--drill-origin

将钻孔原点作为输出文件的原点。

--subst-models

如果存在同名的 STEP 或 IGS 模型,则用它们替换封装中的 VRML 模型。

--board-only

仅将电路板本身包含在生成的模型中;排除所有元件模型。

--cut-vias-in-body

即使导电层未导出,仍需在电路板本体上开孔。

--no-board-body

排除电路板主体。

--no-components

排除元件的 3D 模型。

--component-filter <reference designator list>

仅包含与以下位号列表匹配的元件 3D 模型(以逗号分隔,支持通配符)

--include-tracks

在导出时包含外层导电层上的布线和过孔(耗时)。

--include-pads

在导出时包含焊盘(耗时)。

--include-zones

在导出时包含敷铜(耗时)。

--include-inner-copper

在导出时包含内导体层中的元素。

--include-silkscreen

在导出时将丝印图形作为一组平面图形包含在内。

--include-soldermask

在导出时将阻焊层作为一组平面。

--fuse-shapes

在导出时将重叠的几何体合并在一起(耗时)。

--fill-all-vias

请勿通过导电层上的过孔进行切割。

--min-distance <min distance>

将两个点视为位于同一位置的误差。默认值:0.01mm

--net-filter <net filter>

仅包含与该通配符匹配的网络中的铜对象。

--user-origin <output origin>

指定输出文件的自定义原点,包括 X 和 Y 坐标。例如,1x1in1x1inch25.4x25.4mm。默认单位为毫米。

PCB IPC-2581 导出

pcb export ipc2581 命令将电路板设计导出为 IPC-2581 格式。

Usage: kicad-cli pcb export ipc2581 [--help] [--output OUTPUT_FILE] [--drawing-sheet SHEET_PATH] [--define-var KEY=VALUE] [--precision PRECISION] [--compress] [--version VAR] [--units VAR] [--bom-col-int-id FIELD_NAME] [--bom-col-mfg-pn FIELD_NAME] [--bom-col-mfg FIELD_NAME] [--bom-col-dist-pn FIELD_NAME] [--bom-col-dist FIELD_NAME] INPUT_FILE

INPUT_FILE

导出电路板文件。

可选参数:

-h, --help

显示 IPC-2581 导出命令的帮助信息。

-o <output filename>, --output <output filename>

输出文件名。当未使用此参数时,输出文件名将与输入文件相同,并带有 .xml 文件扩展名。

--drawing-sheet <sheet path>

用于绘制的图纸路径,覆盖板文件中指定的图纸。

-D <variable name>=<value>, --define-var <variable_name>=<value>

添加或覆盖项目变量定义。可多次使用以定义多个变量。

--precision <precision>

导出文件的精度(小数点后位数)。默认值为 6

--compress

将输出文件压缩为 ZIP 文件。

--version <IPC-2581 standard version>

使用 IPC-2581 标准版本。可选项为 BC(默认)。

--units

用于导出的单位。可选单位为 mm(默认)或 in

--bom-col-int-id

用于 BOM 内部 ID 列的元件字段名称。可以是任何封装字段,或留空以省略该列。

--bom-col-mfg-pn

用于 BOM 制造商元件编号列的元件字段名称。可以是任何封装字段,或留空以省略该列。

--bom-col-mfg

用于 BOM 制造商列的元件字段名称。可以是任何封装字段,或留空以省略该列。

--bom-col-dist-pn

用于 BOM 分销商元件编号列的元件字段名称。可以是任何封装字段,或留空以省略该列。

--bom-col-dist

用于 BOM 分销商列的元件字段名称。可以是任何封装字段,或留空以省略该列。

PCB IPC-D-356 导出

pcb export ipcd356 命令从电路板设计中生成 IPC-D-356 网表。

Usage: kicad-cli pcb export ipcd356 [--help] [--output OUTPUT_FILE] INPUT_FILE

位置参数:

INPUT_FILE

导出电路板文件。

可选参数:

-h, --help

显示 IPC-D-356 导出命令的帮助信息。

-o <output filename>, --output <output filename>

输出文件名。当未使用此参数时,输出文件名将与输入文件相同,并带有 .d356 文件扩展名。

PCB ODB++ 导出

pcb export odb 命令将电路板设计导出为 ODB++ 格式。

Usage: kicad-cli pcb export odb [--help] [--output OUTPUT_FILE] [--drawing-sheet SHEET_PATH] [--define-var KEY=VALUE] [--precision PRECISION] [--compression VAR] [--units VAR] INPUT_FILE

位置参数:

INPUT_FILE

导出电路板文件。

可选参数:

-h, --help

显示 ODB++ 导出命令的帮助信息。

-o <output filename>, --output <output filename>

输出文件名,或在不使用压缩时为文件夹名。

--drawing-sheet <sheet path>

用于绘制的图纸路径,覆盖板文件中指定的图纸。

-D <variable name>=<value>, --define-var <variable_name>=<value>

添加或覆盖项目变量定义。可多次使用以定义多个变量。

--precision <precision>

导出文件的精度(小数点后位数)。默认值为 2

--compression <mode>

压缩模式。可选项为 nonezip(默认)或 tgz

--units <unit>

输出文件中使用的单位。可选单位为 mm(默认)或 in

PCB PDF 导出

pcb export pdf 命令将电路板设计导出为 PDF 文件。每个层可以单独导出为独立的文件,也可以作为单个文件中的一个页面进行导出。

Usage: kicad-cli pcb export pdf [--help] [--output OUTPUT_FILE] [--layers LAYER_LIST] [--drawing-sheet SHEET_PATH] [--define-var KEY=VALUE] [--mirror] [--exclude-refdes] [--exclude-value] [--include-border-title] [--subtract-soldermask] [--sketch-pads-on-fab-layers] [--hide-DNP-footprints-on-fab-layers] [--sketch-DNP-footprints-on-fab-layers] [--crossout-DNP-footprints-on-fab-layers] [--negative] [--black-and-white] [--theme THEME_NAME] [--drill-shape-opt VAR] [--common-layers COMMON_LAYER_LIST] [--plot-invisible-text] [--mode-single] [--mode-separate] [--mode-multipage] INPUT_FILE

位置参数:

INPUT_FILE

导出电路板文件。

可选参数:

-h, --help

显示 PDF 导出命令的帮助信息。

-o <output filename>, --output <output filename>

输出文件名。当未使用此参数时,输出文件名将与输入文件相同,并带有 .pdf 文件扩展名。

-l <layer list>, --layers <layer list>

要从电路板导出的层名称的逗号分隔列表,例如 F.Cu,B.Cu。至少必须指定一个层。层名称可以指定为标准层名称(如 F.CuIn.1F.Fab 等)或用户自定义(自定义)层名称,但标准层名称将优先匹配。

--drawing-sheet <sheet path>

用于绘制的图纸路径,覆盖板文件中指定的图纸。

-D <variable name>=<value>, --define-var <variable_name>=<value>

添加或覆盖项目变量定义。可多次使用以定义多个变量。

-m, --mirror

镜像电路板。这对于显示底层电路非常有用。

--erd, --exclude-refdes

从绘制中排除封装位号。

--ev, --exclude-value

从绘制中排除封装值。

--ibt, --include-border-title

包含图纸边框和标题栏。

--subtract-soldermask

从没有阻焊层的区域去除丝印。

--sp, --sketch-pads-on-fab-layers

在正面和背面 Fab 层上绘制焊盘轮廓及其编号。

--hdnp, --hide-DNP-footprints-on-fab-layers

不要在 Fab 层上绘制 DNP 封装的文本和图形。

--sdnp, --sketch-DNP-footprints-on-fab-layers

在 Fab 层上以草图模式绘制 DNP 封装的图形。

--cdnp, --crossout-DNP-footprints-on-fab-layers

在 Fab 层上的 DNP 封装的外框上画一个 "X",并划掉其位号。

-n, --negative

在负片上绘制。

--black-and-white

黑白绘制。

-t <theme name>, --theme <theme name>

用于导出的主题名称。如果未指定主题,则使用板编辑器当前选定的主题。

--drill-shape-opt

钻孔标记在图中的形状。选项包括:0 表示不显示钻孔标记,1 表示显示小标记,或 2 表示显示实际大小的标记(默认)。

--cl <layer list>, --common-layers <layer list>

以逗号分隔的图层名称列表,用于在所有图层上绘制,例如 F.Cu,B.Cu。图层名称可以指定为标准图层名称(如 F.CuIn.1F.Fab 等)或用户自定义(自定义)图层名称,但标准图层名称将优先匹配。

--plot-invisible-text

强制绘制值和位号,即使它们不可见。此参数自 KiCad 9.0.1起已废弃且无效。它将在未来版本的 KiCad 中被移除。要绘制不可见文本,请编辑电路板以使文本不再不可见。

--mode-single

生成一个单一文件,其中输出参数路径作为完整的目录和文件名路径。COMMON_LAYER_LIST 在此模式下不生效。相反,LAYER_LIST 控制所有绘制的图层。

--mode-separate

将图层分别保存为独立的 PDF 文件。

--mode-multipage

将各图层合并为一个包含多页的 PDF 文件。

PCB PLY 文件导出

pcb export ply 命令将电路板设计导出为 PLY 3D 模型文件。

Usage: kicad-cli pcb export ply [--help] [--output OUTPUT_FILE] [--define-var KEY=VALUE] [--force] [--no-unspecified] [--no-dnp] [--grid-origin] [--drill-origin] [--subst-models] [--board-only] [--cut-vias-in-body] [--no-board-body] [--no-components] [--component-filter VAR] [--include-tracks] [--include-pads] [--include-zones] [--include-inner-copper] [--include-silkscreen] [--include-soldermask] [--fuse-shapes] [--fill-all-vias] [--min-distance MIN_DIST] [--net-filter VAR] [--user-origin VAR] INPUT_FILE

位置参数:

INPUT_FILE

导出电路板文件。

可选参数:

-h, --help

显示 PLY 导出命令的帮助信息。

-o <output filename>, --output <output filename>

输出文件名。当未使用此参数时,输出文件名将与输入文件相同,并带有 .ply 文件扩展名。

-D <variable name>=<value>, --define-var <variable_name>=<value>

添加或覆盖项目变量定义。可多次使用以定义多个变量。

-f, --force

覆盖输出文件。

--no-unspecified

排除具有 “未指定” 封装类型的元件的 3D 模型。

--no-dnp

排除具有 “DNP” 属性的元件的 3D 模型。

--grid-origin

将网格原点作为输出文件的原点。

--drill-origin

将钻孔原点作为输出文件的原点。

--subst-models

如果存在同名的 STEP 或 IGS 模型,则用它们替换封装中的 VRML 模型。

--board-only

仅将电路板本身包含在生成的模型中;排除所有元件模型。

--cut-vias-in-body

即使导电层未导出,仍需在电路板本体上开孔。

--no-board-body

排除电路板主体。

--no-components

排除元件的 3D 模型。

--component-filter <reference designator list>

仅包含与以下位号列表匹配的元件 3D 模型(以逗号分隔,支持通配符)

--include-tracks

在导出时包含外层导电层上的布线和过孔(耗时)。

--include-pads

在导出时包含焊盘(耗时)。

--include-zones

在导出时包含敷铜(耗时)。

--include-inner-copper

在导出时包含内导体层中的元素。

--include-silkscreen

在导出时将丝印图形作为一组平面图形包含在内。

--include-soldermask

在导出时将阻焊层作为一组平面。

--fuse-shapes

在导出时将重叠的几何体合并在一起(耗时)。

--fill-all-vias

请勿通过导电层上的过孔进行切割。

--min-distance <min distance>

将两个点视为位于同一位置的误差。默认值:0.01mm

--net-filter <net filter>

仅包含与该通配符匹配的网络中的铜对象。

--user-origin <output origin>

指定输出文件的自定义原点,包括 X 和 Y 坐标。例如,1x1in1x1inch25.4x25.4mm。默认单位为毫米。

PCB 位置文件导出

pcb export pos 命令从电路板设计中导出位置文件。

Usage: kicad-cli pcb export pos [--help] [--output OUTPUT_FILE] [--side VAR] [--format FORMAT] [--units UNITS] [--bottom-negate-x] [--use-drill-file-origin] [--smd-only] [--exclude-fp-th] [--exclude-dnp] [--gerber-board-edge] INPUT_FILE

位置参数:

INPUT_FILE

导出电路板文件。

可选参数:

-h, --help

显示位置文件导出命令的帮助信息。

-o <output filename>, --output <output filename>

输出文件名。当未使用此参数时,输出文件名将与输入文件相同,并带有 .pos 文件扩展名。

--side <side>

要导出的电路板侧面。可选项为 front(正面)、back(背面)或 both(两面)(默认)。Gerber 格式不支持 both

--format <format>

位置文件格式。可选格式包括 ascii(默认)、csvgerber

--units <unit>

位置文件的单位。可选值为 in(默认)或 mm。此选项对 Gerber 格式无效。

--bottom-negate-x

在底层的封装中使用负 X 坐标。此选项对 Gerber 格式无效。

--use-drill-file-origin

使用钻孔/放置文件原点而非绝对原点。此选项对 Gerber 格式无效。

--smd-only

仅包含表面贴装元件。此选项对 Gerber 格式无效。

--exclude-fp-th

排除所有带有通孔焊盘的焊盘。此选项对 Gerber 格式无效。

--exclude-dnp

排除所有具有 “DNP” 属性的封装。

--gerber-board-edge

在导出时包含电路板边缘层(仅限 Gerber 格式)。

PCB STEP 导出

pcb export step 命令将电路板设计导出为 STEP 文件。

Usage: kicad-cli pcb export step [--help] [--output OUTPUT_FILE] [--define-var KEY=VALUE] [--force] [--no-unspecified] [--no-dnp] [--grid-origin] [--drill-origin] [--subst-models] [--board-only] [--cut-vias-in-body] [--no-board-body] [--no-components] [--component-filter VAR] [--include-tracks] [--include-pads] [--include-zones] [--include-inner-copper] [--include-silkscreen] [--include-soldermask] [--fuse-shapes] [--fill-all-vias] [--min-distance MIN_DIST] [--net-filter VAR] [--no-optimize-step] [--user-origin VAR] INPUT_FILE

位置参数:

INPUT_FILE

导出电路板文件。

可选参数:

-h, --help

pcb export gerbers 命令将电路板设计导出为 Gerber 文件,每个文件对应一层。显示 STEP 文件导出命令的帮助信息。

-o <output filename>, --output <output filename>

输出文件名。当未使用此参数时,输出文件名将与输入文件相同,并带有`.step`文件扩展名。

-D <variable name>=<value>, --define-var <variable_name>=<value>

添加或覆盖项目变量定义。可多次使用以定义多个变量。

-f, --force

覆盖输出文件。

--no-unspecified

排除具有 “未指定” 封装类型的元件的 3D 模型。

--no-dnp

排除具有 “DNP” 属性的元件的 3D 模型。

--grid-origin

将网格原点作为输出文件的原点。

--drill-origin

将钻孔原点作为输出文件的原点。

--subst-models

如果存在同名的 STEP 或 IGS 模型,则用它们替换封装中的 VRML 模型。

--board-only

仅将电路板本身包含在生成的模型中;排除所有元件模型。

--cut-vias-in-body

即使导电层未导出,仍需在电路板本体上开孔。

--no-board-body

排除电路板主体。

--no-components

排除元件的 3D 模型。

--component-filter <reference designator list>

仅包含与以下位号列表匹配的元件 3D 模型(以逗号分隔,支持通配符)

--include-tracks

在导出时包含外层导电层上的布线和过孔(耗时)。

--include-pads

在导出时包含焊盘(耗时)。

--include-zones

在导出时包含敷铜(耗时)。

--include-inner-copper

在导出时包含内导体层中的元素。

--include-silkscreen

在导出时将丝印图形作为一组平面图形包含在内。

--include-soldermask

在导出时将阻焊层作为一组平面。

--fuse-shapes

在导出时将重叠的几何体合并在一起(耗时)。

--fill-all-vias

请勿通过导电层上的过孔进行切割。

--min-distance <min distance>

将两个点视为位于同一位置的误差。默认值:0.01mm

--net-filter <net filter>

仅包含与该通配符匹配的网络中的铜对象。

--no-optimize-step

请勿优化 STEP 文件。此操作可实现参数化曲线的写入,从而减少文件大小并缩短写入/读取时间,但可能降低与其他软件的兼容性。

--user-origin <output origin>

指定输出文件的自定义原点,包括 X 和 Y 坐标。例如,1x1in1x1inch25.4x25.4mm。默认单位为毫米。

PCB STL 导出

pcb export stl 命令将电路板设计导出为 STL 3D 模型文件。

Usage: kicad-cli pcb export stl [--help] [--output OUTPUT_FILE] [--define-var KEY=VALUE] [--force] [--no-unspecified] [--no-dnp] [--grid-origin] [--drill-origin] [--subst-models] [--board-only] [--cut-vias-in-body] [--no-board-body] [--no-components] [--component-filter VAR] [--include-tracks] [--include-pads] [--include-zones] [--include-inner-copper] [--include-silkscreen] [--include-soldermask] [--fuse-shapes] [--fill-all-vias] [--min-distance MIN_DIST] [--net-filter VAR] [--user-origin VAR] INPUT_FILE

位置参数:

INPUT_FILE

导出电路板文件。

可选参数:

-h, --help

显示 STL 导出命令的帮助信息。

-o <output filename>, --output <output filename>

输出文件名。当未使用此参数时,输出文件名将与输入文件相同,并带有 .stl 文件扩展名。

-D <variable name>=<value>, --define-var <variable_name>=<value>

添加或覆盖项目变量定义。可多次使用以定义多个变量。

-f, --force

覆盖输出文件。

--no-unspecified

排除具有 “未指定” 封装类型的元件的 3D 模型。

--no-dnp

排除具有 “DNP” 属性的元件的 3D 模型。

--grid-origin

将网格原点作为输出文件的原点。

--drill-origin

将钻孔原点作为输出文件的原点。

--subst-models

如果存在同名的 STEP 或 IGS 模型,则用它们替换封装中的 VRML 模型。

--board-only

仅将电路板本身包含在生成的模型中;排除所有元件模型。

--cut-vias-in-body

即使导电层未导出,仍需在电路板本体上开孔。

--no-board-body

排除电路板主体。

--no-components

排除元件的 3D 模型。

--component-filter <reference designator list>

仅包含与以下位号列表匹配的元件 3D 模型(以逗号分隔,支持通配符)

--include-tracks

在导出时包含外层导电层上的布线和过孔(耗时)。

--include-pads

在导出时包含焊盘(耗时)。

--include-zones

在导出时包含敷铜(耗时)。

--include-inner-copper

在导出时包含内导体层中的元素。

--include-silkscreen

在导出时将丝印图形作为一组平面图形包含在内。

--include-soldermask

在导出时将阻焊层作为一组平面。

--fuse-shapes

在导出时将重叠的几何体合并在一起(耗时)。

--fill-all-vias

请勿通过导电层上的过孔进行切割。

--min-distance <min distance>

将两个点视为位于同一位置的误差。默认值:0.01mm

--net-filter <net filter>

仅包含与该通配符匹配的网络中的铜对象。

--user-origin <output origin>

指定输出文件的自定义原点,包括 X 和 Y 坐标。例如,1x1in1x1inch25.4x25.4mm。默认单位为毫米。

PCB SVG 导出

pcb export svg 命令将电路板设计导出为 SVG 文件。

Usage: kicad-cli pcb export svg [--help] [--output OUTPUT_FILE] [--layers LAYER_LIST] [--drawing-sheet SHEET_PATH] [--define-var KEY=VALUE] [--subtract-soldermask] [--mirror] [--theme THEME_NAME] [--negative] [--black-and-white] [--sketch-pads-on-fab-layers] [--hide-DNP-footprints-on-fab-layers] [--sketch-DNP-footprints-on-fab-layers] [--crossout-DNP-footprints-on-fab-layers] [--page-size-mode MODE] [--fit-page-to-board] [--exclude-drawing-sheet] [--drill-shape-opt SHAPE_OPTION] [--common-layers COMMON_LAYER_LIST] [--mode-single] [--mode-multi] [--plot-invisible-text] INPUT_FILE

位置参数:

INPUT_FILE

导出电路板文件。

可选参数:

-h, --help

显示 SVG 文件导出命令的帮助信息。

-o <output filename>, --output <output filename>

输出文件名。当未使用此参数时,输出文件名将与输入文件相同,并带有 .svg 文件扩展名。

-l <layer list>, --layers <layer list>

要从电路板导出的层名称的逗号分隔列表,例如 F.Cu,B.Cu。至少必须指定一个层。层名称可以指定为标准层名称(如 F.CuIn.1F.Fab 等)或用户自定义(自定义)层名称,但标准层名称将优先匹配。

--drawing-sheet <sheet path>

用于绘制的图纸路径,覆盖板文件中指定的图纸。

-D <variable name>=<value>, --define-var <variable_name>=<value>

添加或覆盖项目变量定义。可多次使用以定义多个变量。

--subtract-soldermask

从没有阻焊层的区域去除丝印。

-m, --mirror

镜像电路板。这对于显示底层电路非常有用。

-t <theme name>, --theme <theme name>

用于导出的主题名称。如果未指定主题,则使用板编辑器当前选定的主题。

-n, --negative

在负片上绘制。

--black-and-white

黑白绘制。

--sp, --sketch-pads-on-fab-layers

在正面和背面 Fab 层上绘制焊盘轮廓及其编号。

--hdnp, --hide-DNP-footprints-on-fab-layers

不要在 Fab 层上绘制 DNP 封装的文本和图形。

--sdnp, --sketch-DNP-footprints-on-fab-layers

在 Fab 层上以草图模式绘制 DNP 封装的图形。

--cdnp, --crossout-DNP-footprints-on-fab-layers

在 Fab 层上的 DNP 封装的外框上画一个 "X",并划掉其位号。

--page-size-mode <mode>

设置页面尺寸模式。选项为 0(默认)、120 将输出页面尺寸设置为适合整个图纸,包括图框和标题框。1 将输出页面尺寸设置为与当前页面尺寸相匹配。2 将输出页面尺寸设置为图纸本身的尺寸。

--fit-page-to-board

将 SVG 大小设置为与电路板外框匹配。这相当于 --page-size-mode 2

--exclude-drawing-sheet

在没有图框的情况下绘制 SVG。

--drill-shape-opt

钻孔标记在图中的形状。选项包括:0 表示不显示钻孔标记,1 表示显示小标记,或 2 表示显示实际大小的标记(默认)。

--cl <layer list>, --common-layers <layer list>

以逗号分隔的图层名称列表,用于在所有图层上绘制,例如 F.Cu,B.Cu。图层名称可以指定为标准图层名称(如 F.CuIn.1F.Fab 等)或用户自定义(自定义)图层名称,但标准图层名称将优先匹配。

--mode-single

生成一个单一文件,其中输出参数路径作为完整的目录和文件名路径。COMMON_LAYER_LIST 在此模式下不生效。相反,LAYER_LIST 控制所有绘制的图层。

--mode-multi

生成一个或多个与 KiCad 图形用户界面(GUI)绘制功能类似的文件。指定的输出路径用于指定一个目录,用于存放生成的文件。

--plot-invisible-text

强制绘制值和位号,即使它们不可见。此参数自 KiCad 9.0.1起已废弃且无效。它将在未来版本的 KiCad 中被移除。要绘制不可见文本,请编辑电路板以使文本不再不可见。

PCB VRML 导出

pcb export vrml 命令将电路板设计导出为 VRML 3D 文件。

Usage: kicad-cli pcb export vrml [--help] [--output OUTPUT_FILE] [--define-var KEY=VALUE] [--force] [--no-unspecified] [--no-dnp] [--user-origin VAR] [--units VAR] [--models-dir VAR] [--models-relative] INPUT_FILE

位置参数:

INPUT_FILE

导出电路板文件。

可选参数:

-h, --help

显示 VRML 导出命令的帮助信息。

-o <output filename>, --output <output filename>

输出文件名。当未使用此参数时,输出文件名将与输入文件相同,并带有 .wrl 文件扩展名。

-D <variable name>=<value>, --define-var <variable_name>=<value>

添加或覆盖项目变量定义。可多次使用以定义多个变量。

-f, --force

覆盖输出文件。

--no-unspecified

排除具有 “未指定” 封装类型的元件的 3D 模型。

--no-dnp

排除具有 “DNP” 属性的元件的 3D 模型。

--user-origin <output origin>

指定输出文件的自定义原点,包括 X 和 Y 坐标。例如,1x1in1x1inch25.4x25.4mm。默认单位为毫米。如果未指定此选项,则使用电路板中心作为原点。

--units <units>

输出文件中使用的单位。可选单位包括 mmmin(默认)或 tenths(英寸的十分之一)。

--models-dir <output model directory>

输出目录的名称,用于复制组件模型。如果未指定,组件模型将嵌入到输出文件中。

--models-relative

使用 --models-dir 时,输出文件中使用相对路径。

PCB XAO 导出

pcb export xao 命令将电路板设计导出为 XAO(SALOME/Gmsh)3D 模型文件。

Usage: kicad-cli pcb export xao [--help] [--output OUTPUT_FILE] [--define-var KEY=VALUE] [--force] [--no-unspecified] [--no-dnp] [--grid-origin] [--drill-origin] [--subst-models] [--board-only] [--cut-vias-in-body] [--no-board-body] [--no-components] [--component-filter VAR] [--include-tracks] [--include-pads] [--include-zones] [--include-inner-copper] [--include-silkscreen] [--include-soldermask] [--fuse-shapes] [--fill-all-vias] [--min-distance MIN_DIST] [--net-filter VAR] [--user-origin VAR] INPUT_FILE

位置参数:

INPUT_FILE

导出电路板文件。

可选参数:

-h, --help

显示 XAO 导出命令的帮助信息。

-o <output filename>, --output <output filename>

输出文件名。当未使用此参数时,输出文件名将与输入文件相同,并带有 .xao 文件扩展名。

-D <variable name>=<value>, --define-var <variable_name>=<value>

添加或覆盖项目变量定义。可多次使用以定义多个变量。

-f, --force

覆盖输出文件。

--no-unspecified

排除具有 “未指定” 封装类型的元件的 3D 模型。

--no-dnp

排除具有 “DNP” 属性的元件的 3D 模型。

--grid-origin

将网格原点作为输出文件的原点。

--drill-origin

将钻孔原点作为输出文件的原点。

--subst-models

如果存在同名的 STEP 或 IGS 模型,则用它们替换封装中的 VRML 模型。

--board-only

仅将电路板本身包含在生成的模型中;排除所有元件模型。

--cut-vias-in-body

即使导电层未导出,仍需在电路板本体上开孔。

--no-board-body

排除电路板主体。

--no-components

排除元件的 3D 模型。

--component-filter <reference designator list>

仅包含与以下位号列表匹配的元件 3D 模型(以逗号分隔,支持通配符)

--include-tracks

在导出时包含外层导电层上的布线和过孔(耗时)。

--include-pads

在导出时包含焊盘(耗时)。

--include-zones

在导出时包含敷铜(耗时)。

--include-inner-copper

在导出时包含内导体层中的元素。

--include-silkscreen

在导出时将丝印图形作为一组平面图形包含在内。

--include-soldermask

在导出时将阻焊层作为一组平面。

--fuse-shapes

在导出时将重叠的几何体合并在一起(耗时)。

--fill-all-vias

请勿通过导电层上的过孔进行切割。

--min-distance <min distance>

将两个点视为位于同一位置的误差。默认值:0.01mm

--net-filter <net filter>

仅包含与该通配符匹配的网络中的铜对象。

--user-origin <output origin>

指定输出文件的自定义原点,包括 X 和 Y 坐标。例如,1x1in1x1inch25.4x25.4mm。默认单位为毫米。

PCB 渲染

pcb render 命令会生成电路板 3D 模型的光线追踪渲染图,并将其保存为 PNG 或 JPEG 文件。

Usage: kicad-cli pcb render [--help] [--output OUTPUT_FILE] [--define-var KEY=VALUE] [--width WIDTH] [--height HEIGHT] [--side SIDE] [--background BG] [--quality QUALITY] [--preset PRESET] [--floor] [--perspective] [--zoom ZOOM] [--pan VECTOR] [--pivot PIVOT] [--rotate ANGLES] [--light-top COLOR] [--light-bottom COLOR] [--light-side COLOR] [--light-camera COLOR] [--light-side-elevation ANGLE] INPUT_FILE

位置参数:

INPUT_FILE

渲染电路板文件。

可选参数:

-h, --help

显示渲染命令的帮助信息。

-o <output filename>, --output <output filename>

输出文件名。此参数必须指定。此参数中指定的文件扩展名决定了输出图像文件的格式。文件名必须以 .png(用于 PNG 文件)或 .jpg/.jpeg(用于 JPG 文件)结尾。

-D <variable name>=<value>, --define-var <variable_name>=<value>

添加或覆盖项目变量定义。可多次使用以定义多个变量。

-w <width>, --width <width>

图像宽度(以像素为单位)。默认值:1600

-h <height>, --height <height>

图像高度(以像素为单位)。默认值:900

--side <side>

要渲染的板面。可选项包括 top(默认)、bottomleftrightfrontback

--background <background>

图像背景。可选项为 default(默认)、transparentopaque。对于 PNG 文件,default 默认为 transparent。对于 JPG 文件, default 默认为 opaque

--quality <quality>

渲染质量。可选项包括 base(默认)、highuser。当指定 user 时,将使用项目中存储的渲染设置。

--preset <color preset>

颜色预设。可选项包括 follow_pcb_editorfollow_plot_settings(默认)或 legacy_preset_flag

--floor

启用地面、阴影和后期处理效果,即使在质量预设中已禁用。

--perspective

使用透视投影而非正交投影。

--zoom <zoom level>

相机变焦倍数,以整数形式表示。默认值:1

--pan <camera pan>

设置摄像头平移位置,单位为毫米,格式为 'X,Y,Z',例如 '3,0,0'

--pivot <pivot>

将枢轴点相对于板中心的位置以厘米为单位设置,格式为’X,Y,Z'`,例如’-10,2,0'`。

--rotate <rotation>

设置板面绕枢轴点的旋转角度,单位为度,格式为 'X,Y,Z',例如 '-45,0,45' 用于等轴测视图。

--light-top <intensity>

顶部光强度,格式为 'R,G,B' 或单个数字,范围:0-1。

--light-bottom <intensity>

底部光强度,格式为 'R,G,B' 或单个数字,范围:0-1。

--light-side <intensity>

侧灯亮度,格式为 'R,G,B' 或单个数字,范围:0-1。

--light-camera <intensity>

相机光线强度,格式为 'R,G,B' 或单个数字,范围:0-1。

--light-side-elevation <elevation>

侧灯仰角(单位:度),范围:0-90。

原理图命令

sch 命令可运行电气规则检查、将原理图导出为各种其他文件格式,或导出 BOM 或网表。每个子命令都有自己的选项。

原理图 ERC

sch erc 命令对原理图进行电气规则检查并生成报告。

Usage: kicad-cli sch erc [--help] [--output OUTPUT_FILE] [--define-var KEY=VALUE] [--format VAR] [--units VAR] [--severity-all] [--severity-error] [--severity-warning] [--severity-exclusions] [--exit-code-violations] INPUT_FILE

位置参数:

INPUT_FILE

运行 ERC 的原理图文件。

可选参数:

-h, --help

显示 ERC 命令的帮助信息。

-o <output filename>, `--output <output filename>

生成的 ERC 报告的输出文件名。当未使用此参数时,输出文件名将与输入文件相同,文件扩展名根据所选格式不同,分别为 .rpt.json

-D <variable name>=<value>, --define-var <variable_name>=<value>

添加或覆盖项目变量定义。可多次使用以定义多个变量。

--format <format>

报告文件格式。可选格式为 report(默认)或 json

--units <unit>

报告中使用的单位。可选单位包括 mm(默认)、inmils

--severity-all

报告所有 ERC 违规行为。这相当于使用所有其他 ERC 严重性选项。

--severity-error

报告所有错误级别的 ERC 违规行为。这可以与其他 ERC 严重性选项结合使用。

--severity-warning

报告所有警告级别的 ERC 违规行为。这可以与其他 ERC 严重性选项结合使用。

--severity-exclusions

报告所有被排除的 ERC 违规行为。这可以与其他 ERC 严重性选项结合使用。

--exit-code-violations

根据是否存在 ERC 违规情况返回退出代码。如果未发现违规,退出代码为 0;如果发现任何违规,退出代码为 5。

原理图 BOM 导出

sch export bom 命令从原理图导出 BOM。BOM 导出有多个选项可用于控制格式和包含的字段。此导出方法相当于从符号字段表导出 BOM (导出 BOM)。

要使用旧版 XML 和 Python BOM 脚本工作流导出 BOM,请使用 sch export python-bom 命令。

Usage: kicad-cli sch export bom [--help] [--output OUTPUT_FILE] [--preset PRESET] [--format-preset FMT_PRESET] [--fields FIELDS] [--labels LABELS] [--group-by GROUP_BY] [--sort-field SORT_BY] [--sort-asc] [--filter FILTER] [--exclude-dnp] [--include-excluded-from-bom] [--field-delimiter FIELD_DELIM] [--string-delimiter STR_DELIM] [--ref-delimiter REF_DELIM] [--ref-range-delimiter REF_RANGE_DELIM] [--keep-tabs] [--keep-line-breaks] INPUT_FILE

位置参数:

INPUT_FILE

导出原理图文件。

可选参数:

-h, --help

显示帮助信息并退出

-o <output filename>, --output <output filename>

输出文件名。当未使用此参数时,输出文件名将与输入文件相同,并带有 .csv 文件扩展名。

--preset <preset>

使用原理图中的命名 BOM 预设设置,例如 按值分组

--format-preset <format preset>

使用原理图中的命名 BOM 格式预设设置,例如 CSV

--fields <fields>

要导出的字段的有序列表。* 表示导出所有字段。特殊符号字段(如 DNP 或 Exclude from board)可分别通过 ${DNP}${EXCLUDE_FROM_BOARD} 访问(参见 文本变量文档 以获取字段列表)。默认值:"Reference、Value、Footprint、${QUANTITY}、${DNP}"。

--labels <labels>

应用导出字段的标签有序列表(默认值:"Refs,Value,Footprint,Qty,DNP")。

--group-by <fields>

当字段值匹配时,用于按字段分组引用。

--sort-field <fields>

按字段名称排序(默认:"Reference")。

--sort-asc

如果指定了排序方式,则按升序排序。如果未指定排序方式,则按降序排序。

--filter <filter>

过滤字符串以移除输出行。

--exclude-dnp

排除具有 "DNP" 性的符号。

--include-excluded-from-bom

包含标记为 “从 BOM 中排除” 的符号。

--field-delimiter <delimiter>

输出字段/列之间的分隔符(默认:",")。

--string-delimiter <delimiter>

用于包围字段的字符(默认为空)。

--ref-delimiter <delimiter>

用于分隔各个位号之间的字符(默认:",")。

--ref-range-delimiter <delimiter>

用于指定位号范围的字符(默认值:"-")。若不指定范围,请留空。

--keep-tabs

保留输入字段中的制表符。默认情况下会被移除。

--keep-line-breaks

保留输入字段中的换行符。默认情况下会被移除。

原理图 DXF 导出

命令 sch export dxf 将原理图导出到 DXF 文件。设计中的每张图纸都会导出到各自的文件中。

Usage: kicad-cli sch export dxf [--help] [--output OUTPUT_DIR] [--drawing-sheet SHEET_PATH] [--define-var KEY=VALUE] [--theme THEME_NAME] [--black-and-white] [--exclude-drawing-sheet] [--default-font VAR] [--pages PAGE_LIST] INPUT_FILE

位置参数:

INPUT_FILE

导出原理图文件。

可选参数:

-h, --help

显示 DXF 文件导出命令的帮助信息。

-o <output dir>, --output <output dir>

导出文件的输出文件夹。当未使用此参数时,文件将导出到当前目录。

--drawing-sheet <sheet path>

用于绘图的图框路径,覆盖原理图文件中指定的图框。

-D <variable name>=<value>, --define-var <variable_name>=<value>

添加或覆盖项目变量定义。可多次使用以定义多个变量。

-t <theme name>, --theme <theme name>

用于导出的主题名称。如果未指定主题,则使用原理图编辑器当前选择的主题。

-b, --black-and-white

以黑白形式导出原理图。

-e, --exclude-drawing-sheet

在没有图框的情况下绘制 DXF。

--default-font <font name>

默认字体名称。默认值:"KiCad 字体"

-p <page list>, --pages <page list>

以逗号分隔的要导出的页面列表。空白或未指定表示所有页面。要绘制特定页面,请将根页面作为 INPUT_FILE 指定,并使用 --pages 参数指定所需的输出页面。

原理图 HPGL 导出

命令 sch export hpgl 将原理图导出到用于笔式绘图仪的 HPGL 文件。设计中的每张图纸都会导出到各自的文件中。

Usage: kicad-cli sch export hpgl [--help] [--output OUTPUT_DIR] [--drawing-sheet SHEET_PATH] [--define-var KEY=VALUE] [--exclude-drawing-sheet] [--default-font VAR] [--pages PAGE_LIST] [--pen-size PEN_SIZE] [--origin ORIGIN] INPUT_FILE

位置参数:

INPUT_FILE

导出原理图文件。

可选参数:

-h, --help

显示 HPGL 文件导出命令的帮助信息。

-o <output dir>, --output <output dir>

导出文件的输出文件夹。当未使用此参数时,文件将导出到当前目录。

--drawing-sheet <sheet path>

用于绘图的图框路径,覆盖原理图文件中指定的图框。

-D <variable name>=<value>, --define-var <variable_name>=<value>

添加或覆盖项目变量定义。可多次使用以定义多个变量。

-e, --exclude-drawing-sheet

无需图框即可绘制 HPGL。

--default-font <font name>

默认字体名称。默认值:"KiCad 字体"

--pages <page list>

以逗号分隔的要导出的页面列表。空白或未指定表示所有页面。要绘制特定页面,请将根页面作为 INPUT_FILE 指定,并使用 --pages 参数指定所需的输出页面。

-p <pen size>, --pen-size <pen size>

设置笔宽。默认笔宽为 0.5mm。

-r <origin>, --origin <origin>

设置绘图仪原点和比例。可选值为 01(默认)、230 将原点设置为左下角并使用绘图仪单位。1 将原点设置为中心并使用绘图仪单位。2 缩放至页面,3 缩放至页面内的内容。

原理图网表导出

命令 sch export netlist 将原理图中的网表以 各种格式 导出。

Usage: kicad-cli sch export netlist [--help] [--output OUTPUT_FILE] [--format FORMAT] INPUT_FILE

位置参数:

INPUT_FILE

导出原理图文件。

可选参数:

-h, --help

显示网表导出命令的帮助信息。

-o <output filename>, --output <output filename>

输出文件名。当未使用此参数时,输出文件名将与输入文件相同,但文件扩展名为 .net

-f <format>, --format <format>

网表输出格式。可选格式包括 kicadsexpr(默认)、kicadxmlcadstarorcadpcb2spicespicemodelpadsallegro

原理图 PDF 导出

sch export pdf 命令将原理图导出到 PDF 文件。设计中的每个图纸都会导出到 PDF 文件中的单独页面。

Usage: kicad-cli sch export pdf [--help] [--output OUTPUT_FILE] [--drawing-sheet SHEET_PATH] [--define-var KEY=VALUE] [--theme THEME_NAME] [--black-and-white] [--exclude-drawing-sheet] [--default-font VAR] [--exclude-pdf-property-popups] [--exclude-pdf-hierarchical-links] [--exclude-pdf-metadata] [--no-background-color] [--pages PAGE_LIST] INPUT_FILE

位置参数:

INPUT_FILE

导出原理图文件。

可选参数:

-h, --help

显示 PDF 文件导出命令的帮助信息。

-o <output filename>, --output <output filename>

输出文件名。当未使用此参数时,输出文件名将与输入文件相同,并带有 .pdf 文件扩展名。

--drawing-sheet <sheet path>

用于绘图的图框路径,覆盖原理图文件中指定的图框。

-D <variable name>=<value>, --define-var <variable_name>=<value>

添加或覆盖项目变量定义。可多次使用以定义多个变量。

-t <theme name>, --theme <theme name>

用于导出的主题名称。如果未指定主题,则使用原理图编辑器当前选择的主题。

-b, --black-and-white

以黑白形式导出原理图。

-e, --exclude-drawing-sheet

绘制无图框的 PDF。

--default-font <font name>

默认字体名称。默认值:"KiCad 字体"

--exclude-pdf-property-popups

请勿在 PDF 中生成属性弹出窗口。

--exclude-pdf-hierarchical-links

请勿为 PDF 中的层次结构元素生成可点击链接。

--exclude-pdf-metadata

请勿从 “作者” 和 “主题” 变量生成 PDF 元数据。

-n, --no-background-color

无论主题如何,均以无背景色的形式导出原理图。

-p <page list>, --pages <page list>

以逗号分隔的要导出的页面列表。空白或未指定表示所有页面。要绘制特定页面,请将根页面作为 INPUT_FILE 指定,并使用 --pages 参数指定所需的输出页面。

原理图 PostScript 导出

命令 sch export ps 将原理图导出到 PostScript 文件。设计中的每个图纸都会导出到各自的文件中。

Usage: kicad-cli sch export ps [--help] [--output OUTPUT_DIR] [--drawing-sheet SHEET_PATH] [--define-var KEY=VALUE] [--theme THEME_NAME] [--black-and-white] [--exclude-drawing-sheet] [--default-font VAR] [--no-background-color] [--pages PAGE_LIST] INPUT_FILE

位置参数:

INPUT_DIR

导出原理图文件。

可选参数:

-h, --help

显示 PS 文件导出命令的帮助信息。

-o <output dir>, --output <output dir>

导出文件的输出文件夹。当未使用此参数时,文件将导出到当前目录。

--drawing-sheet <sheet path>

用于绘图的图框路径,覆盖原理图文件中指定的图框。

-D <variable name>=<value>, --define-var <variable_name>=<value>

添加或覆盖项目变量定义。可多次使用以定义多个变量。

-t <theme name>, --theme <theme name>

用于导出的主题名称。如果未指定主题,则使用原理图编辑器当前选择的主题。

-b, --black-and-white

以黑白形式导出原理图。

-e, --exclude-drawing-sheet

在没有图框的情况下绘制 PS。

--default-font <font name>

默认字体名称。默认值:"KiCad 字体"

-n, --no-background-color

无论主题如何,均以无背景色的形式导出原理图。

-p <page list>, --pages <page list>

以逗号分隔的要导出的页面列表。空白或未指定表示所有页面。要绘制特定页面,请将根页面作为 INPUT_FILE 指定,并使用 --pages 参数指定所需的输出页面。

原理图 BOM 导出(旧版 BOM 脚本)

命令 sch export python-bom 可从原理图导出 XML BOM 文件。然后,可使用自定义脚本或 原理图 BOM 导出文档 中描述的脚本之一,将 XML BOM 文件处理成所需的 BOM 格式。

Usage: kicad-cli sch export python-bom [--help] [--output OUTPUT_FILE] INPUT_FILE

位置参数:

INPUT_FILE

导出原理图文件。

可选参数:

-h, --help

显示 BOM 导出命令的帮助信息。

-o <output filename>, --output <output filename>

输出文件名。当未使用此参数时,输出文件名将与输入文件相同,并添加 -bom.xml 后缀和文件扩展名。

原理图 SVG 导出

命令 sch export svg 将原理图导出到 SVG 文件。设计中的每个图纸都会导出到各自的文件中。

Usage: kicad-cli sch export svg [--help] [--output OUTPUT_DIR] [--drawing-sheet SHEET_PATH] [--define-var KEY=VALUE] [--theme THEME_NAME] [--black-and-white] [--exclude-drawing-sheet] [--default-font VAR] [--no-background-color] [--pages PAGE_LIST] INPUT_FILE

位置参数:

INPUT_FILE

导出原理图文件。

可选参数:

-h, --help

显示 SVG 文件导出命令的帮助信息。

-o <output dir>, --output <output dir>

导出文件的输出文件夹。当未使用此参数时,文件将导出到当前目录。

--drawing-sheet <sheet path>

用于绘图的图框路径,覆盖原理图文件中指定的图框。

-D <variable name>=<value>, --define-var <variable_name>=<value>

添加或覆盖项目变量定义。可多次使用以定义多个变量。

-t <theme name>, --theme <theme name>

用于导出的主题名称。如果未指定主题,则使用原理图编辑器当前选择的主题。

-b, --black-and-white

以黑白形式导出原理图。

-e, --exclude-drawing-sheet

在没有图框的情况下绘制 SVG。

--default-font <font name>

默认字体名称。默认值:"KiCad 字体"

-n, --no-background-color

无论主题如何,均以无背景色的形式导出原理图。

-p <page list>, --pages <page list>

以逗号分隔的要导出的页面列表。空白或未指定表示所有页面。要绘制特定页面,请将根页面作为 INPUT_FILE 指定,并使用 --pages 参数指定所需的输出页面。

符号命令

sym 子命令用于将符号导出到另一种格式,或将符号库升级到 KiCad 符号文件格式的当前版本。

符合导出

sym export svg 命令将指定库中的一个或多个符号导出为 SVG 文件。

Usage: kicad-cli sym export svg [--help] [--output OUTPUT_DIR] [--theme THEME_NAME] [--symbol SYMBOL] [--black-and-white] [--include-hidden-pins] [--include-hidden-fields] INPUT_FILE

位置参数:

INPUT_FILE

用于导出的符号库文件。

可选参数:

-h, --help

显示 SVG 导出命令的帮助信息。

-o <output dir>, --output <output dir>

导出文件的输出文件夹。当未使用此参数时,文件将导出到当前目录。

-t <theme name>, --theme <theme name>

用于导出的主题名称。如果未指定主题,则使用符号编辑器当前选定的主题。

-s <symbol name>, --symbol <symbol name>

从库中导出的具体符号。当未使用此参数时,库中的所有符号均会被导出。

--black-and-white

以黑白形式导出符号。

--include-hidden-pins

在导出的 SVG 中导出隐藏引脚。

--include-hidden-fields

在导出的 SVG 文件中导出隐藏的符号字段。

符号升级

sym upgrade 命令将指定的符号库从旧版 KiCad 符号格式或非 KiCad 符号格式转换为当前版本 KiCad 的原生格式。如果输入库已采用当前文件格式,则不执行任何操作。

支持的输入符号格式包括:

  • KiCad 符号库(.kicad_sym

  • KiCad(6.0之前版本)符号库(.lib

  • Altium 原理图库(.SchLib

  • Altium 集成库 (.IntLib)

  • CADSTAR 元件库(.lib

  • EAGLE XML 库 (.lbr)

  • EasyEDA (JLCEDA) 标准版文件 (.json)

  • EasyEDA (JLCEDA) 专业版文件 (.elibz, .epro, .zip)

Usage: kicad-cli sym upgrade [--help] [--output OUTPUT_FILE] [--force] INPUT_FILE

位置参数:

INPUT_FILE

符号库升级。

可选参数:

-h, --help

显示符号升级命令的帮助信息。

-o <output filename>, --output <output filename>

升级后符号库的输出文件名。当未使用此参数时,升级后的符号库将覆盖原始库。

--force

即使输入库已采用当前文件格式,仍需重新保存该库。

版本命令

version 命令用于显示 KiCad 的版本信息。若不带任何参数,它将直接显示版本号,例如 7.0.7。您还可以通过使用 --format 参数以其他格式显示版本信息。

使用 kicad-cli version --format about 命令获取版本信息,并在提交 GitLab 上的 bug 报告或功能请求时包含此信息。

Usage: kicad-cli version [--help] [--format VAR]

可选参数:

--format <format>

版本号的格式。可选项包括 plain(默认)、commitaboutplain 显示版本号(例如 7.0.7),这是在未使用 --format 参数时的默认格式。commit 打印您正在使用的 KiCad 构建的 Git 提交哈希值。about 打印完整的版本信息,包括库版本和基本系统信息。您可以在错误报告中使用 about 版本信息。