关于 jlcpcb
用于通过 JLCPCB 准备 PCB 制造和组装订单的技能,涵盖 BOM 与贴片文件格式、设计限制、元件匹配,以及原型和量产订购流程。
主要功能
- 01JLCPCB BOM 格式指引
- 02BOM 与 CPL 转换流程
- 03制造设计规则参考
- 04组装限制与元件匹配
- 05原型及量产订购步骤
适用场景
- 01准备 KiCad 文件以便上传 PCBA
- 02制造前检查电路板规则
- 03按 BOM 筛选贴片文件元件
- 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 评分 |
bom | BOM 管理、gerber/CPL 导出、钢网订购 |
digikey | 搜索 DigiKey(原型元件采购,首选;也优先通过 API 下载数据手册) |
mouser | 搜索 Mouser(原型元件采购,次选) |
lcsc | 搜索 LCSC(生产元件采购;JLCPCB 使用 LCSC 元件库) |
pcbway | PCB 制造与组装的替代方案 |
emc | EMC 预合规风险分析——制造前运行,排查 EMC 问题 |
spice | SPICE 仿真——提交制造前验证模拟子电路 |
组装元件库
元件类别
| 类别 | 描述 | 组装费用 |
|---|---|---|
| 基础 | 常见元件(电阻、电容、二极管、常见 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
- 在 KiCad 原理图编辑器中,为每个符号添加一个值为 LCSC 元件编号的
LCSC字段 - 将 BOM 导出为包含以下列的 CSV:Reference、Value、Footprint、LCSC
- 重命名列,使其符合 JLCPCB 的预期格式:
Reference->DesignatorValue->CommentFootprint->FootprintLCSC->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 中导入。
装配限制
经济型与标准型装配
| 特性 | 经济型 | 标准型 |
|---|---|---|
| 装配面 | 仅顶层 | 顶层 + 底层 |
| 元件类型 | 仅 SMD | SMD + 通孔 |
| 最小元件尺寸 | 0201 | 01005 |
| 细间距 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 连接器 | 因型号而异 — 请查阅数据手册 |
修正旋转问题:
- 上传前直接在 CPL 文件中添加旋转修正(调整 Rotation 列)
- 对于自定义封装,请确认引脚 1 的方向符合 JLCPCB 的要求
- JLCPCB 的审核步骤会发现重大错误,但对称元件(电容、电阻)微妙的 180° 旋转可能不会被发现
- 首次下单装配后,记录所需的旋转修正,并应用到之后导出的 CPL 文件中
订购流程
打样订单(裸 PCB + 钢网)
- 从 KiCad 导出 gerber 文件(导出设置请参阅
bom技能) - 将 gerber 文件上传到
https://cart.jlcpcb.com/quote— 配置层数、厚度、颜色和数量 - 在购物车中添加带框钢网(使用 gerber 文件中的锡膏层)
- 下单 — PCB 和钢网通常约 1 周后送达
生产订单(已装配的电路板)
- 从 KiCad 导出 gerber 文件(导出设置请参阅
bom技能) - 导出 BOM 为包含 LCSC 零件编号的 CSV 文件(格式如上)
- 导出 CPL(贴装文件)为 CSV 文件(格式请参阅
bom技能) - 将 gerber 文件上传到
https://cart.jlcpcb.com/quote— 配置层数、厚度、颜色和数量 - 启用“PCB Assembly”,选择 Economic 或 Standard
- 上传 BOM 和 CPL 文件
- 检查元件匹配情况 — 搜索 LCSC 编号,修正所有未匹配的元件
- 确认并下单
转换 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 过滤模式可以解决这个问题:
-
先转换 BOM — 生成 JLCPCB 格式的 BOM,并确定权威的位号集合:
python3 skills/bom/scripts/translate_bom_pnp.py bom input_bom.csv -o jlc_bom.csv -
使用
--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 不匹配,值得进一步调查。 -
单独列出寄售元件成本 — JLCPCB 的报价不会自动列出寄售(用户提供)元件的费用。请制作报价摘要,列明:PCB 制造费、PCBA 装配费、基础元件与扩展元件的成本(按 JLCPCB 发票列出),以及单独的用户采购元件小计。若没有这项明细,报价中的实际单件成本就会少计寄售元件的费用。
之所以记录此工作流,是因为 JLCPCB 的网页上传界面会在遇到含多余位号的 CPL 时静默拒绝,并给出无用的错误信息;使用 --bom 进行一致性检查,是交付无误 PCBA 订单时最有价值的一步。
提示
- 优先选择基础元件 — 无额外费用、始终有库存,装配速度更快
- 下单前检查库存 — 扩展元件可能缺货;使用
lcscskill 搜索 - 由 JLCPCB 拼板 — 对于小板,让 JLCPCB 拼板(更便宜),而不是定制拼板
- 无铅焊料 — 默认使用含铅焊料(HASL);如有需要,可选择无铅 HASL 或 ENIG
- 阻抗控制 — 多层板可用,请在订单备注中注明叠层
- 半孔 — 支持,可在订单选项中启用
- V-cut 和鼠咬孔 — 支持用于拼板分离
- 丝印最小尺寸 — 为确保文字清晰,高度为 0.8mm,线宽为 0.15mm
- 边缘间距 — 铜箔与板边保持 >=0.3mm 的距离(建议 0.5mm)