用途:通过 KiCad 9.0 的命令行工具 kicad-cli 从 KiCad 工程生成制造、文档和 3D 输出,并运行电气与设计规则检查。命令分为 sch(原理图)、pcb(电路板)、sym(符号)、fp(封装)、jobset(批量作业集)和 version 六组。
主要能力:可导出 Gerbers、钻孔、贴装位置、PDF/SVG/DXF、STEP/GLB/VRML 等 3D 模型、IPC-2581/IPC-D-356/ODB++,以及原理图 PDF/SVG/BOM/网表;执行 pcb drc 与 sch erc 检查;导出符号/封装并升级库;用 jobset run 批量复现输出。
必要用法:先确认二进制并运行 kicad-cli version。macOS 路径为 /Applications/KiCad/KiCad.app/Contents/MacOS/kicad-cli,Linux 在 PATH,Windows 为 bin 目录下 kicad-cli.exe。示例:KCLI=$(command -v kicad-cli || echo /Applications/KiCad/KiCad.app/Contents/MacOS/kicad-cli);"$KCLI" version。使用具体命令的准确标志,不确定时运行 kicad-cli <group> <command> -h。目录型输出包含 pcb export gerbers、drill 与 */export svg,需先创建目录。用 --define-var KEY=VALUE(-D)覆盖工程文本变量,shell 中 ${QUANTITY} 等字段变量需用单引号保护。CI 无显示环境可用官方 kicad/kicad:9.0 Docker 镜像,或 Xvfb :99 -ac -nolisten tcp 后 export DISPLAY=:99。
限制:pcb drc 与 sch erc 默认即使存在违规也返回 0,必须加 --exit-code-violations 才会在发现违规时返回 5(其他非零为工具/IO 错误)。pcb export gerbers 用复数形式,单数 gerber 在 9.0 弃用、10.0 移除。JSON 格式字段名未正式文档化,解析前应生成样本检查,勿硬编码 schema。资料未提供收费、平台要求等更多信息。