各位硬件开发、嵌入式和对 EDA 工具链感兴趣的朋友大家好。在上一篇“手搓 EDA 软件”的汇报中我们聊了底层框架和工程管理收到了不少朋友的私信和讨论。说实话很多朋友对“自己动手写一个 EDA”这件事很感兴趣但最关心的问题往往是“原理图编辑器到底是怎么画出来的里面的元件库、导线、网络标签这些功能真要自己写该怎么拆”这篇汇报演出我们就聚焦在原理图编辑器上。不管你是准备开发自己的内部硬件设计小工具还是准备深入研究 KiCad、嘉立创EDA这类开源/国产EDA的底层机制亦或是想用 Python、C、Electron 做一款独立的原理图绘制应用这篇文章都会给你一条完整的实现思路。先明确一下本文的定位。我们不是写一篇产品测评也不是讲某款商业 EDA 软件怎么用而是“手搓”视角下的原理图编辑器技术拆解。我会以常见的桌面 GUI 技术栈为例比如 Python PySide6/PyQt、C Qt或者 TypeScript Canvas 2D 这类可以跑通的组合。本文核心重点关注一套原理图编辑器必须包含哪些核心模块每个模块的数据结构怎么设计鼠标交互怎么实现画布缩放平移怎么做电气连接信息如何保存以及最终怎么生成网表。为了方便演示文中代码以 Python 风格伪代码加可运行的核心类为主你在自己项目里用 C 或 TypeScript 重写时思路完全一致。1. EDA 原理图编辑器到底是什么1.1 从一块画布说起原理图编辑器表面上是“画元器件 连线”实际上它是硬件设计流程中的第一道电气信息入口。你画的不是图形而是电路连接关系。电阻、电容、芯片这些符号在原理图里本质都是带有引脚编号的元件实例每一条连线本质是引脚与引脚之间的网络连接关系。所以在设计原理图编辑器时首先要区分两个概念图形层屏幕上看到的线、矩形、圆、引脚、文字标注。电气层元件引脚、网络标签、连线之间的拓扑连接关系。商业 EDA 软件的核心就是这两层之间的映射与同步。说白了用户拖动元件时图形跟着走用户连线时程序要能判断这条线连到了哪个引脚、属于哪个网络用户复制元件时新的电气节点要一并生成。这个思路贯穿整个编辑器的开发。1.2 编辑器核心功能拆解作为一个可用的原理图编辑器功能上至少需要覆盖这些方面功能模块说明难点画布管理缩放、平移、网格对齐、光标坐标坐标转换与性能元件放置从元件库拖入、旋转、镜像、属性编辑数据一致性导线绘制水平/垂直走线、拐角自动处理、删除重连命中测试与拓扑更新电气连接引脚与导线端点自动吸附、网络标签关联全局网络编号选择与编辑框选、点选、拖动、复制、删除、撤销重做命令模式设计层次化设计子图、图纸符号、端口结构管理网表输出生成 Spice、KiCad netlist 或自定义格式数据遍历与序列化我们不可能一篇文章把以上全部写完所以本文挑选其中最关键的几块核心数据模型、画布交互、导线绘制、电气连接与网表生成以及文件序列化。2. 核心数据模型设计对象、引脚与连接原理图编辑器的数据模型是整棵树的根。代码可以重构界面可以换但数据模型一旦设计不好后续网表导出、DRC 检查都会很难受。下面我们来设计一套简洁且够用的模型。2.1 元件与符号的数据结构一个元件实例ComponentInstance由符号图形和属性组成。符号图形包括引脚位置和标识属性包括位号Reference、值Value、封装Footprint等。先看一段 Python 风格的模型定义# 文件路径schematic_model.py from dataclasses import dataclass, field from typing import List, Dict, Optional from enum import Enum class PinDirection(Enum): INPUT input OUTPUT output BIDIR bidir POWER power class PinType(Enum): BOOLEAN boolean TRI_STATE tri_state PASSIVE passive dataclass class Pin: 引脚定义 name: str # 引脚名字比如 VCC、GND、PA0 number: str # 引脚编号比如 1、2、3、14 x: float 0 # 引脚在元件符号坐标系下的 X 位置 y: float 0 # 引脚在元件符号坐标系下的 Y 位置 direction: PinDirection PinDirection.PASSIVE length: float 2.5 # 引脚电气连接点向外延伸的长度 net: Optional[str] None # 当前连接的网络名 dataclass class ComponentSymbol: 元件符号定义类似库里的符号模板 name: str pins: List[Pin] field(default_factorylist) # 图形图元线段、矩形、圆等这里用简化表示 shapes: List[dict] field(default_factorylist) # 包围盒 bbox: tuple (0, 0, 50, 50) def add_pin(self, pin: Pin): self.pins.append(pin) def get_pin(self, number: str) - Optional[Pin]: for p in self.pins: if p.number number: return p return None dataclass class ComponentInstance: 图纸上的元件实例 reference: str # 位号如 R1、C2、U1 value: str # 值如 10k、100nF、STM32F103 footprint: str symbol: ComponentSymbol None x: float 0 # 实例在图纸坐标系下的位置 y: float 0 rotation: float 0 # 旋转角度 mirrored: bool False # 是否镜像 properties: Dict[str, str] field(default_factorydict) def pin_absolute_position(self, pin: Pin) - tuple: 计算某个引脚在图纸上的绝对坐标 # 先考虑元件自身旋转和镜像再平移到 (self.x, self.y) # 这里为了演示只处理平移旋转镜像换算略 return (self.x pin.x, self.y pin.y)在这个模型里我们区分了两个层次ComponentSymbol是“模板”相当于元件库里存的元件符号ComponentInstance是“放到图纸上的实例”相当于画布里的一个具体元件。这样设计的好处是用一套符号模板可以放很多实例修改模板不会影响已经放置的实例除非你显式做“更新元件”操作。实际项目中建议把元件旋转、镜像放在ComponentInstance里因为同一个符号在图纸上可以有不同的朝向这样更灵活。C/Qt 工程中建议用 QGraphicsItem 的继承体系来实现但数据模型层不应该和图形视图层耦合这是我多次踩坑后的经验。2.2 导线与网络模型导线不是简单的一堆 Polyline它是由多个线段WireSegment组成的电气路径起点和终点要能精准吸附到引脚或另一条导线的端点。dataclass class WireSegment: 导线段 id: str x1: float y1: float x2: float y2: float net_name: Optional[str] None # 属于哪个网络 layer: str signal # 原理图一般用 signal 层 dataclass class Wire: 一条完整的导线由多个连续线段组成 id: str segments: List[WireSegment] field(default_factorylist) net_name: Optional[str] None def add_segment(self, segment: WireSegment): self.segments.append(segment) class Schematic: 一张原理图 def __init__(self): self.components: List[ComponentInstance] [] self.wires: List[Wire] [] self.net_labels: Dict[str, tuple] {} # 网络名 - 坐标 self.power_symbols: List[dict] [] self.page_size (1000, 700) def add_component(self, component: ComponentInstance): self.components.append(component) def add_wire(self, wire: Wire): self.wires.append(wire)网络Net在这里没有单独建类而是通过net_name来标识。后续做连通性分析时我们会从引脚出发沿导线追踪所有连接点把相同net_name的引脚归并成一个网络这才是最终网表的来源。2.3 坐标系统设计原理图编辑器至少有三套坐标符号坐标系定义元件库符号时使用的坐标中心通常是 (0,0) 或左上角。图纸坐标系元件放置到图纸后的实例坐标。屏幕坐标系视口滚动、缩放之后的像素坐标。用户编辑发生在图纸坐标系鼠标事件发生在屏幕坐标系两者之间需要一套可靠的转换函数。绝大多数图形框架比如 Qt、Canvas、WPF 都内置了矩阵变换直接使用即可。但如果你是想从零手写渲染一定要把“逻辑坐标”和“屏幕坐标”分开不要在鼠标事件里直接改模型坐标否则缩放一多数据就会乱。3. 画布与视图交互画布是编辑器和用户交互的窗口涉及缩放、平移、网格、选中高亮、拖拽、框选等交互。这些功能堆积在一起很容易写得像意大利面建议按职责拆分。3.1 视图区与场景区如果你选择 Qt 技术栈QGraphicsViewQGraphicsScene是很成熟的方案。如果你选择 Electron 或纯 Web 技术可以自己实现一个“场景管理器”。以 Qt 为例我们维护一个Viewport状态类# 文件路径viewport.py class Viewport: def __init__(self): self.scale 1.0 # 缩放比 self.offset_x 0 # 平移偏移 self.offset_y 0 self.grid_size 2.5 # 网格基准(mm) self.snap_enable True def screen_to_world(self, sx: float, sy: float) - tuple: 屏幕坐标转图纸坐标 wx (sx - self.offset_x) / self.scale wy (sy - self.offset_y) / self.scale return wx, wy def world_to_screen(self, wx: float, wy: float) - tuple: 图纸坐标转屏幕坐标 sx wx * self.scale self.offset_x sy wy * self.scale self.offset_y return sx, sy def snap(self, x: float, y: float) - tuple: 网格吸附 if not self.snap_enable: return x, y g self.grid_size return round(x / g) * g, round(y / g) * g这样鼠标移动、放置元件、绘制导线时都统一通过screen_to_world转为图纸坐标再进行网格吸附。最后再把模型坐标传回绘图函数。3.2 缩放与平移的实现细节缩放时一个常见的需求是“鼠标指向哪里就围绕哪里缩放”。这需要调整offset_x和offset_y保证鼠标指向的世界坐标在缩放前后不变。def zoom_at(viewport: Viewport, mouse_sx: float, mouse_sy: float, factor: float): # 缩放前鼠标指向的世界坐标 world_x, world_y viewport.screen_to_world(mouse_sx, mouse_sy) # 更新缩放值 new_scale viewport.scale * factor # 限制缩放范围 new_scale max(0.2, min(10.0, new_scale)) viewport.scale new_scale # 缩放后把世界坐标重新映射回鼠标位置反推出偏移 viewport.offset_x mouse_sx - world_x * new_scale viewport.offset_y mouse_sy - world_y * new_scale平移就简单了鼠标拖住空白区域时把 offset 加上鼠标移动的像素差值即可。注意在拖拽时不要让视图“跳变”需要记录按下时的鼠标位置。3.3 选中与框选点选很容易鼠标按下时遍历所有元件判断点是否落在元件的包围盒内。框选则需要一个矩形区域对每个元件做相交测试。对于有旋转的元件建议用符号的包围盒做粗判断再用多边形精确判断这在大多数框架里可以直接调用现成 API。一个比较隐蔽的坑元件引脚伸出元件本体之外时引脚本身也是“可选中区域”。用户可能想选中一个引脚来连线特别是在引脚密集的芯片上。所以命中测试要分成两层先测引脚再测元件。4. 元件库与元件放置没有元件库的原理图编辑器是没有灵魂的。手动创建元件库有两条路一是用代码定义符号二是用独立编辑器绘制符号后保存为库文件。本文采用前者重点是让你理解符号数据的来源。4.1 定义一个电阻符号我们用代码定义一个电阻# 文件路径library/resistor.py from schematic_model import ComponentSymbol, Pin, PinDirection, PinType def create_resistor_symbol() - ComponentSymbol: sym ComponentSymbol(nameRES) # 电阻符号引脚1号在左2号在右 sym.add_pin(Pin(name1, number1, x-10, y0, directionPinDirection.PASSIVE)) sym.add_pin(Pin(name2, number2, x10, y0, directionPinDirection.PASSIVE)) # 图形矩形示意 sym.shapes [ {type: rect, x: -5, y: -3, w: 10, h: 6}, ] sym.bbox (-10, -5, 20, 10) return sym这样的函数式定义适合少量元件。如果是几百上千个元件的库建议写成 JSON 或 YAML 文件运行时加载并注册。4.2 放置元件到图纸当用户从元件面板点击一个符号并点击画布时程序会创建一个ComponentInstance坐标为鼠标吸附后的图纸坐标。注意这里应该做“复制”不要直接把库里符号对象丢进图纸否则多个实例会共享同一个symbol引用。# 伪代码示例表示放置操作 def place_component( schematic, symbol, x, y, reference_prefixR ): # 根据当前图纸已有元件自动生成位号比如 R1、R2…… ref auto_generate_reference(schematic, reference_prefix) instance ComponentInstance( referenceref, valuesymbol.name, symbolsymbol, xx, yy, ) schematic.add_component(instance) return instance在交互上放置元件时可以跟随鼠标移动并且支持旋转按 R 键和镜像按 X 键。旋转的是实例自身的rotation属性而不是符号模板这点务必注意。5. 导线绘制从鼠标到电气连接导线绘制是原理图编辑器里最复杂也最有意思的部分。我们需要的不是“自由画线”而是“电气走线”。常规做法是支持以下交互鼠标点击起点可以是引脚端点、导线端点、或任意网格点。移动鼠标时自动生成水平或垂直的“预拉线”路径。点击中间点确认折线点继续延伸。双击或点击结束点完成导线绘制。如果终点落在已有引脚或导线上自动完成电气连接。5.1 电气吸附在鼠标移动时先做一步“电气吸附”而不是只做网格吸附。也就是寻找鼠标附近一定范围内的引脚端点和导线端点如果距离小于阈值就把当前点吸附到该端点上。def find_nearest_pin_or_wire_end(schematic, x, y, threshold2.0): best None best_dist threshold # 遍历所有元件引脚 for comp in schematic.components: for pin in comp.symbol.pins: px, py comp.pin_absolute_position(pin) dist ((px - x) ** 2 (py - y) ** 2) ** 0.5 if dist best_dist: best_dist dist best (pin, comp, pin) # 遍历所有导线端点 for wire in schematic.wires: for seg in wire.segments: for ex, ey in [(seg.x1, seg.y1), (seg.x2, seg.y2)]: dist ((ex - x) ** 2 (ey - y) ** 2) ** 0.5 if dist best_dist: best_dist dist best (wire_end, wire, ex, ey) return best这项吸附逻辑决定了用户连线的顺滑度。实际商业软件里还会对引脚连接点设置“热点”区域并对交叉线自动断开/连接但那是后话。5.2 预拉线与路径生成走线路径生成建议采用“贪心 优先水平/垂直方向”的算法。最简单的方式是如果起点和终点可以一条水平线或垂直线连上直接生成单段。如果不行生成“L 形”折线先横后竖或先竖后横。更复杂场景生成“Z 形”或自动绕障需要路由算法我们暂不展开。这里给出 L 形折线生成的示例def generate_route(x1, y1, x2, y2, prefer_horizontal_firstTrue): 生成直角走线路径返回拐点列表 points [(x1, y1)] if x1 x2 or y1 y2: # 一条直线 points.append((x2, y2)) return points if prefer_horizontal_first: # 先水平后垂直 points.append((x2, y1)) else: # 先垂直后水平 points.append((x1, y2)) points.append((x2, y2)) return points把拐点转换成导线线段时每相邻两个点就是一个WireSegment。5.3 从预拉线到正式导线用户双击或按下回车确认后程序才会把预拉线写入模型。为什么不在鼠标移动时直接写模型因为如果不加“确认”步骤画线过程中用户的鼠标抖动会产生大量零碎线段后续删除、移动、网表生成都会非常痛苦。正式写入时可以尝试对相邻共线线段合并减少线段数量def simplify_wire_segments(segments): 合并共线相邻线段 if len(segments) 2: return segments result [] current segments[0] for seg in segments[1:]: # 判断 current 和 seg 是否共线且首尾相连 same_h current.y1 current.y2 seg.y1 seg.y2 same_v current.x1 current.x2 seg.x1 seg.x2 if same_h or same_v: # 合并 current.x2 seg.x2 current.y2 seg.y2 else: result.append(current) current seg result.append(current) return result5.4 断路与连接更新当导线被删除时原有的电气连接关系随之消失。如果只是从列表里删掉Wire对象但引脚上残留的net_name没有更新那网表就会出现幽灵网络。所以删除导线后需要重新执行一次全图连通性分析刷新所有引脚的网络归属。这就是“数据驱动界面”的好处模型一旦更新重绘和网表都基于同一份数据。6. 电气连接与网表生成原理图编辑器的最终使命是把图形化的连接关系变成计算机可以处理的网表Netlist。下面我们聊一下连通性分析和网表导出。6.1 连通性分析连通性分析的输入是所有元件引脚、所有导线、所有网络标签。输出是每个网络有哪些引脚网络名是什么。一个常见的做法是“并查集”或 BFS 广度优先遍历。我们给每个连接点一个 ID然后用导线把这些点连起来。具体步骤如下def analyze_connectivity(schematic: Schematic): 重建所有网络的连接关系 # 1. 收集所有引脚与导线端点 nodes [] # 节点列表 node_id_map {} # 坐标 - 节点索引用于去重 def get_or_create_node(x, y): key (round(x, 3), round(y, 3)) if key not in node_id_map: idx len(nodes) node_id_map[key] idx nodes.append({x: x, y: y, pin: None, wire_id: None}) return node_id_map[key] # 2. 建立引脚到节点的映射 for comp in schematic.components: for pin in comp.symbol.pins: px, py comp.pin_absolute_position(pin) idx get_or_create_node(px, py) nodes[idx][pin] (comp, pin) # 3. 建立导线节点并关联 for wire in schematic.wires: wire_nodes [] for seg in wire.segments: idx1 get_or_create_node(seg.x1, seg.y1) idx2 get_or_create_node(seg.x2, seg.y2) wire_nodes.append((idx1, idx2)) # 4. 这里可以使用并查集合并所有属于同一条导线的节点 # 见下方 union-find 部分 # 5. 输出每个网络包含的引脚 # ...并查集代码如下用于合并网络class UnionFind: def __init__(self, n): self.parent list(range(n)) self.rank [0] * n def find(self, x): while self.parent[x] ! x: self.parent[x] self.parent[self.parent[x]] x self.parent[x] return x def union(self, a, b): ra, rb self.find(a), self.find(b) if ra rb: return if self.rank[ra] self.rank[rb]: self.parent[ra] rb elif self.rank[ra] self.rank[rb]: self.parent[rb] ra else: self.parent[rb] ra self.rank[ra] 1把所有引脚节点和导线节点做并查集合并后同一个根节点下的所有引脚就属于同一个网络。然后你可以为每个连通分量取一个网络名。如果用户已经手动添加了网络标签优先采用标签名否则用系统生成的编号比如N$1、N$2。6.2 导出网表文件网表格式很多我们演示一种简单的自定义格式和一种常见的 SPICE 格式。自定义格式示例$NET_NET1 R1.1 C2.2 U1.3 $ENDNET输出逻辑很简单遍历所有网络每个网络输出连接的引脚。SPICE 网表是比较经典的格式适用于电路仿真。一个简单示例* SPICE Netlist generated by MyEDA R1 N$1 0 10k C2 N$1 N$2 100nF V1 N$2 0 5V这里每个元件一行包含元件位号、连接节点和参数值。生成 SPICE 网表时需要注意不同器件类型的关键字和引脚顺序不同需要在导出器里做映射。6.3 网络标签与电源符号网络标签是一种特殊连接方式。一个网络标签虽然不画导线但它的文字名会标识一个网络。比如用户放置一个“VCC”标签并把标签放在某个引脚附近该引脚就自动归属到 VCC 网络中。实现上网络标签有一个坐标位置和文本。在 DRC 检查时程序会检查标签坐标附近是否存在引脚或导线端点若存在则把这个网络名赋值给对应节点。这就要在连通性分析时加入标签节点。电源符号如 VCC、GND本质也是一种特殊元件通常是单引脚元件在导出网表时可以视作电压源或全局网络。这一点在做仿真类 EDA 时尤其重要。7. 文件保存与加载原理图数据不能只存在内存里必须能够保存为文件并在下次打开时恢复。EDA 领域最常用的文本格式是 JSON 和 S-expression如 KiCad 的 .kicad_sch。JSON 直观、解析快、适合自研工具S-expression 更贴近 Lisp 风格适合需要和 KiCad 生态互通的项目。我们设计一个 JSON 格式的 .mysch 文件顶层结构如下{ format_version: 1.0, page_size: [1000, 700], components: [ { id: c1, reference: R1, value: 10k, footprint: 0805, symbol: RES, x: 12.5, y: 8.5, rotation: 0, mirrored: false, properties: {} } ], wires: [ { id: w1, net_name: N$1, segments: [ { x1: 12.5, y1: 8.5, x2: 25.0, y2: 8.5 } ] } ], net_labels: { VCC: [12.5, 18.5] } }保存时注意序列化的是“实例数据 符号引用名”而不是把完整符号图形塞进文件。符号图形通常由库加载如果库文件缺失打开图纸时会提示“符号未找到”。这种方式能显著减小文件体积并且让不同图纸共享符号库。当然如果你需要做“自包含”文件也可以把符号图形一并写入只是文件会大很多。KiCad 的做法是符号库文件单独存储原理图文件只存符号名这也是比较规范的做法。8. 常见问题与排查手册手搓原理图编辑器时最容易踩坑的我在表格里整理了一些典型问题和排查思路。问题现象常见原因解决思路鼠标放置元件时元件位置和鼠标错位屏幕坐标与世界坐标转换遗漏了缩放偏移或元件锚点不是期望位置统一走 viewport 转换函数不直接使用原始鼠标坐标导线连不上引脚引脚端点坐标没有转换为绝对坐标吸附阈值太小引脚被其他图形覆盖打印鼠标点和引脚坐标检查吸附函数和阈值合理设置阈值元件旋转后引脚坐标不对旋转只改了图形没有同步引脚坐标变换旋转后需对符号引脚做同样的坐标变换或导出网表时动态计算复制元件后原元件和副本连成同一个网络复制时把 net 信息一起复制没有为新实例重新生成网络复制后清空 net_name重新做连通性分析删除导线后网表里仍有网络没有重算连通性旧网络信息残留在引脚上删除操作后统一调用 analyze_connectivity缩放到很大时绘制卡顿重绘了所有图元没有做视口裁剪只绘制视口范围内的元件对大型图使用空间索引加速打开文件提示符号不存在库文件缺失或符号名不匹配检查库加载路径在保存时记录 symbols 清单在工程上还可以加一个调试面板实时显示鼠标世界坐标、当前选中对象、最近一次吸附结果这些信息对排查交互问题特别有帮助。9. 工程化与代码组织建议“手搓 EDA”并不代表代码可以随意写相反因为涉及图形、电气、文件、命令等多个复杂模块工程化组织更加重要。9.1 分模块设计建议至少分成以下模块schematic_editor/ ├── core/ │ ├── model.py # 元件、引脚、导线等数据类 │ ├── connectivity.py # 连通性分析 │ ├── netlist.py # 网表导出 │ └── document.py # 原理图文档管理 ├── gui/ │ ├── canvas.py # 画布控件 │ ├── viewport.py # 视图变换 │ ├── tools/ # 每种工具一个模块 │ │ ├── select_tool.py │ │ ├── wire_tool.py │ │ └── place_tool.py │ └── panels/ # 元件库面板、属性面板等 ├── library/ │ ├── manager.py # 元件库管理器 │ └── symbols/ # 符号定义文件 ├── io/ │ ├── json_serializer.py │ └── netlist_exporters/ └── tests/ ├── test_connectivity.py ├── test_netlist.py └── test_viewport.py工具模式Tool Pattern是非常值得采用的架构。把“选择”“画线”“放置元件”“放置网络标签”等操作拆成独立工具类每个工具统一处理鼠标进入、移动、按下、双击、键盘事件。这样你就不会在画布主控件里写一个几百行的 if-else 分支。9.2 命令模式与撤销重做我强烈建议从一开始就实现撤销/重做否则后面重构代价很大。撤销/重做通常使用命令模式一次性操作封装成一个Command对象包含do()和undo()方法。class Command: def do(self): raise NotImplementedError def undo(self): raise NotImplementedError class AddComponentCommand(Command): def __init__(self, schematic, instance): self.schematic schematic self.instance instance def do(self): self.schematic.add_component(self.instance) def undo(self): self.schematic.remove_component(self.instance)命令栈维护一个已执行列表和一个待撤销列表。每次操作执行do()并压栈撤销时弹出栈顶执行undo()新操作执行时清空重做栈。所有修改模型的操作都走命令模式不要在界面代码里直接改模型列表这样模型才可控。9.3 单元测试数据模型和连通性分析是可以不用界面直接测试的这组测试性价比极高。建议优先覆盖放置两个电阻用一根导线连接 1 脚和 2 脚检查连通性输出是否包含同一个网络。删除导线后网络数量是否减少。网络标签是否能把正确的引脚归入指定网络。序列化和反序列化后是否能保持坐标和连接关系一致。10. 总结与后续路线这篇文章从原理图编辑器的整体架构出发围绕核心数据模型、画布交互、导线绘制、电气连接、网表生成、文件保存和工程化组织等关键环节完整走了一遍手搓原理图编辑器的实现路径。通过实际的 Python 代码你应该已经能搭起一个最小可用的框架放元件、画导线、生成网表这三件事做通一个原理图编辑器的骨架就立起来了。接下来可以按下面路线继续深入第一步完善图形渲染细节比如引脚高亮、导线交叉点标记、总线表示。第二步增加元件库管理支持批量导入符号和封装。第三步实现 DRC 检查比如未连接引脚、重名网络、短路检查。第四步接入 PCB 编辑器把网表传递到布局布线阶段。第五步如果追求更专业的体验可以研究层次化设计、多图纸协作和云端协同。如果你正在做自己的 EDA 工具或者对源码感兴趣建议先跑通一个最小原型把最核心的“电气连接关系”打通再逐步丰富外观细节。原理图编辑器本质上不是一个“画图软件”而是一个“带图形界面的网表生成器”只要抓住这一条主线很多设计决策就不会跑偏。最后说一句手搓 EDA 是一个非常庞大的工程但也是一个硬核且极具成就感的领域。哪怕只是实现了一个能放电阻、能连线、能导出网表的小工具你对电子设计自动化的理解都会上一个台阶。如果这篇文章对你有所帮助欢迎收藏备用后续我们还可以继续聊 PCB 编辑器、DRC 引擎或者仿真集成。 手搓EDA原理图编辑器：核心数据模型与网表生成实战解析
各位硬件开发、嵌入式和对 EDA 工具链感兴趣的朋友大家好。在上一篇“手搓 EDA 软件”的汇报中我们聊了底层框架和工程管理收到了不少朋友的私信和讨论。说实话很多朋友对“自己动手写一个 EDA”这件事很感兴趣但最关心的问题往往是“原理图编辑器到底是怎么画出来的里面的元件库、导线、网络标签这些功能真要自己写该怎么拆”这篇汇报演出我们就聚焦在原理图编辑器上。不管你是准备开发自己的内部硬件设计小工具还是准备深入研究 KiCad、嘉立创EDA这类开源/国产EDA的底层机制亦或是想用 Python、C、Electron 做一款独立的原理图绘制应用这篇文章都会给你一条完整的实现思路。先明确一下本文的定位。我们不是写一篇产品测评也不是讲某款商业 EDA 软件怎么用而是“手搓”视角下的原理图编辑器技术拆解。我会以常见的桌面 GUI 技术栈为例比如 Python PySide6/PyQt、C Qt或者 TypeScript Canvas 2D 这类可以跑通的组合。本文核心重点关注一套原理图编辑器必须包含哪些核心模块每个模块的数据结构怎么设计鼠标交互怎么实现画布缩放平移怎么做电气连接信息如何保存以及最终怎么生成网表。为了方便演示文中代码以 Python 风格伪代码加可运行的核心类为主你在自己项目里用 C 或 TypeScript 重写时思路完全一致。1. EDA 原理图编辑器到底是什么1.1 从一块画布说起原理图编辑器表面上是“画元器件 连线”实际上它是硬件设计流程中的第一道电气信息入口。你画的不是图形而是电路连接关系。电阻、电容、芯片这些符号在原理图里本质都是带有引脚编号的元件实例每一条连线本质是引脚与引脚之间的网络连接关系。所以在设计原理图编辑器时首先要区分两个概念图形层屏幕上看到的线、矩形、圆、引脚、文字标注。电气层元件引脚、网络标签、连线之间的拓扑连接关系。商业 EDA 软件的核心就是这两层之间的映射与同步。说白了用户拖动元件时图形跟着走用户连线时程序要能判断这条线连到了哪个引脚、属于哪个网络用户复制元件时新的电气节点要一并生成。这个思路贯穿整个编辑器的开发。1.2 编辑器核心功能拆解作为一个可用的原理图编辑器功能上至少需要覆盖这些方面功能模块说明难点画布管理缩放、平移、网格对齐、光标坐标坐标转换与性能元件放置从元件库拖入、旋转、镜像、属性编辑数据一致性导线绘制水平/垂直走线、拐角自动处理、删除重连命中测试与拓扑更新电气连接引脚与导线端点自动吸附、网络标签关联全局网络编号选择与编辑框选、点选、拖动、复制、删除、撤销重做命令模式设计层次化设计子图、图纸符号、端口结构管理网表输出生成 Spice、KiCad netlist 或自定义格式数据遍历与序列化我们不可能一篇文章把以上全部写完所以本文挑选其中最关键的几块核心数据模型、画布交互、导线绘制、电气连接与网表生成以及文件序列化。2. 核心数据模型设计对象、引脚与连接原理图编辑器的数据模型是整棵树的根。代码可以重构界面可以换但数据模型一旦设计不好后续网表导出、DRC 检查都会很难受。下面我们来设计一套简洁且够用的模型。2.1 元件与符号的数据结构一个元件实例ComponentInstance由符号图形和属性组成。符号图形包括引脚位置和标识属性包括位号Reference、值Value、封装Footprint等。先看一段 Python 风格的模型定义# 文件路径schematic_model.py from dataclasses import dataclass, field from typing import List, Dict, Optional from enum import Enum class PinDirection(Enum): INPUT input OUTPUT output BIDIR bidir POWER power class PinType(Enum): BOOLEAN boolean TRI_STATE tri_state PASSIVE passive dataclass class Pin: 引脚定义 name: str # 引脚名字比如 VCC、GND、PA0 number: str # 引脚编号比如 1、2、3、14 x: float 0 # 引脚在元件符号坐标系下的 X 位置 y: float 0 # 引脚在元件符号坐标系下的 Y 位置 direction: PinDirection PinDirection.PASSIVE length: float 2.5 # 引脚电气连接点向外延伸的长度 net: Optional[str] None # 当前连接的网络名 dataclass class ComponentSymbol: 元件符号定义类似库里的符号模板 name: str pins: List[Pin] field(default_factorylist) # 图形图元线段、矩形、圆等这里用简化表示 shapes: List[dict] field(default_factorylist) # 包围盒 bbox: tuple (0, 0, 50, 50) def add_pin(self, pin: Pin): self.pins.append(pin) def get_pin(self, number: str) - Optional[Pin]: for p in self.pins: if p.number number: return p return None dataclass class ComponentInstance: 图纸上的元件实例 reference: str # 位号如 R1、C2、U1 value: str # 值如 10k、100nF、STM32F103 footprint: str symbol: ComponentSymbol None x: float 0 # 实例在图纸坐标系下的位置 y: float 0 rotation: float 0 # 旋转角度 mirrored: bool False # 是否镜像 properties: Dict[str, str] field(default_factorydict) def pin_absolute_position(self, pin: Pin) - tuple: 计算某个引脚在图纸上的绝对坐标 # 先考虑元件自身旋转和镜像再平移到 (self.x, self.y) # 这里为了演示只处理平移旋转镜像换算略 return (self.x pin.x, self.y pin.y)在这个模型里我们区分了两个层次ComponentSymbol是“模板”相当于元件库里存的元件符号ComponentInstance是“放到图纸上的实例”相当于画布里的一个具体元件。这样设计的好处是用一套符号模板可以放很多实例修改模板不会影响已经放置的实例除非你显式做“更新元件”操作。实际项目中建议把元件旋转、镜像放在ComponentInstance里因为同一个符号在图纸上可以有不同的朝向这样更灵活。C/Qt 工程中建议用 QGraphicsItem 的继承体系来实现但数据模型层不应该和图形视图层耦合这是我多次踩坑后的经验。2.2 导线与网络模型导线不是简单的一堆 Polyline它是由多个线段WireSegment组成的电气路径起点和终点要能精准吸附到引脚或另一条导线的端点。dataclass class WireSegment: 导线段 id: str x1: float y1: float x2: float y2: float net_name: Optional[str] None # 属于哪个网络 layer: str signal # 原理图一般用 signal 层 dataclass class Wire: 一条完整的导线由多个连续线段组成 id: str segments: List[WireSegment] field(default_factorylist) net_name: Optional[str] None def add_segment(self, segment: WireSegment): self.segments.append(segment) class Schematic: 一张原理图 def __init__(self): self.components: List[ComponentInstance] [] self.wires: List[Wire] [] self.net_labels: Dict[str, tuple] {} # 网络名 - 坐标 self.power_symbols: List[dict] [] self.page_size (1000, 700) def add_component(self, component: ComponentInstance): self.components.append(component) def add_wire(self, wire: Wire): self.wires.append(wire)网络Net在这里没有单独建类而是通过net_name来标识。后续做连通性分析时我们会从引脚出发沿导线追踪所有连接点把相同net_name的引脚归并成一个网络这才是最终网表的来源。2.3 坐标系统设计原理图编辑器至少有三套坐标符号坐标系定义元件库符号时使用的坐标中心通常是 (0,0) 或左上角。图纸坐标系元件放置到图纸后的实例坐标。屏幕坐标系视口滚动、缩放之后的像素坐标。用户编辑发生在图纸坐标系鼠标事件发生在屏幕坐标系两者之间需要一套可靠的转换函数。绝大多数图形框架比如 Qt、Canvas、WPF 都内置了矩阵变换直接使用即可。但如果你是想从零手写渲染一定要把“逻辑坐标”和“屏幕坐标”分开不要在鼠标事件里直接改模型坐标否则缩放一多数据就会乱。3. 画布与视图交互画布是编辑器和用户交互的窗口涉及缩放、平移、网格、选中高亮、拖拽、框选等交互。这些功能堆积在一起很容易写得像意大利面建议按职责拆分。3.1 视图区与场景区如果你选择 Qt 技术栈QGraphicsViewQGraphicsScene是很成熟的方案。如果你选择 Electron 或纯 Web 技术可以自己实现一个“场景管理器”。以 Qt 为例我们维护一个Viewport状态类# 文件路径viewport.py class Viewport: def __init__(self): self.scale 1.0 # 缩放比 self.offset_x 0 # 平移偏移 self.offset_y 0 self.grid_size 2.5 # 网格基准(mm) self.snap_enable True def screen_to_world(self, sx: float, sy: float) - tuple: 屏幕坐标转图纸坐标 wx (sx - self.offset_x) / self.scale wy (sy - self.offset_y) / self.scale return wx, wy def world_to_screen(self, wx: float, wy: float) - tuple: 图纸坐标转屏幕坐标 sx wx * self.scale self.offset_x sy wy * self.scale self.offset_y return sx, sy def snap(self, x: float, y: float) - tuple: 网格吸附 if not self.snap_enable: return x, y g self.grid_size return round(x / g) * g, round(y / g) * g这样鼠标移动、放置元件、绘制导线时都统一通过screen_to_world转为图纸坐标再进行网格吸附。最后再把模型坐标传回绘图函数。3.2 缩放与平移的实现细节缩放时一个常见的需求是“鼠标指向哪里就围绕哪里缩放”。这需要调整offset_x和offset_y保证鼠标指向的世界坐标在缩放前后不变。def zoom_at(viewport: Viewport, mouse_sx: float, mouse_sy: float, factor: float): # 缩放前鼠标指向的世界坐标 world_x, world_y viewport.screen_to_world(mouse_sx, mouse_sy) # 更新缩放值 new_scale viewport.scale * factor # 限制缩放范围 new_scale max(0.2, min(10.0, new_scale)) viewport.scale new_scale # 缩放后把世界坐标重新映射回鼠标位置反推出偏移 viewport.offset_x mouse_sx - world_x * new_scale viewport.offset_y mouse_sy - world_y * new_scale平移就简单了鼠标拖住空白区域时把 offset 加上鼠标移动的像素差值即可。注意在拖拽时不要让视图“跳变”需要记录按下时的鼠标位置。3.3 选中与框选点选很容易鼠标按下时遍历所有元件判断点是否落在元件的包围盒内。框选则需要一个矩形区域对每个元件做相交测试。对于有旋转的元件建议用符号的包围盒做粗判断再用多边形精确判断这在大多数框架里可以直接调用现成 API。一个比较隐蔽的坑元件引脚伸出元件本体之外时引脚本身也是“可选中区域”。用户可能想选中一个引脚来连线特别是在引脚密集的芯片上。所以命中测试要分成两层先测引脚再测元件。4. 元件库与元件放置没有元件库的原理图编辑器是没有灵魂的。手动创建元件库有两条路一是用代码定义符号二是用独立编辑器绘制符号后保存为库文件。本文采用前者重点是让你理解符号数据的来源。4.1 定义一个电阻符号我们用代码定义一个电阻# 文件路径library/resistor.py from schematic_model import ComponentSymbol, Pin, PinDirection, PinType def create_resistor_symbol() - ComponentSymbol: sym ComponentSymbol(nameRES) # 电阻符号引脚1号在左2号在右 sym.add_pin(Pin(name1, number1, x-10, y0, directionPinDirection.PASSIVE)) sym.add_pin(Pin(name2, number2, x10, y0, directionPinDirection.PASSIVE)) # 图形矩形示意 sym.shapes [ {type: rect, x: -5, y: -3, w: 10, h: 6}, ] sym.bbox (-10, -5, 20, 10) return sym这样的函数式定义适合少量元件。如果是几百上千个元件的库建议写成 JSON 或 YAML 文件运行时加载并注册。4.2 放置元件到图纸当用户从元件面板点击一个符号并点击画布时程序会创建一个ComponentInstance坐标为鼠标吸附后的图纸坐标。注意这里应该做“复制”不要直接把库里符号对象丢进图纸否则多个实例会共享同一个symbol引用。# 伪代码示例表示放置操作 def place_component( schematic, symbol, x, y, reference_prefixR ): # 根据当前图纸已有元件自动生成位号比如 R1、R2…… ref auto_generate_reference(schematic, reference_prefix) instance ComponentInstance( referenceref, valuesymbol.name, symbolsymbol, xx, yy, ) schematic.add_component(instance) return instance在交互上放置元件时可以跟随鼠标移动并且支持旋转按 R 键和镜像按 X 键。旋转的是实例自身的rotation属性而不是符号模板这点务必注意。5. 导线绘制从鼠标到电气连接导线绘制是原理图编辑器里最复杂也最有意思的部分。我们需要的不是“自由画线”而是“电气走线”。常规做法是支持以下交互鼠标点击起点可以是引脚端点、导线端点、或任意网格点。移动鼠标时自动生成水平或垂直的“预拉线”路径。点击中间点确认折线点继续延伸。双击或点击结束点完成导线绘制。如果终点落在已有引脚或导线上自动完成电气连接。5.1 电气吸附在鼠标移动时先做一步“电气吸附”而不是只做网格吸附。也就是寻找鼠标附近一定范围内的引脚端点和导线端点如果距离小于阈值就把当前点吸附到该端点上。def find_nearest_pin_or_wire_end(schematic, x, y, threshold2.0): best None best_dist threshold # 遍历所有元件引脚 for comp in schematic.components: for pin in comp.symbol.pins: px, py comp.pin_absolute_position(pin) dist ((px - x) ** 2 (py - y) ** 2) ** 0.5 if dist best_dist: best_dist dist best (pin, comp, pin) # 遍历所有导线端点 for wire in schematic.wires: for seg in wire.segments: for ex, ey in [(seg.x1, seg.y1), (seg.x2, seg.y2)]: dist ((ex - x) ** 2 (ey - y) ** 2) ** 0.5 if dist best_dist: best_dist dist best (wire_end, wire, ex, ey) return best这项吸附逻辑决定了用户连线的顺滑度。实际商业软件里还会对引脚连接点设置“热点”区域并对交叉线自动断开/连接但那是后话。5.2 预拉线与路径生成走线路径生成建议采用“贪心 优先水平/垂直方向”的算法。最简单的方式是如果起点和终点可以一条水平线或垂直线连上直接生成单段。如果不行生成“L 形”折线先横后竖或先竖后横。更复杂场景生成“Z 形”或自动绕障需要路由算法我们暂不展开。这里给出 L 形折线生成的示例def generate_route(x1, y1, x2, y2, prefer_horizontal_firstTrue): 生成直角走线路径返回拐点列表 points [(x1, y1)] if x1 x2 or y1 y2: # 一条直线 points.append((x2, y2)) return points if prefer_horizontal_first: # 先水平后垂直 points.append((x2, y1)) else: # 先垂直后水平 points.append((x1, y2)) points.append((x2, y2)) return points把拐点转换成导线线段时每相邻两个点就是一个WireSegment。5.3 从预拉线到正式导线用户双击或按下回车确认后程序才会把预拉线写入模型。为什么不在鼠标移动时直接写模型因为如果不加“确认”步骤画线过程中用户的鼠标抖动会产生大量零碎线段后续删除、移动、网表生成都会非常痛苦。正式写入时可以尝试对相邻共线线段合并减少线段数量def simplify_wire_segments(segments): 合并共线相邻线段 if len(segments) 2: return segments result [] current segments[0] for seg in segments[1:]: # 判断 current 和 seg 是否共线且首尾相连 same_h current.y1 current.y2 seg.y1 seg.y2 same_v current.x1 current.x2 seg.x1 seg.x2 if same_h or same_v: # 合并 current.x2 seg.x2 current.y2 seg.y2 else: result.append(current) current seg result.append(current) return result5.4 断路与连接更新当导线被删除时原有的电气连接关系随之消失。如果只是从列表里删掉Wire对象但引脚上残留的net_name没有更新那网表就会出现幽灵网络。所以删除导线后需要重新执行一次全图连通性分析刷新所有引脚的网络归属。这就是“数据驱动界面”的好处模型一旦更新重绘和网表都基于同一份数据。6. 电气连接与网表生成原理图编辑器的最终使命是把图形化的连接关系变成计算机可以处理的网表Netlist。下面我们聊一下连通性分析和网表导出。6.1 连通性分析连通性分析的输入是所有元件引脚、所有导线、所有网络标签。输出是每个网络有哪些引脚网络名是什么。一个常见的做法是“并查集”或 BFS 广度优先遍历。我们给每个连接点一个 ID然后用导线把这些点连起来。具体步骤如下def analyze_connectivity(schematic: Schematic): 重建所有网络的连接关系 # 1. 收集所有引脚与导线端点 nodes [] # 节点列表 node_id_map {} # 坐标 - 节点索引用于去重 def get_or_create_node(x, y): key (round(x, 3), round(y, 3)) if key not in node_id_map: idx len(nodes) node_id_map[key] idx nodes.append({x: x, y: y, pin: None, wire_id: None}) return node_id_map[key] # 2. 建立引脚到节点的映射 for comp in schematic.components: for pin in comp.symbol.pins: px, py comp.pin_absolute_position(pin) idx get_or_create_node(px, py) nodes[idx][pin] (comp, pin) # 3. 建立导线节点并关联 for wire in schematic.wires: wire_nodes [] for seg in wire.segments: idx1 get_or_create_node(seg.x1, seg.y1) idx2 get_or_create_node(seg.x2, seg.y2) wire_nodes.append((idx1, idx2)) # 4. 这里可以使用并查集合并所有属于同一条导线的节点 # 见下方 union-find 部分 # 5. 输出每个网络包含的引脚 # ...并查集代码如下用于合并网络class UnionFind: def __init__(self, n): self.parent list(range(n)) self.rank [0] * n def find(self, x): while self.parent[x] ! x: self.parent[x] self.parent[self.parent[x]] x self.parent[x] return x def union(self, a, b): ra, rb self.find(a), self.find(b) if ra rb: return if self.rank[ra] self.rank[rb]: self.parent[ra] rb elif self.rank[ra] self.rank[rb]: self.parent[rb] ra else: self.parent[rb] ra self.rank[ra] 1把所有引脚节点和导线节点做并查集合并后同一个根节点下的所有引脚就属于同一个网络。然后你可以为每个连通分量取一个网络名。如果用户已经手动添加了网络标签优先采用标签名否则用系统生成的编号比如N$1、N$2。6.2 导出网表文件网表格式很多我们演示一种简单的自定义格式和一种常见的 SPICE 格式。自定义格式示例$NET_NET1 R1.1 C2.2 U1.3 $ENDNET输出逻辑很简单遍历所有网络每个网络输出连接的引脚。SPICE 网表是比较经典的格式适用于电路仿真。一个简单示例* SPICE Netlist generated by MyEDA R1 N$1 0 10k C2 N$1 N$2 100nF V1 N$2 0 5V这里每个元件一行包含元件位号、连接节点和参数值。生成 SPICE 网表时需要注意不同器件类型的关键字和引脚顺序不同需要在导出器里做映射。6.3 网络标签与电源符号网络标签是一种特殊连接方式。一个网络标签虽然不画导线但它的文字名会标识一个网络。比如用户放置一个“VCC”标签并把标签放在某个引脚附近该引脚就自动归属到 VCC 网络中。实现上网络标签有一个坐标位置和文本。在 DRC 检查时程序会检查标签坐标附近是否存在引脚或导线端点若存在则把这个网络名赋值给对应节点。这就要在连通性分析时加入标签节点。电源符号如 VCC、GND本质也是一种特殊元件通常是单引脚元件在导出网表时可以视作电压源或全局网络。这一点在做仿真类 EDA 时尤其重要。7. 文件保存与加载原理图数据不能只存在内存里必须能够保存为文件并在下次打开时恢复。EDA 领域最常用的文本格式是 JSON 和 S-expression如 KiCad 的 .kicad_sch。JSON 直观、解析快、适合自研工具S-expression 更贴近 Lisp 风格适合需要和 KiCad 生态互通的项目。我们设计一个 JSON 格式的 .mysch 文件顶层结构如下{ format_version: 1.0, page_size: [1000, 700], components: [ { id: c1, reference: R1, value: 10k, footprint: 0805, symbol: RES, x: 12.5, y: 8.5, rotation: 0, mirrored: false, properties: {} } ], wires: [ { id: w1, net_name: N$1, segments: [ { x1: 12.5, y1: 8.5, x2: 25.0, y2: 8.5 } ] } ], net_labels: { VCC: [12.5, 18.5] } }保存时注意序列化的是“实例数据 符号引用名”而不是把完整符号图形塞进文件。符号图形通常由库加载如果库文件缺失打开图纸时会提示“符号未找到”。这种方式能显著减小文件体积并且让不同图纸共享符号库。当然如果你需要做“自包含”文件也可以把符号图形一并写入只是文件会大很多。KiCad 的做法是符号库文件单独存储原理图文件只存符号名这也是比较规范的做法。8. 常见问题与排查手册手搓原理图编辑器时最容易踩坑的我在表格里整理了一些典型问题和排查思路。问题现象常见原因解决思路鼠标放置元件时元件位置和鼠标错位屏幕坐标与世界坐标转换遗漏了缩放偏移或元件锚点不是期望位置统一走 viewport 转换函数不直接使用原始鼠标坐标导线连不上引脚引脚端点坐标没有转换为绝对坐标吸附阈值太小引脚被其他图形覆盖打印鼠标点和引脚坐标检查吸附函数和阈值合理设置阈值元件旋转后引脚坐标不对旋转只改了图形没有同步引脚坐标变换旋转后需对符号引脚做同样的坐标变换或导出网表时动态计算复制元件后原元件和副本连成同一个网络复制时把 net 信息一起复制没有为新实例重新生成网络复制后清空 net_name重新做连通性分析删除导线后网表里仍有网络没有重算连通性旧网络信息残留在引脚上删除操作后统一调用 analyze_connectivity缩放到很大时绘制卡顿重绘了所有图元没有做视口裁剪只绘制视口范围内的元件对大型图使用空间索引加速打开文件提示符号不存在库文件缺失或符号名不匹配检查库加载路径在保存时记录 symbols 清单在工程上还可以加一个调试面板实时显示鼠标世界坐标、当前选中对象、最近一次吸附结果这些信息对排查交互问题特别有帮助。9. 工程化与代码组织建议“手搓 EDA”并不代表代码可以随意写相反因为涉及图形、电气、文件、命令等多个复杂模块工程化组织更加重要。9.1 分模块设计建议至少分成以下模块schematic_editor/ ├── core/ │ ├── model.py # 元件、引脚、导线等数据类 │ ├── connectivity.py # 连通性分析 │ ├── netlist.py # 网表导出 │ └── document.py # 原理图文档管理 ├── gui/ │ ├── canvas.py # 画布控件 │ ├── viewport.py # 视图变换 │ ├── tools/ # 每种工具一个模块 │ │ ├── select_tool.py │ │ ├── wire_tool.py │ │ └── place_tool.py │ └── panels/ # 元件库面板、属性面板等 ├── library/ │ ├── manager.py # 元件库管理器 │ └── symbols/ # 符号定义文件 ├── io/ │ ├── json_serializer.py │ └── netlist_exporters/ └── tests/ ├── test_connectivity.py ├── test_netlist.py └── test_viewport.py工具模式Tool Pattern是非常值得采用的架构。把“选择”“画线”“放置元件”“放置网络标签”等操作拆成独立工具类每个工具统一处理鼠标进入、移动、按下、双击、键盘事件。这样你就不会在画布主控件里写一个几百行的 if-else 分支。9.2 命令模式与撤销重做我强烈建议从一开始就实现撤销/重做否则后面重构代价很大。撤销/重做通常使用命令模式一次性操作封装成一个Command对象包含do()和undo()方法。class Command: def do(self): raise NotImplementedError def undo(self): raise NotImplementedError class AddComponentCommand(Command): def __init__(self, schematic, instance): self.schematic schematic self.instance instance def do(self): self.schematic.add_component(self.instance) def undo(self): self.schematic.remove_component(self.instance)命令栈维护一个已执行列表和一个待撤销列表。每次操作执行do()并压栈撤销时弹出栈顶执行undo()新操作执行时清空重做栈。所有修改模型的操作都走命令模式不要在界面代码里直接改模型列表这样模型才可控。9.3 单元测试数据模型和连通性分析是可以不用界面直接测试的这组测试性价比极高。建议优先覆盖放置两个电阻用一根导线连接 1 脚和 2 脚检查连通性输出是否包含同一个网络。删除导线后网络数量是否减少。网络标签是否能把正确的引脚归入指定网络。序列化和反序列化后是否能保持坐标和连接关系一致。10. 总结与后续路线这篇文章从原理图编辑器的整体架构出发围绕核心数据模型、画布交互、导线绘制、电气连接、网表生成、文件保存和工程化组织等关键环节完整走了一遍手搓原理图编辑器的实现路径。通过实际的 Python 代码你应该已经能搭起一个最小可用的框架放元件、画导线、生成网表这三件事做通一个原理图编辑器的骨架就立起来了。接下来可以按下面路线继续深入第一步完善图形渲染细节比如引脚高亮、导线交叉点标记、总线表示。第二步增加元件库管理支持批量导入符号和封装。第三步实现 DRC 检查比如未连接引脚、重名网络、短路检查。第四步接入 PCB 编辑器把网表传递到布局布线阶段。第五步如果追求更专业的体验可以研究层次化设计、多图纸协作和云端协同。如果你正在做自己的 EDA 工具或者对源码感兴趣建议先跑通一个最小原型把最核心的“电气连接关系”打通再逐步丰富外观细节。原理图编辑器本质上不是一个“画图软件”而是一个“带图形界面的网表生成器”只要抓住这一条主线很多设计决策就不会跑偏。最后说一句手搓 EDA 是一个非常庞大的工程但也是一个硬核且极具成就感的领域。哪怕只是实现了一个能放电阻、能连线、能导出网表的小工具你对电子设计自动化的理解都会上一个台阶。如果这篇文章对你有所帮助欢迎收藏备用后续我们还可以继续聊 PCB 编辑器、DRC 引擎或者仿真集成。