mcpField
J
jlcpcb

jlcpcb

github.com/aklofas其他1.5k789 次安装5 天前更新
代码仓库

关于 jlcpcb

用于通过 JLCPCB 准备 PCB 制造和组装订单的技能,涵盖 BOM 与贴片文件格式、设计限制、元件匹配,以及原型和量产订购流程。

主要功能

  1. 01JLCPCB BOM 格式指引
  2. 02BOM 与 CPL 转换流程
  3. 03制造设计规则参考
  4. 04组装限制与元件匹配
  5. 05原型及量产订购步骤

适用场景

  1. 01准备 KiCad 文件以便上传 PCBA
  2. 02制造前检查电路板规则
  3. 03按 BOM 筛选贴片文件元件
  4. 04规划裸板和钢网订单

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/aklofas/kicad-happy --skill jlcpcb

安装后在 Claude Code 中输入/jlcpcb确认已加载。

详细介绍

JLCPCB — PCB 制造与组装

JLCPCB 是一家位于中国深圳的 PCB 制造与组装服务商。它是 LCSC Electronics 的姐妹公司(由同一方持有),两者共用同一套元件库。

典型用法:原型制作期间,向 JLCPCB 订购裸板原型 PCB 和带框钢网(元件从 DigiKey/Mouser 单独采购,在实验室手工组装)。生产批次(数百片)则使用 LCSC 元件,向 JLCPCB 订购全组装电路板。PCBWay 是另一种组装方案。如需搜索元件,请参阅 lcsc 技能。如需管理 BOM、导出 gerber/CPL 和订购钢网,请参阅 bom 技能。

相关技能

技能用途
kicad读取/分析 KiCad 项目文件,根据 JLCPCB 的能力进行 DFM 评分
bomBOM 管理、gerber/CPL 导出、钢网订购
digikey搜索 DigiKey(原型元件采购,首选;也优先通过 API 下载数据手册)
mouser搜索 Mouser(原型元件采购,次选)
lcsc搜索 LCSC(生产元件采购;JLCPCB 使用 LCSC 元件库)
pcbwayPCB 制造与组装的替代方案
emcEMC 预合规风险分析——制造前运行,排查 EMC 问题
spiceSPICE 仿真——提交制造前验证模拟子电路

组装元件库

元件类别
类别描述组装费用
基础常见元件(电阻、电容、二极管、常见 IC),已装载到贴片机上无额外费用
扩展按需装载的 30 万多种较少见元件每种独特的扩展元件 $3

JLCPCB 偶尔会对部分常用扩展元件提供优惠,减免或免除供料器费用(该计划的名称和条款会随时间变化)。在假定适用标准 $3 费用之前,请查看 JLCPCB 当前的元件库页面,确认具体扩展元件的费用。

LCSC 元件编号

每个组装元件都由一个 LCSC 元件编号(Cxxxxx,例如 C14663)标识。这是 BOM 匹配时的权威标识符。搜索元件请参阅 lcsc 技能。

元件搜索(JLCPCB 专用)
  • 元件库:https://jlcpcb.com/parts/componentSearch?searchTxt=<query>
  • 仅基础元件:https://jlcpcb.com/parts/basic_parts

组装用 BOM 格式

JLCPCB 接受包含以下列的 CSV、XLS 或 XLSX 格式 BOM:

列必填描述
Comment / Value是元件值(例如 100nF、10k)
Designator是参考标号,以逗号分隔(例如 C1,C2,C5)
Footprint是封装/封装名称
LCSC Part #建议填写LCSC 元件编号(Cxxxxx)——确保精确匹配

LCSC 编号的列标题必须准确写为 "LCSC Part #" 或 "LCSC Part Number"——拼写错误会导致上传失败。

为 JLCPCB 导出 KiCad BOM
  1. 在 KiCad 原理图编辑器中,为每个符号添加一个值为 LCSC 元件编号的 LCSC 字段
  2. 将 BOM 导出为包含以下列的 CSV:Reference、Value、Footprint、LCSC
  3. 重命名列,使其符合 JLCPCB 的预期格式:
    • Reference -> Designator
    • Value -> Comment
    • Footprint -> Footprint
    • LCSC -> LCSC Part #

有关 gerber 导出设置、CPL 格式和钢网订购,请参阅 bom 技能。

JLCPCB 官方 API(需审批)

通过 https://api.jlcpcb.com 申请。访问权限受限——需根据订单历史和企业资料进行审核。

审批通过后可用的 API:

  • 元件 API——实时价格、库存、元件规格
  • PCB API——上传 gerber、获取报价、下单、跟踪状态
  • 钢网 API——钢网报价与订购
  • 3D 打印 API——SLA/MJF/SLM/FDM 订购

PCB 设计规则(JLCPCB 能力)

标准 PCB(1-2 层)
参数最小值
走线宽度0.127mm(5mil)
走线间距0.127mm(5mil)
过孔直径0.45mm
过孔钻孔直径0.2mm
环形焊盘宽度0.125mm
最小孔径0.2mm
板厚0.4-2.4mm(默认 1.6mm)
最小板尺寸6x6mm
最大板尺寸500x400mm(2 层)
多层板(4 层及以上)
参数最小值
走线宽度0.09mm(3.5mil)
走线间距0.09mm(3.5mil)
过孔直径0.25mm
过孔钻孔直径0.15mm
板厚0.6-2.4mm
将 DRU 导入 KiCad

如果你有 JLCPCB 的 .kicad_dru 设计规则文件,请在 KiCad Board Editor > Board Setup > Design Rules > Import Settings 中导入。

装配限制

经济型与标准型装配
特性经济型标准型
装配面仅顶层顶层 + 底层
元件类型仅 SMDSMD + 通孔
最小元件尺寸020101005
细间距 BGA/QFP最小 0.5mm 间距最小 0.4mm 间距
交付周期~3-5 天~3-5 天
扩展元件费用每种元件 $3每种元件 $3
一般限制
  • 最低订购量:装配订单为 5 块 PCB
  • 不同元件数量限制:没有硬性上限,但每种扩展元件额外收费 $3
  • 基础元件:无需额外费用,已预装载到机器中

旋转偏移

对于某些封装,JLCPCB 的贴片机使用的旋转约定与 KiCad 不同。常见偏移如下:

封装系列典型偏移
SOT-23、SOT-23-5、SOT-23-6+180°
SOT-223+180°
SOIC-8、SOIC-16+90° 或 +270°
QFN(所有尺寸)+90°
SMA/SMB/SMC 二极管+180°
USB-C 连接器因型号而异 — 请查阅数据手册

修正旋转问题:

  1. 上传前直接在 CPL 文件中添加旋转修正(调整 Rotation 列)
  2. 对于自定义封装,请确认引脚 1 的方向符合 JLCPCB 的要求
  3. JLCPCB 的审核步骤会发现重大错误,但对称元件(电容、电阻)微妙的 180° 旋转可能不会被发现
  4. 首次下单装配后,记录所需的旋转修正,并应用到之后导出的 CPL 文件中

订购流程

打样订单(裸 PCB + 钢网)
  1. 从 KiCad 导出 gerber 文件(导出设置请参阅 bom 技能)
  2. 将 gerber 文件上传到 https://cart.jlcpcb.com/quote — 配置层数、厚度、颜色和数量
  3. 在购物车中添加带框钢网(使用 gerber 文件中的锡膏层)
  4. 下单 — PCB 和钢网通常约 1 周后送达
生产订单(已装配的电路板)
  1. 从 KiCad 导出 gerber 文件(导出设置请参阅 bom 技能)
  2. 导出 BOM 为包含 LCSC 零件编号的 CSV 文件(格式如上)
  3. 导出 CPL(贴装文件)为 CSV 文件(格式请参阅 bom 技能)
  4. 将 gerber 文件上传到 https://cart.jlcpcb.com/quote — 配置层数、厚度、颜色和数量
  5. 启用“PCB Assembly”,选择 Economic 或 Standard
  6. 上传 BOM 和 CPL 文件
  7. 检查元件匹配情况 — 搜索 LCSC 编号,修正所有未匹配的元件
  8. 确认并下单
转换 Altium / KiCad BOM 和 CPL 文件

对于从 Altium(或其他工具)导出的电路板,如果 BOM/CPL 格式 与 JLCPCB 要求的列不匹配,bom 技能附带 translate_bom_pnp.py,可用于转换文件。包含两个子命令:

# BOM: KiCad/Altium CSV → JLCPCB BOM CSV (Comment, Designator, Footprint,
#                                         LCSC Part #, MPN, Manufacturer,
#                                         Quantity, Notes)
python3 skills/bom/scripts/translate_bom_pnp.py bom input_bom.csv -o jlc_bom.csv

# CPL: input CPL → JLCPCB Pick-and-Place CSV (Designator, Mid X, Mid Y,
#                                              Layer, Rotation), with mil→mm
#                                              and TopLayer/BottomLayer
#                                              normalization
python3 skills/bom/scripts/translate_bom_pnp.py pnp input_cpl.csv -o jlc_cpl.csv
3 步完成 PCBA 上传工作流(避免被拒)

当 CPL 中包含 BOM 里没有的位号(例如机械孔、基准点、测试点等;这些会出现在 CPL 输出中,但并非装配元件)时,JLCPCB 的 PCBA 网页上传会拒绝订单。转换器的 --bom 过滤模式可以解决这个问题:

  1. 先转换 BOM — 生成 JLCPCB 格式的 BOM,并确定权威的位号集合:

    python3 skills/bom/scripts/translate_bom_pnp.py bom input_bom.csv -o jlc_bom.csv
    
  2. 使用 --bom 过滤器转换 CPL — 取 CPL 位号与 BOM 位号的交集,剔除多余项:

    python3 skills/bom/scripts/translate_bom_pnp.py pnp input_cpl.csv -o jlc_cpl.csv --bom jlc_bom.csv
    

    返回的 filtered_orphans 数量以及 filtered_orphan_samples 列表,可让操作人员确认哪些 CPL 行被剔除;上传前请检查此列表。常见的多余项(安装孔、基准点、测试点)都属正常;其他项目则可能表明 BOM/PCB 不匹配,值得进一步调查。

  3. 单独列出寄售元件成本 — JLCPCB 的报价不会自动列出寄售(用户提供)元件的费用。请制作报价摘要,列明:PCB 制造费、PCBA 装配费、基础元件与扩展元件的成本(按 JLCPCB 发票列出),以及单独的用户采购元件小计。若没有这项明细,报价中的实际单件成本就会少计寄售元件的费用。

之所以记录此工作流,是因为 JLCPCB 的网页上传界面会在遇到含多余位号的 CPL 时静默拒绝,并给出无用的错误信息;使用 --bom 进行一致性检查,是交付无误 PCBA 订单时最有价值的一步。

提示

  • 优先选择基础元件 — 无额外费用、始终有库存,装配速度更快
  • 下单前检查库存 — 扩展元件可能缺货;使用 lcsc skill 搜索
  • 由 JLCPCB 拼板 — 对于小板,让 JLCPCB 拼板(更便宜),而不是定制拼板
  • 无铅焊料 — 默认使用含铅焊料(HASL);如有需要,可选择无铅 HASL 或 ENIG
  • 阻抗控制 — 多层板可用,请在订单备注中注明叠层
  • 半孔 — 支持,可在订单选项中启用
  • V-cut 和鼠咬孔 — 支持用于拼板分离
  • 丝印最小尺寸 — 为确保文字清晰,高度为 0.8mm,线宽为 0.15mm
  • 边缘间距 — 铜箔与板边保持 >=0.3mm 的距离(建议 0.5mm)

评论

支持 Markdown