TechOverflow Logo
TechOverflow

如何在命令行上初始化你的 KiCAD 6 项目

English Deutsch 简体中文

**注意：**本文适用于 KiCad 6，如果你使用 KiCAD 10（2026 年发布），请查看如何在命令行上初始化你的 KiCAD 10 项目。

太长不看

在你想创建项目的目录中，运行

kicad6-init.sh
wget -qO- https://techoverflow.net/scripts/kicad6-init.sh | bash /dev/stdin MyProject

你应该将 MyProject（在命令末尾）替换为你的项目名称。

*注意：*这将初始化一个没有任何库的空 KiCAD 项目。这等同于在 KiCAD 本身中（使用 GUI）创建新项目。

工作原理

我们的脚本是一个简单的 bash 脚本，它创建 KiCAD 手动创建新项目时创建的文件。

它将创建这些文件（MyProject 是默认项目名称，但你可以使用命令行参数修改它）：

这些文件以 KiCAD 5.1.4 为模型，但我们预计它们适用于任何最近的 KiCAD 版本。

kicad6-init.sh
#!/bin/bash
# TechOverflow KiCAD 项目初始化器（带项目 FP 和 SYM 库）
# 用法：$0 <文件名前缀>
if [ $# -ne 1 ]
then
    echo "Usage: $0 <filename prefix>"
    exit 1
fi

# 计算项目名称和路径
proj=$(basename "$1")
dir=$(dirname "$1")

# 创建项目文件
cat <<EOT > ${1}.pro
update=22/05/2015 07:44:53
version=1
last_client=kicad
[general]
version=1
RootSch=
BoardNm=
[pcbnew]
version=1
LastNetListRead=
UseCmpFile=1
PadDrill=0.600000000000
PadDrillOvalY=0.600000000000
PadSizeH=1.500000000000
PadSizeV=1.500000000000
PcbTextSizeV=1.500000000000
PcbTextSizeH=1.500000000000
PcbTextThickness=0.300000000000
ModuleTextSizeV=1.000000000000
ModuleTextSizeH=1.000000000000
ModuleTextSizeThickness=0.150000000000
SolderMaskClearance=0.000000000000
SolderMaskMinWidth=0.000000000000
DrawSegmentWidth=0.200000000000
BoardOutlineThickness=0.100000000000
ModuleOutlineThickness=0.150000000000
[cvpcb]
version=1
NetIExt=net
[eeschema]
version=1
LibDir=
[eeschema/libraries]
EOT

# 创建原理图文件
cat <<EOT > ${1}.kicad_sch
(kicad_sch (version 20211123) (generator eeschema)

  (uuid df87b081-37a2-452c-8581-7eff2c408a17)

  (paper "A4")

  (lib_symbols
  )

  (sheet_instances
    (path "/" (page "1"))
  )
)

EOT

cat <<EOT > ${1}.kicad_pcb
(kicad_pcb (version 4) (host kicad "dummy file") )
EOT

#
# 创建原理图符号库映射
#
mkdir -p ${dir}/libraries
cat <<EOT > ${dir}/sym-lib-table
(sym_lib_table
  (lib (name "${proj}")(type "KiCad")(uri "\${KIPRJMOD}/libraries/${proj}.kicad_sym")(options "")(descr ""))
)
EOT

cat <<EOT > ${dir}/libraries/${proj}.kicad_sym
(kicad_symbol_lib (version 20211014) (generator kicad_converter))
EOT

#
# 创建封装库映射（只是一个空目录）
#
mkdir -p ${dir}/libraries/footprints

cat <<EOT > ${dir}/fp-lib-table
(fp_lib_table
  (lib (name ${proj})(type KiCad)(uri \${KIPRJMOD}/libraries/footprints)(options "")(descr ""))
)
EOT

#
# 创建 3D 模型目录。
# 搜索路径可能需要手动配置
# 因为它不存储在项目中
#
mkdir -p ${dir}/libraries/3D

#
# 创建 .gitignore
#
cat <<EOT > .gitignore
*-bak
*-backups
*-cache*
*-bak*
_autosave*
\#auto_saved_files\#
EOT

例如使用以下命令运行

run_kicad6_init.sh
bash kicad6-init.sh MyProject
Check out similar posts by category: Electronics, KiCad, Shell