画板子连线图这件事很多硬件开发者和嵌入式初学者都低估了它的重要性。不少人觉得板子连线图就是给面包板或者开发板拍一张照片再用画图软件随便标几根线就完事了。结果做出来的图要么线交叉成一团要么引脚标注含糊不清过了两三个星期自己都看不懂更别说让队友、导师或者博客读者照着复现了。这篇文章想聊清楚一件事好看的板子连线图不是“画得漂亮”而是“看得懂、照着能接线、改版后还能维护”。它本质上是硬件开发过程中一份可视化工程文档而不是一张示意图。我会从一张连线图应该包含什么信息讲起再对比目前常用的几类绘制工具的适用场景然后分别演示 Fritzing、Wokwi 和 draw.io 的实操路径最后给出我建议的连线图信息模板、颜色规范和常见问题排查清单。读完这篇文章你应该能建立一套适合自己的连线图绘制流程而不是每次都在画图上“凭感觉发挥”。1. 这篇文章真正要解决的问题先说一个真实的场景你做了一个 ESP32 温湿度监测小项目电路在面包板上跑通了。为了写项目总结你拍了一张照片然后在照片上用红线和蓝线标了“VCC”“GND”“DATA”发到群里。别人问你“SDA 接的是 GPIO21 还是 GPIO22”你翻了半天照片发现线叠在一起根本看不清。这类问题的根源不是拍照技术不行而是你画的连线图缺少关键信息。板子连线图要承担的任务比大多数开发者意识到的要多给未来的自己看项目搁置两周后你还能不能根据这张图还原接线给合作者看队友拿到图能不能不在你旁边的情况下独立接线给读者或评审看阅读博客或答辩的人能不能快速理解项目的硬件连接关系所以这篇内容真正要解决的是三个层面问题信息完整性连线图上应该包含哪些信息才能让看图的人无歧义地完成接线。工具选型不同工具适合什么场景、什么水平的人以及各自的局限性。绘制规范连线的走线、颜色、标注、图例怎么做才能让图既整洁又易于维护。需要先说明这里的“板子连线图”不是 PCB 工程图也不是严格意义的电路原理图。它更接近“接线可视化视图”重点是表达开发板、模块、传感器之间的物理连接关系。2. 一张好看的连线图到底要包含什么“好看”的标准因人而异但“有用”的标准是可以明确列出来的。根据我看到的优秀硬件项目文档一张合格的板子连线图至少应该包含以下几类信息。2.1 明确的元件标识图中每个元件都要有名称和型号。比如“ESP32 DevKit V1 Rev1”“DHT22 温湿度传感器”“0.96 英寸 I2C OLED SSD1306”。元件名称最好同时标注在图形上和正文说明中方便看图的人去查数据手册或购买链接。实际项目中很多人只用“传感器”“单片机”这种模糊说法这是最常见的错误。因为不同厂家的传感器引脚顺序可能完全不同比如 DHT11 和 DHT22 的引脚定义虽然一致但有些集成模块自带上拉电阻有些没有不看具体模块型号很难判断该怎么接线。2.2 无歧义的引脚映射这是连线图最关键的信息。开发板的引脚、模块的引脚、两者之间的连接线必须一一对应。建议至少用“开发板引脚 - 模块引脚”的方式标注每一条连接。例如ESP32 GPIO4 - DHT22 DATA如果项目里连线很多可以给每条连接线编号比如 C1、C2、C3然后在图下方列出连接表。这样既能在图中减少文字挤压又能保证信息完整。2.3 电源与地线的显式表达VCC、3V3、5V、GND 这些电源连接在实物照片里往往因为线太多而非常混乱。因此在连线图中要特别处理通常建议电源线用一种颜色统一标识推荐红色。地线统一使用黑色或深灰色。如果存在多个电源域3.3V 和 5V 混用要在图中明确区分并做好标注。2.4 特殊引脚说明有些连接不只是“一根线”还涉及信号方向、电平转换、上拉电阻等。比如I2C 的 SDA 和 SCL 需要外部上拉电阻某些模块板载了某些没有。UART 串口通信时设备之间的 TX 和 RX 要交叉连接。OLED 屏幕的 I2C 地址可以通过焊接电阻改变连线图上最好标注当前使用的地址。这些信息如果在连线图中能体现出来会大大减少调试时间。2.5 版本与修订信息这是最容易被忽略、也最影响长期维护的一项。好的连线图应在角落标注项目名称。连线图版本。修改日期。修改人。变更说明。有了这些信息项目经过多轮迭代后你才能知道手头这张图对应的是哪个阶段的电路。3. 常见绘制工具盘点与选型工具没有绝对好坏关键是匹配使用场景。下面按工具类型逐个说明适用对象和边界。工具类型上手难度适合场景不适合场景Fritzing专业连线图工具低面包板原型、教学演示、项目文档复杂 PCB 设计、多人协作Tinkercad Circuits在线仿真连线低初学者在线试验、快速验证真实硬件调试、离线使用Wokwi在线仿真连线中ESP32/Arduino 项目仿真、自动生成连接关系纯文档绘制KiCad EDA专业 EDA高原理图到 PCB 的完整流程快速出连线示意图draw.io diagrams.net 通用绘图低自由绘制连线图、架构图需要电气仿真的场景手写白板 拍照手工方式极低快速记录思路、在线会议即时沟通项目正式文档从开发效率和长期维护的角度我建议的搭配是原型记录用 Wokwi 或 Tinkercad 做仿真和初步连线验证。正式文档用 Fritzing 生成面包板连线图再补充必要的标注。自定义需求用 draw.io 手绘风格连线图适合需要精确控制信息展示的场景。进阶用户如果项目要走向 PCB 打样则从 KiCad 入手用原理图完成设计而不是靠连线图反推。下面分别演示这几种主流方式的具体操作流程。4. 用 Fritzing 绘制标准的板子连线图Fritzing 是制作面包板连线图最经典的工具之一。它的最大优点是元件库中有大量开发板、传感器和面包板的实物风格图形拖拽元件并接线之后它可以自动生成对应的原理图和 PCB 视图因此很适合作教学展示和项目文档。4.1 创建项目并放置元件启动 Fritzing点击“New Project”默认会进入面包板视图。右侧“Parts”面板中搜索并拖入以下元件ESP32 DevKit 或其他微控制器开发板。面包板。DHT22 模块或 DHT11 模块。0.96 英寸 OLED 模块。电阻、跳线等。如果搜索不到对应型号可以从“Mine”标签页导入本地元件库文件。Fritzing 支持导入 .fzpz 格式的元件包。4.2 完成连线在面包板视图中将元件引脚插入对应面包板孔位然后从工具栏选择“Wire”工具点击一个引脚后拖到另一个引脚即可建立连线。这里有一个操作建议先连接电源和地再连接信号线。这样在连线密集时电源和地线会分布在边缘区域信号线更清晰。4.3 添加标注和说明Fritzing 支持在图中添加标签文字。在面包板视图右侧“Inspector”面板中可以修改导线颜色、线宽以及给元件添加自定义标签。关键标注建议每个元件旁标注型号。每个引脚连接处标注“3V3”“GND”“GPIO4”等名称。如果有特殊跳线用不同颜色区分并添加图例说明。4.4 导出图片完成连线后点击“File - Export - As Image”可以导出 PNG 或 SVG。SVG 格式适合后续在文档中继续编辑也方便在博客中放大查看细节。4.5 Fritzing 的注意事项Fritzing 的优点是好看但也有几个明显的坑元件库版本差异不同版本的 Fritzing 元件库不完全一致部分元件型号找不到时只能用功能相近的替代这会带来引脚定义差异需要在标注中手动修正。连线容易混乱元件多的时候Fritzing 里的导线可能自动绕线反而比手绘更乱。建议尽量用短直线连接避免长距离交叉。没有自动检查Fritzing 不会帮你检查接线逻辑是否正确画错了它也不会报错。因此导出文档前务必按连接表逐条核对。5. 用 Wokwi 生成仿真的连线关系图如果你做的是 ESP32、Arduino、树莓派 Pico 等常见平台的原型验证Wokwi 是一个更轻量的选择。它本质上是一个电路仿真平台但它的连接关系是以代码方式定义的所以天然适合作为“连线图的数据源”。5.1 Wokwi 项目结构在 Wokwi 中创建一个新项目后连接关系写在diagram.json文件中。这个文件就是连线关系最结构化的表达。一个 ESP32 DHT22 OLED 的diagram.json示例如下{ version: 1, author: yourname, editor: wokwi, parts: [ { type: board-esp32-devkit-c-v4, id: esp32, top: 0, left: 0, attrs: {} }, { type: board-dht22, id: dht22, top: -200, left: 300, attrs: {} }, { type: ssd1306, id: oled, top: 200, left: 300, attrs: {} } ], connections: [ [esp32:3V3, dht22:VCC, red, []], [esp32:GND.1, dht22:GND, black, []], [esp32:4, dht22:DATA, yellow, []], [esp32:3V3, oled:VCC, red, []], [esp32:GND.1, oled:GND, black, []], [esp32:22, oled:SCL, blue, []], [esp32:21, oled:SDA, green, []] ] }这个文件里的每个字段都值得解释一下parts数组描述项目中有哪些元件。type是元件类型id是当前项目里的唯一标识top和left控制元件在画布上的位置。connections数组描述连接关系。每一项是一条连接线格式为[起点, 终点, 颜色, 属性数组]。起点终点都使用元件id:引脚名的形式。从连线图的角度看Wokwi 的意义在于连接关系不再是一张模糊的图片而是一份可读、可改、可版本控制的 JSON 数据。你可以把它放进 Git 仓库每次修改硬件连接后diff 一目了然。5.2 用 Wokwi 快速验证连接在浏览器中运行 Wokwi 项目后可以打开仿真器的连线视图查看 Wokwi 自动生成的布局。根据项目复杂度这一步可以帮助你确认连接关系是否和设计一致。不过 Wokwi 并不是专门的连线图绘制工具。它的画布布局主要用于逻辑验证直接导出的图形往往不能满足文档要求。更合理的用法是在 Wokwi 中建立连接关系并仿真验证。确认功能正常后把diagram.json中的连接关系复制到文档中。再用 Fritzing 或 draw.io 出正式连线图。这样既保证了连接关系的准确性和可追溯性又兼顾了文档的美观。6. 用 draw.io 自由绘制连线图如果你的项目用到非标准模块或者你希望完全控制连线图的版式和信息密度那 draw.io目前官方也叫 diagrams.net是最灵活的方案。它是免费、支持网页和桌面端的通用绘图工具不需要安装重型 EDA 软件。6.1 建立绘图基础打开 draw.io新建文件后选择空白画布。先在“General”或“Network”形状库中找到矩形、圆角矩形等基础形状搭建元件区域。一个推荐的做法是用矩形表示开发板、传感器模块用小组件框表示引脚区域。比如 ESP32 开发板可以先画一个大矩形代表板体可填充浅灰色然后在矩形上下边缘画出排列整齐的“引脚点”小矩形每个小矩形上标注引脚名称如3V3、GND、GPIO4、GPIO21、GPIO22。用这种方式连线时可以精确地从某个引脚点出发而不是从整块板子的边框上出发视觉效果会专业很多。6.2 连线设置从引脚点拖出连线时draw.io 默认生成的可能是自由曲线。为了让连线图更整洁选中连线后在右侧“Style”面板中把线条类型改为“Orthogonal”也就是直角正交线。正交线像 PCB 走线一样横平竖直视觉上非常整齐。同时为每条连线设置颜色电源线用红色。地线用黑色。I2C 数据线用绿色。I2C 时钟线用蓝色。其他信号线用黄色或橙色。在连线中间或者端点位置添加文字标签标明信号名称。比如在 OLED 的 SCL 连线旁边标注SCL - GPIO22这样看图的人不需要去猜具体引脚的对应关系。6.3 添加图例和连接表在画布角落添加一个图例块说明每种颜色的含义。不要认为“看图上的颜色就能懂”彩色图片在打印成黑白文档后颜色信息会全部丢失所以图例中除了颜色还要注明线型、标签等非颜色特征。更稳妥的做法是在连线图下方添加一个连接表格式如下连接编号开发板引脚模块引脚信号名称线色C13V3DHT22 VCC电源红C2GNDDHT22 GND地黑C3GPIO4DHT22 DATA数据黄C43V3OLED VCC电源红C5GNDOLED GND地黑C6GPIO22OLED SCLI2C时钟蓝C7GPIO21OLED SDAI2C数据绿这样即使图上的连线因为版面原因暂时看不清读者也可以完全依据表格完成接线。这就是“工程文档思维”和“随手画示意图”之间的最大差别。6.4 draw.io 的导入与导出draw.io 支持将文件保存为.drawio格式也可以用“File - Export as - PNG”直接导出图片。如果画布很大导出时把缩放比例调低避免图片过大。需要说明的是draw.io 本身不具备电气检查能力。它更适合作为“最终排版工具”而不是“电路验证工具”。如果你需要验证接线逻辑请先回到仿真软件或数据手册。7. 连线图工程化信息模板与颜色规范很多项目文档的连线图之所以混乱是因为每张图都使用了不同的颜色、不同的命名方式信息组织也随心所欲。要解决这个问题可以把连线图当成代码来管理先定规范再画图。7.1 定义颜色规范在项目文档中放一份颜色规范可以使所有连线图保持一致。下面这个 JSON 文件可以作为项目级规范保存下来{ color_scheme_version: 1.0, colors: { power: #E53935, ground: #212121, i2c_sda: #43A047, i2c_scl: #1E88E5, uart_tx: #FB8C00, uart_rx: #8E24AA, gpio_signal: #FDD835, reserved: #90A4AE }, rules: [ 电源线统一使用红色并在标签中标注电压值, 地线统一使用黑色或深灰色, 同一总线信号尽量使用同一颜色, 颜色区分不能作为唯一信息载体必须配合文字标签 ] }这份规范建议放在项目的/docs目录下与连线图源文件放在一起。这样每次新建连线图时可以直接从模板项目复制粘贴不用重新设计颜色。7.2 定义连接信息表模板在画图之前先用表格把连接关系列出来是最省时间的做法。一个标准的连接信息表模板如下| 连接编号 | 信号名称 | 源端开发板 | 目标端模块 | 线色 | 备注 | | --- | --- | --- | --- | --- | --- | | C1 | 3V3 | ESP32:3V3 | OLED:VCC | 红色 | 模块工作电压 3.3V | | C2 | GND | ESP32:GND | OLED:GND | 黑色 | 共地 | | C3 | SCL | ESP32:GPIO22 | OLED:SCL | 蓝色 | I2C 时钟 | | C4 | SDA | ESP32:GPIO21 | OLED:SDA | 绿色 | I2C 数据 |这个表可以在画图之前先交给队友评审“接线是否正确”在电纸上就能确认不需要等画完成图再返工。画图时再根据表里的信息逐条连接视图上的线路。7.3 版本管理与变更记录连线图源文件推荐一并纳入版本管理Fritzing 的.fzz文件。draw.io 的.drawio文件。Wokwi 的diagram.json文件。其中diagram.json的文本格式对 Git 最友好改动很容易在 diff 中看出。Fritzing 和 draw.io 的文件本质也是 XML 格式同样支持 Git 管理但可读性弱一点。每次硬件接线有变化应该在文档中更新版本号并在变更记录里写明“从 v1.0 到 v1.1将 DHT22 数据引脚从 GPIO4 改为 GPIO5原因GPIO4 与板载 LED 冲突。”这类背景信息对后面排查问题非常有价值。8. 常见问题与排查清单问题现象可能原因排查方式解决方案图片上引脚看不清图片缩小后文字过小放大原图局部截图分区域画多个子图而不是一张图塞满全部线太多颜色杂乱没有做颜色规范检查是否按颜色方案接线先列连接表再统一上色照着图接线后模块不工作连接关系正确但与数据手册不符对照模块数据手册核对引脚定义以数据手册为准修改连接表后再修改图形图与代码不一致实物接线改了图没更新对比实物与图连线将连线图源文件放 Git 管理改动同步提交图导出后出现乱码或重影线条导出图片时缩放比例不合理使用 SVG 导出再转换导出时选择“缩放 200%”或直接导出 SVG无法找到对应元件模型元件库缺少同型号封装搜索功能相近型号代替在图形上添加 Text 标注真实型号不依赖元件库名称连接表与图不对应手工编辑导致遗漏逐条对照连接表检查图中连线先完成连接表评审再画连线图排查的任何一步都建议从连接表开始。因为连接表是文字数据搜索、对比、修改都比图形快得多。图形只是连接表的可视化表达如果两者冲突以连接表为准然后用图形反向检查。9. 最佳实践与工程建议9.1 按“先表格、后图形”的流程推进不要在画布上边看边想怎么接线。正确流程是在文档里列出所有元件清单。写出连接信息表包括两端的引脚名称。请同事或朋友根据连接表复核引脚定义。再打开绘图工具把连接表中的信息画出来。这样能减少图形返工还能在早期发现接线错误。9.2 给连接线编号并分组当连线数量超过 10 条时建议给连接线编号。比如所有电源连接命名为 P1、P2接地连接命名为 G1、G2信号连接命名为 S1、S2。编号规则写进图例说明。这样做有三个好处图面文字更简洁。排查问题时可以快速对照连接表。多人协作时沟通成本降低比如“S3 这条线接错模块了”。9.3 尽量使用模块化画法对于复杂项目不要试图在一张图里画完所有连接。按功能模块拆分成多张子图比如“电源接线图”“传感器接线图”“通信接口接线图”再用总览图说明模块间的关系。这样可以大幅提升大项目的可读性。9.4 标注两个容易混淆的细节I2C 和 UART 是初学者最常踩坑的两个场景。I2C 的接线是 SDA 接 SDA、SCL 接 SCL属于“同名单对同名”因为 I2C 是共享总线。而 UART 的 TX 和 RX 是交叉连接的因为这是一对一的点对点通信。在连线图中如果使用 UART建议在连接表中明确写清楚ESP32 TX0 - 设备 RX ESP32 RX0 - 设备 TX不要把这种细节留给看图的人自行推断否则很容易在实物接线时出现“收发对不上”的问题。9.5 把连线图当作代码来维护这里再强调一次连线图的源文件必须和代码、配置文件一起纳入版本管理。每次代码提交如果涉及硬件连接就同时更新连线图。这样项目回滚时软件和硬件文档可以对应起来不会出现“代码回退了但硬件还没改回来”的情况。如果团队里没有统一的规范可以从最简单的做起在docs/hardware/目录下放置wiring.md、wiring.drawio和diagram.json并在项目的 README 里明确写清楚“硬件连接图在docs/hardware/修改后同步更新”。10. 总结与后续学习方向这篇文章围绕“板子连线图”的绘制从信息完整性、工具选型、实操流程到工程规范做了展开。现在需要记住的核心结论有四条连线图的核心价值是信息无歧义而不是好看。引脚映射、电源与地、版本信息缺一不可。工具选型按场景来快速验证用 Wokwi标准文档用 Fritzing自由排版用 draw.io。绘制流程建议采用“先连接表、后图形”这样可以避免图形返工。连线图源文件必须纳入版本管理并配套颜色规范和信息模板。如果你准备在下一个项目里重新整理硬件文档建议从这两件事入手写一个项目的连接信息表模板哪怕只用 Markdown 表格。为项目创建一个docs/hardware/目录画一张最简单的 ESP32 开发板连接图。这两步做完你再看自己的项目文档会发现硬件部分的清晰度比之前高出一个档次。后续如果涉及 PCB 设计再进一步学习 KiCad 或立创 EDA 的原理图绘制把连接表迁移为原理图的网络标号那就真正进入硬件工程化的正轨了。