创建 LibrePCB 组件：开发者指南

在 LibrePCB 中创建自定义元器件：分步详解

LibrePCB 自带的默认元件库并不总能覆盖您所需的所有器件——例如非标连接器，或即插即用的 DC-DC 降压模块等。此时，自行设计专属元器件便是最高效的解决方案。整个流程需通过「库管理器」编辑本地库，并依次完成六大核心模块：元器件分类、原理图符号、元器件、封装分类、封装、器件。前三个模块决定该器件在原理图中的呈现方式；后三个则定义其在 PCB 上的实际物理布局。

分类体系搭建

首先打开「库管理器」：新建一个本地库，并切换至编辑模式（按 Ctrl+N 可快速添加新条目）。

以 DC-DC 模块为例，新建一个名为 _模块_ 的分类——区别于晶体管、电阻等标准分类。请将 根分类 字段留空，使其直接位于分类树顶层。保存后，请务必等待库完成全量重新索引（此步骤不可跳过，否则后续操作将无法识别新分类）。

同理，在 封装分类 下也新建一个 _模块_ 分类，用于统一归档所有面向板级装配的封装（Footprint）。

原理图符号设计

进入 符号 页面，选中您的 _模块_ 分类。使用内置原理图编辑器绘制简洁、对齐网格的图形：绘制矩形框体，标注清晰的输入/输出引脚（如 VIN、VOUT、GND），并添加必要文字说明。LibrePCB 会自动校验引脚电气连接逻辑，并在发现不一致时主动提示修正建议。

对于典型 DC-DC 模块，推荐采用简洁轮廓+明确电源与接地端子的表达方式。

元器件与封装构建

元器件 是连接原理图符号与真实物理器件的桥梁。命名应具描述性——例如「DC-DC 模块 5V」。同一符号可复用于多个变体（如不同输出电压或电流规格），每个变体均作为独立条目存在于此处。

在 封装 页面中定义物理焊盘布局：依据实测模块尺寸，精准放置焊盘。网格单位支持密耳（mil，1/1000 英寸）或毫米（mm）。

常用标准间距包括 100 mil（2.54 mm）、50 mil 及其整数倍。针对国产模块，毫米制更直观实用——避免使用 787.4 mil 这类换算尴尬值；建议就近取整为 750/800 mil 或 20 mm。

使用直尺测量焊盘中心距（孔距），再进行单位换算：

• 毫米 × 39.37 = 密耳 → 四舍五入至最近标准值。

示例 Perl 换算脚本：

#!/usr/bin/perl

print "请输入毫米数值，回车确认：\n> ";

while(my $str = <>){
  if($str =~ /([\d\.]+)/){
    my $mil = $1 * 39.37;
    printf("%.02f mm → %.02f mil\n", $1, $mil);
    print "> ";
  }
}

器件最终整合

在 器件 页面中创建最终可用的完整器件：将其归属至 _模块_ 分类，关联已设计好的符号与封装。保存后，该器件即刻出现在原理图编辑器中；拖入原理图后，系统将自动为其匹配并放置对应封装，确保 PCB 布局零误差。

实例：继电器器件应选择 _机电类器件_ 分类，分配继电器符号，并搭配基于密耳的封装（注意：先用毫米实测，再换算为密耳）。

关键实践准则

• 构建清晰的分类层级：_模块_ 作为顶层分类，专用于集成化功能模块，效果极佳；
• 每次修改库后，必须等待全量索引完成，方可继续下一步；
• 英制设计优先选用密耳（mil）保障精度；公制模块则统一使用毫米（mm）；
• 务必在符号与封装编辑器中启用错误校验功能，及时排查潜在问题；
• 一个完整的 器件，即实现了原理图逻辑与 PCB 物理布局的无缝融合，成为真正可复用、可交付的标准单元。

— Editorial Team