如果让我评选“看起来简单、做起来非常复杂”的软件模块原理图编辑器一定排在前三。它表面上看是一块画布加一堆元器件图标实际上要同时处理图形表达和电气语义两套系统。这也是很多团队能用 Canvas 画出一个很像原理图的界面却很难把它做成一个能导网表、过 ERC、进 PCB 的真正 EDA 工具的原因。这篇文章要讨论的事情很明确一个原理图编辑器从软件工程角度拆开它的核心架构、数据模型、交互逻辑、规则检查到底是怎么设计的。我会先讲清楚原理图编辑器区别于普通画板的关键点然后给出一个基于 PySide6 的最小代码骨架带引脚捕捉、连线和简单的电气规则检查。无论你是做桌面应用、图形编辑器还是想转行进入 EDA 工具链这篇文章都能帮你建立一张完整的认知地图。很多教程把 EDA 软件描述得高不可攀但拆开看原理图编辑器不过是一个带电气语义的图形数据库。理解这一点比记住某个具体 API 重要得多。1. 为什么“原理图编辑器”值得自己拆一遍先抛出本文最核心的判断原理图编辑器本质上是一个以电气语义为核心的图形编辑器而不是普通的绘图工具。这句话值得多说几句。很多软件工程师第一次接触 EDA 软件时会觉得它不过是一个“高级版画图软件”能拖元器件、能画线、能缩放看起来和 Visio、draw.io 没有本质区别。但真正动手实现时会发现在原理图编辑器里画布上的每一根线、每一个引脚、每一个方框背后都绑定着一层“电气含义”——这根线连接了哪几个引脚这个元件的位号是什么这个引脚是输入还是输出如果把这一层信息丢掉画出来的图就只是一张没有灵魂的图片无法导网表、无法做规则检查、无法进入 PCB 设计流程。这也就是为什么现在业界对“EDA 软件安装”“EDA 工具链国产化”这类话题越来越关注。很多人以为 EDA 的难点在算法和仿真但实际落地时最容易被卡住的反而是基本原理图编辑器的架构设计怎么组织数据、怎么处理交互、怎么扩展规则。更值得拆的原因是原理图编辑器是 EDA 工具链的“入口”。几乎所有硬件设计流程都是从这里开始的原理图 → 网表 → PCB 布局布线 → 加工制造。如果入口的数据模型就设计错了后面每一步都要返工。这篇文章适合这样的读者做过图形编辑器或 Canvas 项目想进一步接触工业级软件的开发者。硬件工程师想理解自己每天用的 EDA 工具内部是怎么工作的。软件工程师希望进入 EDA、CAD 工具链方向但不知道从哪里入手。正在做内部工具、元件库管理系统的团队需要自研配合流程的辅助工具。读完之后你至少能回答三个问题原理图编辑器的图层和数据层是怎么分开的引脚捕捉和连线是怎么实现的一张原理图文件里到底保存了什么2. 原理图编辑器的整体架构原理图编辑器的架构可以拆成四个层次从内到外分别是模型层、视图层、交互层、规则层。模型层是最核心的部分它描述了一张原理图里有哪些元件、哪些引脚、哪些连线、哪些网络以及它们之间的关系。模型层完全不需要关心绘制、鼠标事件和界面布局它只负责维护数据结构和数据一致性。例如当你把一个元件的位号从 R1 改成 R2模型层要能感知到这是一次数据变更并且知道这可能影响唯一性检查。视图层负责把模型渲染到屏幕上。在 Qt 体系里这个角色通常由 QGraphicsScene 和 QGraphicsView 承担。场景中每个可见对象都是一个 Item元件的图形、引脚的小圆点、连线的折线都是 Item。视图层要解决的问题是怎么画、用什么颜色、缩放和平移时怎么刷新。交互层负责把鼠标、键盘事件翻译成模型操作。例如用户点了一下元件库里的电阻然后在画布上点了一下交互层要把这个动作解释为“在当前位置创建一个新的电阻元件”然后调用模型层的接口完成数据插入最后由视图层刷新画面。交互层是最容易“写着写着就乱”的部分因为它要同时处理坐标转换、选中的逻辑、吸附逻辑和撤销重做。规则层也就是电气规则检查ERC它是一组独立的逻辑模块负责扫描模型层的数据判断当前原理图是否有悬空引脚、重复位号、短路网络等错误。规则层不应该和视图层有直接耦合它应该像一组服务随时可以对当前模型做一次健康检查。这四个层之间数据流关系大概是这样用户操作 - 交互层 - 模型层变更 - 视图层刷新 - 规则层校验 - 反馈显示这里特别想强调第一点模型层和视图层必须分离这是整个架构设计中最低的一条底线。如果你的代码里鼠标坐标直接存在图形对象上元件的电气属性也挂在 QGraphicsItem 上那短期能跑通但一旦要做多文档、撤销重做、网络分析、PCB 同步就会寸步难行。3. 数据模型从图形到电气语义原理图编辑器要建模的核心概念其实不多大概就是下面这五类元件 Component原理图中被放置的实体比如电阻、电容、芯片。它有自己的位号reference如 R1、U1、C2、名称name如 74HC595、STM32F103、封装信息以及一组引脚。引脚 Pin元件的电气连接点是元件和外部世界交互的唯一通道。它需要记录编号、名称、电气类型输入、输出、电源、地、双向等以及在元件内部的相对坐标。连线 Wire一条起于某个引脚、终于另一个引脚的折线路径。连线只表达“存在物理连接”它不知道这条连接在电路上叫什么。网络 Net一组互相导通的引脚和连线的集合。它可以有名字比如 VCC、GND、NET1。网络的概念在网表和 PCB 设计里非常重要。属性 Attribute例如电阻的阻值、电容的容值、厂商料号、备注等。属性是键值对结构灵活扩展。一个常见的设计误区是把连线和网络混为一谈。我见过一些初级实现只画线不维护网络关系当用户拖动元件引脚时线还是断在原处整个连接关系就丢失了。正确做法是连线的本质是“网络的可视化表达式”你拖动引脚时应该去更新网络中的引脚坐标和连线路径而不是简单地删掉一条线再画一条线。下面是一个用 Python dataclass 定义的最小数据模型# 文件路径model.py from __future__ import annotations from dataclasses import dataclass, field from typing import Dict, List, Tuple PinCoordinate Tuple[float, float] dataclass class Pin: id: str # 引脚唯一标识如 pin_1 name: str # 引脚名称如 VCC number: str # 引脚编号如 1 electrical_type: str passive # input / output / power / ground / passive x: float 0.0 # 引脚在元件内部的相对坐标 y: float 0.0 dataclass class Component: reference: str # 位号如 R1 name: str # 元件名称如 Resistor pins: List[Pin] field(default_factorylist) x: float 0.0 # 元件在原理图中的位置 y: float 0.0 attributes: Dict[str, str] field(default_factorydict) dataclass class Wire: id: str points: List[PinCoordinate] field(default_factorylist) net_id: str dataclass class Net: id: str name: str wire_ids: List[str] field(default_factorylist) pin_refs: List[Tuple[str, str]] field(default_factorylist) # pin_refs 的元素是 (component_reference, pin_id)这段代码有几个设计点值得注意第一Pin 不直接引用 Component而是记录相对坐标。这样元件移动时引脚可以跟着坐标一起算出来不用维护额外的父子关系。第二Wire 只保存路径点不保存两端的引脚对象真正的连接关系在 Net 的 pin_refs 里维护。第三Net 保存的是字符串引用而不是对象引用这有利于后续做文件序列化和跨图复制。有了这个模型创建元器件、删除元器件、建立网络这些操作就变得非常清晰。甚至可以暂时不画界面先用单元测试把模型层的逻辑验证一遍。4. 图形视图与交互画布怎么做到“能拖能缩放”在桌面端做原理图编辑器原型PySide6/PyQt 的 QGraphicsView 框架是一个非常合适的选择。它内置了场景管理、碰撞检测、Item 选择、坐标变换能省掉大量底层造轮子的工作。先理解三个核心类的分工QGraphicsScene管理所有图形 Item 的容器负责维护场景坐标、Item 之间的关系。QGraphicsView负责把 Scene 渲染到屏幕上的可滚动窗口处理鼠标、键盘事件并完成场景坐标和视图坐标之间的转换。QGraphicsItem场景里每一个可绘制、可交互的对象比如元件图形、引脚节点、连线折线。原理图编辑器里元件 Item 通常是一个组合 Item外层是一个矩形图形内层是多个引脚子 Item。引脚使用小圆点或小方块表示便于捕捉。连线的 Item 则是根据模型里 Wire 的 points 绘制的一条折线。画布交互的核心无非是三类操作平移按住鼠标中键或空格拖动画布。在 QGraphicsView 中可以直接重写 mousePressEvent 和 mouseMoveEvent修改滚动条位置。缩放通过滚轮缩放设置 QGraphicsView 的 scale 方法。需要注意缩放的中心点应该跟随鼠标位置而不是固定在画布中心。网格吸附所有放置操作和移动操作坐标都对齐到一个固定网格比如 10 或者 25 个逻辑像素。这是原理图保持整洁的关键。这里有一个容易被新手忽略的细节缩放应该修改的是视图层的 Transform而不是直接改模型数据。也就是说模型层保存的坐标永远是“真实世界坐标”缩放只是视图层的一个显示变换。如果在模型里存了“屏幕坐标”一旦缩放所有数据就全乱了。5. 最小代码实现用 PySide6 搭一个原理图编辑器骨架下面从零开始搭一个最小原型。环境准备很简单只需要 Python 和一个 PySide6 依赖。没有特别复杂的“EDA 软件安装”过程实际上你只需要一条命令pip install PySide6注意这里使用的版本以安装时的最新稳定版为准。本文的重点是演示通用架构思路不绑定特定版本。项目的文件结构建议如下schematic_editor/ ├── main.py # 程序入口主窗口 ├── model.py # 数据模型 ├── items.py # QGraphicsItem 子类 └── editor.py # 编辑场景、交互逻辑后续扩展首先创建主窗口和一个空场景# 文件路径main.py import sys from PySide6.QtCore import Qt from PySide6.QtWidgets import ( QApplication, QMainWindow, QGraphicsScene, QGraphicsView, QToolBar, ) from PySide6.QtGui import QAction class SchematicEditor(QMainWindow): def __init__(self): super().__init__() self.setWindowTitle(手搓 EDA - 原理图编辑器迷你版) # 场景和视图 self.scene QGraphicsScene(self) self.scene.setSceneRect(0, 0, 2000, 1200) self.view QGraphicsView(self.scene) self.setCentralWidget(self.view) # 工具栏 self._build_toolbar() self._setup_state() def _build_toolbar(self): bar QToolBar(工具栏, self) self.addToolBar(bar) add_resistor_action QAction(添加电阻, self) add_resistor_action.triggered.connect(self._add_resistor) bar.addAction(add_resistor_action) bar.addSeparator() zoom_in_action QAction(放大, self) zoom_in_action.triggered.connect(lambda: self.view.scale(1.2, 1.2)) bar.addAction(zoom_in_action) zoom_out_action QAction(缩小, self) zoom_out_action.triggered.connect(lambda: self.view.scale(1 / 1.2, 1 / 1.2)) bar.addAction(zoom_out_action) def _setup_state(self): self.components [] self.next_reference_number 1 def _add_resistor(self): from model import Component, Pin comp Component( referencefR{self.next_reference_number}, nameResistor, pins[ Pin(idpin_1, name1, number1, electrical_typepassive, x-40, y0), Pin(idpin_2, name2, number2, electrical_typepassive, x40, y0), ], x300 self.next_reference_number * 30, y300, ) self.next_reference_number 1 from items import ComponentItem item ComponentItem(comp) self.scene.addItem(item) self.components.append(comp) def keyPressEvent(self, event): if event.key() Qt.Key_Delete: for item in self.scene.selectedItems(): self.scene.removeItem(item) else: super().keyPressEvent(event) if __name__ __main__: app QApplication(sys.argv) editor SchematicEditor() editor.show() sys.exit(app.exec())接着定义元件 Item。这里用最简方式绘制一个矩形代表元件本体并绘制两个引脚。# 文件路径items.py from PySide6.QtCore import QRectF, Qt from PySide6.QtGui import QColor, QPainter, QPen from PySide6.QtWidgets import QGraphicsItem class PinItem(QGraphicsItem): 引脚可视化节点绘制一个小圆点。 def __init__(self, pin, parentNone): super().__init__(parent) self.pin pin self.setPos(pin.x, pin.y) self.setFlag(QGraphicsItem.ItemIsSelectable, True) def boundingRect(self): return QRectF(-5, -5, 10, 10) def paint(self, painter, option, widgetNone): painter.setBrush(QColor(#007ACC)) painter.setPen(QPen(QColor(#003366), 1)) painter.drawEllipse(QRectF(-4, -4, 8, 8)) class ComponentItem(QGraphicsItem): 元件组合图形包含元件主体和引脚子项。 def __init__(self, component): super().__init__() self.component component self.setFlag(QGraphicsItem.ItemIsMovable) self.setFlag(QGraphicsItem.ItemIsSelectable) self.setPos(component.x, component.y) for pin in component.pins: pin_item PinItem(pin, self) pin_item.setFlag(QGraphicsItem.ItemSendsScenePositionChanges, True) def boundingRect(self): return QRectF(-50, -50, 100, 100) def paint(self, painter, option, widgetNone): painter.setPen(QPen(QColor(#444444), 2)) painter.setBrush(QColor(#FFFFFF)) painter.drawRect(self.boundingRect()) painter.drawText( self.boundingRect(), Qt.AlignCenter, f{self.component.reference}\n{self.component.name}, ) def itemChange(self, change, value): if change QGraphicsItem.ItemScenePositionHasChanged: self.component.x self.pos().x() self.component.y self.pos().y() return super().itemChange(change, value)在这个例子里ComponentItem 通过覆写 itemChange在移动结束时自动把位置同步回模型层。你可能会问为什么不直接移动 model 里的坐标因为视图层移动可能是连续的中间会有大量坐标变化如果每次都同步模型层也会跟着频繁更新。这里采用的方式是视图移动结束后把最终坐标写回模型。实际项目中还需要配合撤销/重做一起使用。运行这段代码后点几次“添加电阻”画布上会出现几个可拖拽的矩形删除键可以移除选中项。这就是一个最原始的原理图编辑器。6. 连线与引脚捕捉原理图编辑器的核心交互有了元器件放置能力下一个关键交互就是连线。连线看起来只是画一条折线但背后要解决两个问题怎么精确地捕捉到引脚怎么维护网络关系。引脚捕捉的核心算法是“最近距离阈值判断”鼠标点击后遍历场景中所有 PinItem计算鼠标在场景坐标下的位置与每个引脚中心点的距离。如果距离小于某个阈值比如 15 个逻辑像素就认为点击到了这个引脚。下面是一个最小实现# 文件路径editor.py from PySide6.QtCore import QPointF from PySide6.QtWidgets import QGraphicsSceneMouseEvent, QGraphicsScene from items import PinItem def find_nearest_pin(scene: QGraphicsScene, scene_pos: QPointF, threshold: float 15.0): 在场景坐标中寻找离 mouse_pos 最近的引脚。 best_pin_item None best_dist threshold for item in scene.items(): if isinstance(item, PinItem): pin_center item.scenePos() dist (pin_center - scene_pos).manhattanLength() if dist best_dist: best_dist dist best_pin_item item return best_pin_item有了引脚捕捉连线的状态机就清晰了。把连线交互看作一个两阶段过程第一阶段鼠标按下先做引脚捕捉。如果命中一个引脚记录这个引脚作为起点开始创建一条临时连线。第二阶段鼠标移动临时连线的末端跟随鼠标移动路径实时刷新。鼠标再次按下再做引脚捕捉。如果命中另一个引脚连接完成否则在当前位置落下一个折点继续延伸。连线的核心逻辑如下# 继续在 editor.py 中扩展 from PySide6.QtCore import Qt, QPointF, LineF from PySide6.QtGui import QPen, QColor from PySide6.QtWidgets import QGraphicsLineItem, QGraphicsPathItem class WireItem(QGraphicsPathItem): def __init__(self, wire_id: str, points: list[QPointF]): super().__init__() self.wire_id wire_id self.points points self._build_path() def _build_path(self): from PySide6.QtGui import QPainterPath path QPainterPath() if not self.points: return path.moveTo(self.points[0]) for p in self.points[1:]: path.lineTo(p) self.setPath(path) self.setPen(QPen(QColor(#007700), 2))在实际工程里WireItem 会根据模型数据重建路径而不是自己维护一份 points。这样模型层和视图层只有一个数据源避免“同一份数据两个副本”导致的不一致。连线完成后要立刻更新网络数据。最简单的方法是这样的流程连接建立时找到起点引脚和终点引脚。查阅当前网络集合判断这两个引脚是否已经属于某个网络。如果都不在网络里创建一个新 Net把两个引脚和这条 Wire 都加入其中。如果已经属于同一个网络只把新的 Wire 加进去。如果属于两个不同网络需要做网络合并。这一步往往被人忽略但它才是连线的真实目的。用户画线不是在绘图而是在描述“这些引脚是电气导通的”。没有网络模型你后续导出网表、做规则检查都没有依据。真实项目里连线还会有更复杂的细节连线经过引脚时自动吸附、拖动引脚时相连的线自动跟随、删除组件时清理相关网络。但核心的架构思路就是上面这套视图负责交互模型负责维护关系。7. 电气规则检查ERC原理图不能只看“画得好看”原理图画完不能直接拿去打板必须先做电气规则检查。ERC 的原理并不玄学它就是一组遍历模型数据的校验规则。最小可用的 ERC 至少应该覆盖以下几种情况悬空引脚某个元件的输入引脚或电源引脚没有连接到任何网络。重复位号同一种元件位号出现两次。单端网络一个网络只连接了一个引脚很可能是漏连了。短路猜测两个不同的电源网络被连到了一起。一个最小 ERC 实现大致是# 文件路径erc.py from typing import List, Tuple from model import Component, Net def check_erc(components: List[Component], nets: List[Net]) - List[str]: errors: List[str] [] # 1. 检查重复位号 reference_map {} for comp in components: if comp.reference in reference_map: errors.append(f重复位号: {comp.reference}) reference_map[comp.reference] comp # 2. 建立“引脚 - 网络”映射 pin_to_net: dict[Tuple[str, str], str] {} for net in nets: for comp_ref, pin_id in net.pin_refs: pin_to_net[(comp_ref, pin_id)] net.name # 3. 检查悬空引脚 for comp in components: for pin in comp.pins: if (comp.reference, pin.id) not in pin_to_net: if pin.electrical_type power: errors.append(f{comp.reference}.{pin.name} 电源引脚未连接) elif pin.electrical_type in (input, output): errors.append(f{comp.reference}.{pin.name} 信号引脚悬空) # 4. 检查单端网络 for net in nets: if len(net.pin_refs) 1: errors.append(f网络 {net.name} 只连接了 {len(net.pin_refs)} 个引脚) return errors把这套 ERC 逻辑接到编辑器里只需要在工具栏加一个“检查”按钮然后弹出一个列表显示错误即可。更贴近生产环境的做法是错误信息直接定位到具体元器件点击错误时视图自动跳转到对应的元件位置并用高亮色框出问题引脚。使用 ERC 时有一个关键点规则并不是越多越好而是要根据设计阶段选择。在原理图绘制早期可以只检查重复位号和单端网络在即将送 PCB 之前再开启全部检查。如果一个工具把所有规则拆出来硬编码在 UI 层扩展会很痛苦。更合理的是把规则抽象成插件接口每个规则只需要实现check(components, nets) - List[RuleViolation]这一个签名。8. 文件保存与加载原理图文件到底是什么原理图文件从内容上看就是模型层的序列化结果。所以只要模型设计得足够干净文件格式反而是一个相对次要的问题。常见的原理图文件格式有 JSON、XML、二进制以及产品自研的文本格式。JSON 适合原型的快速开发也容易调试。一个最小原理图文件长这样{ version: 1, components: [ { reference: R1, name: Resistor, x: 330.0, y: 300.0, attributes: { value: 10k }, pins: [ { id: pin_1, name: 1, number: 1, electrical_type: passive, x: -40.0, y: 0.0 }, { id: pin_2, name: 2, number: 2, electrical_type: passive, x: 40.0, y: 0.0 } ] } ], wires: [ { id: wire_1, net_id: net_1, points: [ [330.0, 300.0], [500.0, 300.0] ] } ], nets: [ { id: net_1, name: VCC, wire_ids: [wire_1], pin_refs: [ [R1, pin_1] ] } ] }对应的读写代码很简单# 文件路径file_io.py import json from model import Component, Pin, Wire, Net def save_schematic(components, wires, nets, path): data { version: 1, components: [ { reference: c.reference, name: c.name, x: c.x, y: c.y, attributes: c.attributes, pins: [ { id: p.id, name: p.name, number: p.number, electrical_type: p.electrical_type, x: p.x, y: p.y, } for p in c.pins ], } for c in components ], wires: [ { id: w.id, net_id: w.net_id, points: w.points, } for w in wires ], nets: [ { id: n.id, name: n.name, wire_ids: n.wire_ids, pin_refs: n.pin_refs, } for n in nets ], } with open(path, w, encodingutf-8) as f: json.dump(data, f, ensure_asciiFalse, indent2) def load_schematic(path): with open(path, r, encodingutf-8) as f: data json.load(f) components [] for c in data[components]: comp Component( referencec[reference], namec[name], xc[x], yc[y], attributesc.get(attributes, {}), pins[ Pin( idp[id], namep[name], numberp[number], electrical_typep.get(electrical_type, passive), xp[x], yp[y], ) for p in c.get(pins, []) ], ) components.append(comp) wires [Wire(**w) for w in data.get(wires, [])] nets [ Net( idn[id], namen[name], wire_idsn.get(wire_ids, []), pin_refs[(ref, pin_id) for ref, pin_id in n.get(pin_refs, [])], ) for n in data.get(nets, []) ] return components, wires, nets这里要特别强调一个工程习惯文件格式从第一天开始就必须带version字段。原因很简单原理图文件的生命周期可能跨越很多年元件库、引脚类型、网络结构都会演进。如果没有版本号旧文件打开时会直接报错或者更危险的是静默丢失某些新格式才有的字段。有了版本号就可以实现“旧版本文件正常打开新字段填默认值”的后向兼容策略。9. 常见问题与排查思路写原理图编辑器的过程中有几个问题出现频率非常高我整理成了一张排查表。问题现象可能原因排查方式解决方案元件拖拽后位置错乱模型坐标与视图坐标不同步移动结束后没有把 pos 写回模型在 itemChange 里打印组件坐标比较 scenePos 和 model.x/y统一在 itemChange 的 ScenePositionHasChanged 阶段同步坐标缩放后引脚捕捉不到捕捉阈值按屏幕像素计算缩放后场景坐标尺度变了打印 scenePos 和鼠标位置观察两者距离阈值使用场景坐标或者在 view 的 transform 上做换算连线没有形成网络只画了 WireItem没有更新模型中的 Net检查 Wire 和 Net 的字段是否有关联连线完成时立即调用网络合并逻辑删除元件后连线悬空删除时只移除图形 Item没有清理 Net 中的 pin_refs删除后遍历 Net 检查遗留引用封装统一的 remove_component 接口连带清理网络打开旧文件报错文件格式没有版本号字段变更无法兼容查看解析异常栈确认缺少的字段增加 version 字段和迁移逻辑缺失字段填默认值原理图数量变大后卡顿场景中 Item 数量过多每次交互都全量扫描使用 Qt Profiler 统计耗时位置对 Item 做空间索引或仅在局部区域重新绘制其中第 2 个问题是最容易踩坑的。原理图编辑器支持缩放后如果引脚捕捉用的是“屏幕像素距离”那么放大 200% 以后鼠标看起来离引脚很远却被判定为命中反过来缩小 50% 以后又会出现“看得见但点不中”的情况。解决思路是先把鼠标的视图坐标转换成场景坐标再计算场景坐标距离阈值使用固定的场景坐标单位。10. 工程建议与后续学习方向到这里一个最小原理图编辑器的轮廓已经很清晰了。最后再给出几条面向真实项目的工程建议。第一条模块边界要守好。模型层、视图层、交互层、规则层各司其职不要因为“改起来方便”就在视图层直接写模型逻辑。否则项目会随着规则增加而迅速腐化。第二条撤销/重做在设计初期就要考虑。不要等问题出现了再补。一个常见的做法是在模型层引入 Command 模式每次修改模型都封装成一个命令对象统一提供 execute 和 undo 方法。视图层只负责调用命令不直接操作数据。这样做虽然初期代码量会增加一点但后续添加批量编辑、脚本录制、协同编辑都会容易很多。第三条网络模型从第一天就开始建立不要等到导出网表再补。画一条线背后就立刻更新 Net 数据。等到导出网表时才发现模型里没有网络结构那时改造成本非常高。第四条元件库和原理图编辑器之间最好解耦。元件的图形不是由代码硬编码的矩形而是可以由“元件库描述”驱动的比如用一个 JSON 描述元件的引脚分布、图形轮廓、默认属性。这样就能实现“添加新元件不需要改编辑器代码”的目标。如果后续想深入可以从下面几个方向继续从原理图到网表导出把 Net 数据转换成分立器件连接表这是原理图编辑器连通 PCB 的点。元件库管理设计一个可扩展的元件描述规范支持多厂商、多封装、多原理图符号。原理图仿真联动把网络模型和 SPICE 仿真器对接实现真正的设计闭环。协同编辑多人同时编辑同一张原理图时如何解决网络、元件 ID 的冲突。对一个做软件的人来说把原理图编辑器拆到这个程度你会发现自己看 EDA 工具的眼光已经变了它不再是黑盒而是一层一层的软件架构、一次一次的数据同步、一条一条的规则校验。下一步与其停留在看资料不如自己动手把上面这段 PySide6 骨架代码补齐。真正写完一个能放元件、能连线、能导网的迷你原理图编辑器你对 EDA 的理解会上一个大台阶。 原理图编辑器架构拆解：从数据模型到ERC规则，用PySide6构建迷你EDA
如果让我评选“看起来简单、做起来非常复杂”的软件模块原理图编辑器一定排在前三。它表面上看是一块画布加一堆元器件图标实际上要同时处理图形表达和电气语义两套系统。这也是很多团队能用 Canvas 画出一个很像原理图的界面却很难把它做成一个能导网表、过 ERC、进 PCB 的真正 EDA 工具的原因。这篇文章要讨论的事情很明确一个原理图编辑器从软件工程角度拆开它的核心架构、数据模型、交互逻辑、规则检查到底是怎么设计的。我会先讲清楚原理图编辑器区别于普通画板的关键点然后给出一个基于 PySide6 的最小代码骨架带引脚捕捉、连线和简单的电气规则检查。无论你是做桌面应用、图形编辑器还是想转行进入 EDA 工具链这篇文章都能帮你建立一张完整的认知地图。很多教程把 EDA 软件描述得高不可攀但拆开看原理图编辑器不过是一个带电气语义的图形数据库。理解这一点比记住某个具体 API 重要得多。1. 为什么“原理图编辑器”值得自己拆一遍先抛出本文最核心的判断原理图编辑器本质上是一个以电气语义为核心的图形编辑器而不是普通的绘图工具。这句话值得多说几句。很多软件工程师第一次接触 EDA 软件时会觉得它不过是一个“高级版画图软件”能拖元器件、能画线、能缩放看起来和 Visio、draw.io 没有本质区别。但真正动手实现时会发现在原理图编辑器里画布上的每一根线、每一个引脚、每一个方框背后都绑定着一层“电气含义”——这根线连接了哪几个引脚这个元件的位号是什么这个引脚是输入还是输出如果把这一层信息丢掉画出来的图就只是一张没有灵魂的图片无法导网表、无法做规则检查、无法进入 PCB 设计流程。这也就是为什么现在业界对“EDA 软件安装”“EDA 工具链国产化”这类话题越来越关注。很多人以为 EDA 的难点在算法和仿真但实际落地时最容易被卡住的反而是基本原理图编辑器的架构设计怎么组织数据、怎么处理交互、怎么扩展规则。更值得拆的原因是原理图编辑器是 EDA 工具链的“入口”。几乎所有硬件设计流程都是从这里开始的原理图 → 网表 → PCB 布局布线 → 加工制造。如果入口的数据模型就设计错了后面每一步都要返工。这篇文章适合这样的读者做过图形编辑器或 Canvas 项目想进一步接触工业级软件的开发者。硬件工程师想理解自己每天用的 EDA 工具内部是怎么工作的。软件工程师希望进入 EDA、CAD 工具链方向但不知道从哪里入手。正在做内部工具、元件库管理系统的团队需要自研配合流程的辅助工具。读完之后你至少能回答三个问题原理图编辑器的图层和数据层是怎么分开的引脚捕捉和连线是怎么实现的一张原理图文件里到底保存了什么2. 原理图编辑器的整体架构原理图编辑器的架构可以拆成四个层次从内到外分别是模型层、视图层、交互层、规则层。模型层是最核心的部分它描述了一张原理图里有哪些元件、哪些引脚、哪些连线、哪些网络以及它们之间的关系。模型层完全不需要关心绘制、鼠标事件和界面布局它只负责维护数据结构和数据一致性。例如当你把一个元件的位号从 R1 改成 R2模型层要能感知到这是一次数据变更并且知道这可能影响唯一性检查。视图层负责把模型渲染到屏幕上。在 Qt 体系里这个角色通常由 QGraphicsScene 和 QGraphicsView 承担。场景中每个可见对象都是一个 Item元件的图形、引脚的小圆点、连线的折线都是 Item。视图层要解决的问题是怎么画、用什么颜色、缩放和平移时怎么刷新。交互层负责把鼠标、键盘事件翻译成模型操作。例如用户点了一下元件库里的电阻然后在画布上点了一下交互层要把这个动作解释为“在当前位置创建一个新的电阻元件”然后调用模型层的接口完成数据插入最后由视图层刷新画面。交互层是最容易“写着写着就乱”的部分因为它要同时处理坐标转换、选中的逻辑、吸附逻辑和撤销重做。规则层也就是电气规则检查ERC它是一组独立的逻辑模块负责扫描模型层的数据判断当前原理图是否有悬空引脚、重复位号、短路网络等错误。规则层不应该和视图层有直接耦合它应该像一组服务随时可以对当前模型做一次健康检查。这四个层之间数据流关系大概是这样用户操作 - 交互层 - 模型层变更 - 视图层刷新 - 规则层校验 - 反馈显示这里特别想强调第一点模型层和视图层必须分离这是整个架构设计中最低的一条底线。如果你的代码里鼠标坐标直接存在图形对象上元件的电气属性也挂在 QGraphicsItem 上那短期能跑通但一旦要做多文档、撤销重做、网络分析、PCB 同步就会寸步难行。3. 数据模型从图形到电气语义原理图编辑器要建模的核心概念其实不多大概就是下面这五类元件 Component原理图中被放置的实体比如电阻、电容、芯片。它有自己的位号reference如 R1、U1、C2、名称name如 74HC595、STM32F103、封装信息以及一组引脚。引脚 Pin元件的电气连接点是元件和外部世界交互的唯一通道。它需要记录编号、名称、电气类型输入、输出、电源、地、双向等以及在元件内部的相对坐标。连线 Wire一条起于某个引脚、终于另一个引脚的折线路径。连线只表达“存在物理连接”它不知道这条连接在电路上叫什么。网络 Net一组互相导通的引脚和连线的集合。它可以有名字比如 VCC、GND、NET1。网络的概念在网表和 PCB 设计里非常重要。属性 Attribute例如电阻的阻值、电容的容值、厂商料号、备注等。属性是键值对结构灵活扩展。一个常见的设计误区是把连线和网络混为一谈。我见过一些初级实现只画线不维护网络关系当用户拖动元件引脚时线还是断在原处整个连接关系就丢失了。正确做法是连线的本质是“网络的可视化表达式”你拖动引脚时应该去更新网络中的引脚坐标和连线路径而不是简单地删掉一条线再画一条线。下面是一个用 Python dataclass 定义的最小数据模型# 文件路径model.py from __future__ import annotations from dataclasses import dataclass, field from typing import Dict, List, Tuple PinCoordinate Tuple[float, float] dataclass class Pin: id: str # 引脚唯一标识如 pin_1 name: str # 引脚名称如 VCC number: str # 引脚编号如 1 electrical_type: str passive # input / output / power / ground / passive x: float 0.0 # 引脚在元件内部的相对坐标 y: float 0.0 dataclass class Component: reference: str # 位号如 R1 name: str # 元件名称如 Resistor pins: List[Pin] field(default_factorylist) x: float 0.0 # 元件在原理图中的位置 y: float 0.0 attributes: Dict[str, str] field(default_factorydict) dataclass class Wire: id: str points: List[PinCoordinate] field(default_factorylist) net_id: str dataclass class Net: id: str name: str wire_ids: List[str] field(default_factorylist) pin_refs: List[Tuple[str, str]] field(default_factorylist) # pin_refs 的元素是 (component_reference, pin_id)这段代码有几个设计点值得注意第一Pin 不直接引用 Component而是记录相对坐标。这样元件移动时引脚可以跟着坐标一起算出来不用维护额外的父子关系。第二Wire 只保存路径点不保存两端的引脚对象真正的连接关系在 Net 的 pin_refs 里维护。第三Net 保存的是字符串引用而不是对象引用这有利于后续做文件序列化和跨图复制。有了这个模型创建元器件、删除元器件、建立网络这些操作就变得非常清晰。甚至可以暂时不画界面先用单元测试把模型层的逻辑验证一遍。4. 图形视图与交互画布怎么做到“能拖能缩放”在桌面端做原理图编辑器原型PySide6/PyQt 的 QGraphicsView 框架是一个非常合适的选择。它内置了场景管理、碰撞检测、Item 选择、坐标变换能省掉大量底层造轮子的工作。先理解三个核心类的分工QGraphicsScene管理所有图形 Item 的容器负责维护场景坐标、Item 之间的关系。QGraphicsView负责把 Scene 渲染到屏幕上的可滚动窗口处理鼠标、键盘事件并完成场景坐标和视图坐标之间的转换。QGraphicsItem场景里每一个可绘制、可交互的对象比如元件图形、引脚节点、连线折线。原理图编辑器里元件 Item 通常是一个组合 Item外层是一个矩形图形内层是多个引脚子 Item。引脚使用小圆点或小方块表示便于捕捉。连线的 Item 则是根据模型里 Wire 的 points 绘制的一条折线。画布交互的核心无非是三类操作平移按住鼠标中键或空格拖动画布。在 QGraphicsView 中可以直接重写 mousePressEvent 和 mouseMoveEvent修改滚动条位置。缩放通过滚轮缩放设置 QGraphicsView 的 scale 方法。需要注意缩放的中心点应该跟随鼠标位置而不是固定在画布中心。网格吸附所有放置操作和移动操作坐标都对齐到一个固定网格比如 10 或者 25 个逻辑像素。这是原理图保持整洁的关键。这里有一个容易被新手忽略的细节缩放应该修改的是视图层的 Transform而不是直接改模型数据。也就是说模型层保存的坐标永远是“真实世界坐标”缩放只是视图层的一个显示变换。如果在模型里存了“屏幕坐标”一旦缩放所有数据就全乱了。5. 最小代码实现用 PySide6 搭一个原理图编辑器骨架下面从零开始搭一个最小原型。环境准备很简单只需要 Python 和一个 PySide6 依赖。没有特别复杂的“EDA 软件安装”过程实际上你只需要一条命令pip install PySide6注意这里使用的版本以安装时的最新稳定版为准。本文的重点是演示通用架构思路不绑定特定版本。项目的文件结构建议如下schematic_editor/ ├── main.py # 程序入口主窗口 ├── model.py # 数据模型 ├── items.py # QGraphicsItem 子类 └── editor.py # 编辑场景、交互逻辑后续扩展首先创建主窗口和一个空场景# 文件路径main.py import sys from PySide6.QtCore import Qt from PySide6.QtWidgets import ( QApplication, QMainWindow, QGraphicsScene, QGraphicsView, QToolBar, ) from PySide6.QtGui import QAction class SchematicEditor(QMainWindow): def __init__(self): super().__init__() self.setWindowTitle(手搓 EDA - 原理图编辑器迷你版) # 场景和视图 self.scene QGraphicsScene(self) self.scene.setSceneRect(0, 0, 2000, 1200) self.view QGraphicsView(self.scene) self.setCentralWidget(self.view) # 工具栏 self._build_toolbar() self._setup_state() def _build_toolbar(self): bar QToolBar(工具栏, self) self.addToolBar(bar) add_resistor_action QAction(添加电阻, self) add_resistor_action.triggered.connect(self._add_resistor) bar.addAction(add_resistor_action) bar.addSeparator() zoom_in_action QAction(放大, self) zoom_in_action.triggered.connect(lambda: self.view.scale(1.2, 1.2)) bar.addAction(zoom_in_action) zoom_out_action QAction(缩小, self) zoom_out_action.triggered.connect(lambda: self.view.scale(1 / 1.2, 1 / 1.2)) bar.addAction(zoom_out_action) def _setup_state(self): self.components [] self.next_reference_number 1 def _add_resistor(self): from model import Component, Pin comp Component( referencefR{self.next_reference_number}, nameResistor, pins[ Pin(idpin_1, name1, number1, electrical_typepassive, x-40, y0), Pin(idpin_2, name2, number2, electrical_typepassive, x40, y0), ], x300 self.next_reference_number * 30, y300, ) self.next_reference_number 1 from items import ComponentItem item ComponentItem(comp) self.scene.addItem(item) self.components.append(comp) def keyPressEvent(self, event): if event.key() Qt.Key_Delete: for item in self.scene.selectedItems(): self.scene.removeItem(item) else: super().keyPressEvent(event) if __name__ __main__: app QApplication(sys.argv) editor SchematicEditor() editor.show() sys.exit(app.exec())接着定义元件 Item。这里用最简方式绘制一个矩形代表元件本体并绘制两个引脚。# 文件路径items.py from PySide6.QtCore import QRectF, Qt from PySide6.QtGui import QColor, QPainter, QPen from PySide6.QtWidgets import QGraphicsItem class PinItem(QGraphicsItem): 引脚可视化节点绘制一个小圆点。 def __init__(self, pin, parentNone): super().__init__(parent) self.pin pin self.setPos(pin.x, pin.y) self.setFlag(QGraphicsItem.ItemIsSelectable, True) def boundingRect(self): return QRectF(-5, -5, 10, 10) def paint(self, painter, option, widgetNone): painter.setBrush(QColor(#007ACC)) painter.setPen(QPen(QColor(#003366), 1)) painter.drawEllipse(QRectF(-4, -4, 8, 8)) class ComponentItem(QGraphicsItem): 元件组合图形包含元件主体和引脚子项。 def __init__(self, component): super().__init__() self.component component self.setFlag(QGraphicsItem.ItemIsMovable) self.setFlag(QGraphicsItem.ItemIsSelectable) self.setPos(component.x, component.y) for pin in component.pins: pin_item PinItem(pin, self) pin_item.setFlag(QGraphicsItem.ItemSendsScenePositionChanges, True) def boundingRect(self): return QRectF(-50, -50, 100, 100) def paint(self, painter, option, widgetNone): painter.setPen(QPen(QColor(#444444), 2)) painter.setBrush(QColor(#FFFFFF)) painter.drawRect(self.boundingRect()) painter.drawText( self.boundingRect(), Qt.AlignCenter, f{self.component.reference}\n{self.component.name}, ) def itemChange(self, change, value): if change QGraphicsItem.ItemScenePositionHasChanged: self.component.x self.pos().x() self.component.y self.pos().y() return super().itemChange(change, value)在这个例子里ComponentItem 通过覆写 itemChange在移动结束时自动把位置同步回模型层。你可能会问为什么不直接移动 model 里的坐标因为视图层移动可能是连续的中间会有大量坐标变化如果每次都同步模型层也会跟着频繁更新。这里采用的方式是视图移动结束后把最终坐标写回模型。实际项目中还需要配合撤销/重做一起使用。运行这段代码后点几次“添加电阻”画布上会出现几个可拖拽的矩形删除键可以移除选中项。这就是一个最原始的原理图编辑器。6. 连线与引脚捕捉原理图编辑器的核心交互有了元器件放置能力下一个关键交互就是连线。连线看起来只是画一条折线但背后要解决两个问题怎么精确地捕捉到引脚怎么维护网络关系。引脚捕捉的核心算法是“最近距离阈值判断”鼠标点击后遍历场景中所有 PinItem计算鼠标在场景坐标下的位置与每个引脚中心点的距离。如果距离小于某个阈值比如 15 个逻辑像素就认为点击到了这个引脚。下面是一个最小实现# 文件路径editor.py from PySide6.QtCore import QPointF from PySide6.QtWidgets import QGraphicsSceneMouseEvent, QGraphicsScene from items import PinItem def find_nearest_pin(scene: QGraphicsScene, scene_pos: QPointF, threshold: float 15.0): 在场景坐标中寻找离 mouse_pos 最近的引脚。 best_pin_item None best_dist threshold for item in scene.items(): if isinstance(item, PinItem): pin_center item.scenePos() dist (pin_center - scene_pos).manhattanLength() if dist best_dist: best_dist dist best_pin_item item return best_pin_item有了引脚捕捉连线的状态机就清晰了。把连线交互看作一个两阶段过程第一阶段鼠标按下先做引脚捕捉。如果命中一个引脚记录这个引脚作为起点开始创建一条临时连线。第二阶段鼠标移动临时连线的末端跟随鼠标移动路径实时刷新。鼠标再次按下再做引脚捕捉。如果命中另一个引脚连接完成否则在当前位置落下一个折点继续延伸。连线的核心逻辑如下# 继续在 editor.py 中扩展 from PySide6.QtCore import Qt, QPointF, LineF from PySide6.QtGui import QPen, QColor from PySide6.QtWidgets import QGraphicsLineItem, QGraphicsPathItem class WireItem(QGraphicsPathItem): def __init__(self, wire_id: str, points: list[QPointF]): super().__init__() self.wire_id wire_id self.points points self._build_path() def _build_path(self): from PySide6.QtGui import QPainterPath path QPainterPath() if not self.points: return path.moveTo(self.points[0]) for p in self.points[1:]: path.lineTo(p) self.setPath(path) self.setPen(QPen(QColor(#007700), 2))在实际工程里WireItem 会根据模型数据重建路径而不是自己维护一份 points。这样模型层和视图层只有一个数据源避免“同一份数据两个副本”导致的不一致。连线完成后要立刻更新网络数据。最简单的方法是这样的流程连接建立时找到起点引脚和终点引脚。查阅当前网络集合判断这两个引脚是否已经属于某个网络。如果都不在网络里创建一个新 Net把两个引脚和这条 Wire 都加入其中。如果已经属于同一个网络只把新的 Wire 加进去。如果属于两个不同网络需要做网络合并。这一步往往被人忽略但它才是连线的真实目的。用户画线不是在绘图而是在描述“这些引脚是电气导通的”。没有网络模型你后续导出网表、做规则检查都没有依据。真实项目里连线还会有更复杂的细节连线经过引脚时自动吸附、拖动引脚时相连的线自动跟随、删除组件时清理相关网络。但核心的架构思路就是上面这套视图负责交互模型负责维护关系。7. 电气规则检查ERC原理图不能只看“画得好看”原理图画完不能直接拿去打板必须先做电气规则检查。ERC 的原理并不玄学它就是一组遍历模型数据的校验规则。最小可用的 ERC 至少应该覆盖以下几种情况悬空引脚某个元件的输入引脚或电源引脚没有连接到任何网络。重复位号同一种元件位号出现两次。单端网络一个网络只连接了一个引脚很可能是漏连了。短路猜测两个不同的电源网络被连到了一起。一个最小 ERC 实现大致是# 文件路径erc.py from typing import List, Tuple from model import Component, Net def check_erc(components: List[Component], nets: List[Net]) - List[str]: errors: List[str] [] # 1. 检查重复位号 reference_map {} for comp in components: if comp.reference in reference_map: errors.append(f重复位号: {comp.reference}) reference_map[comp.reference] comp # 2. 建立“引脚 - 网络”映射 pin_to_net: dict[Tuple[str, str], str] {} for net in nets: for comp_ref, pin_id in net.pin_refs: pin_to_net[(comp_ref, pin_id)] net.name # 3. 检查悬空引脚 for comp in components: for pin in comp.pins: if (comp.reference, pin.id) not in pin_to_net: if pin.electrical_type power: errors.append(f{comp.reference}.{pin.name} 电源引脚未连接) elif pin.electrical_type in (input, output): errors.append(f{comp.reference}.{pin.name} 信号引脚悬空) # 4. 检查单端网络 for net in nets: if len(net.pin_refs) 1: errors.append(f网络 {net.name} 只连接了 {len(net.pin_refs)} 个引脚) return errors把这套 ERC 逻辑接到编辑器里只需要在工具栏加一个“检查”按钮然后弹出一个列表显示错误即可。更贴近生产环境的做法是错误信息直接定位到具体元器件点击错误时视图自动跳转到对应的元件位置并用高亮色框出问题引脚。使用 ERC 时有一个关键点规则并不是越多越好而是要根据设计阶段选择。在原理图绘制早期可以只检查重复位号和单端网络在即将送 PCB 之前再开启全部检查。如果一个工具把所有规则拆出来硬编码在 UI 层扩展会很痛苦。更合理的是把规则抽象成插件接口每个规则只需要实现check(components, nets) - List[RuleViolation]这一个签名。8. 文件保存与加载原理图文件到底是什么原理图文件从内容上看就是模型层的序列化结果。所以只要模型设计得足够干净文件格式反而是一个相对次要的问题。常见的原理图文件格式有 JSON、XML、二进制以及产品自研的文本格式。JSON 适合原型的快速开发也容易调试。一个最小原理图文件长这样{ version: 1, components: [ { reference: R1, name: Resistor, x: 330.0, y: 300.0, attributes: { value: 10k }, pins: [ { id: pin_1, name: 1, number: 1, electrical_type: passive, x: -40.0, y: 0.0 }, { id: pin_2, name: 2, number: 2, electrical_type: passive, x: 40.0, y: 0.0 } ] } ], wires: [ { id: wire_1, net_id: net_1, points: [ [330.0, 300.0], [500.0, 300.0] ] } ], nets: [ { id: net_1, name: VCC, wire_ids: [wire_1], pin_refs: [ [R1, pin_1] ] } ] }对应的读写代码很简单# 文件路径file_io.py import json from model import Component, Pin, Wire, Net def save_schematic(components, wires, nets, path): data { version: 1, components: [ { reference: c.reference, name: c.name, x: c.x, y: c.y, attributes: c.attributes, pins: [ { id: p.id, name: p.name, number: p.number, electrical_type: p.electrical_type, x: p.x, y: p.y, } for p in c.pins ], } for c in components ], wires: [ { id: w.id, net_id: w.net_id, points: w.points, } for w in wires ], nets: [ { id: n.id, name: n.name, wire_ids: n.wire_ids, pin_refs: n.pin_refs, } for n in nets ], } with open(path, w, encodingutf-8) as f: json.dump(data, f, ensure_asciiFalse, indent2) def load_schematic(path): with open(path, r, encodingutf-8) as f: data json.load(f) components [] for c in data[components]: comp Component( referencec[reference], namec[name], xc[x], yc[y], attributesc.get(attributes, {}), pins[ Pin( idp[id], namep[name], numberp[number], electrical_typep.get(electrical_type, passive), xp[x], yp[y], ) for p in c.get(pins, []) ], ) components.append(comp) wires [Wire(**w) for w in data.get(wires, [])] nets [ Net( idn[id], namen[name], wire_idsn.get(wire_ids, []), pin_refs[(ref, pin_id) for ref, pin_id in n.get(pin_refs, [])], ) for n in data.get(nets, []) ] return components, wires, nets这里要特别强调一个工程习惯文件格式从第一天开始就必须带version字段。原因很简单原理图文件的生命周期可能跨越很多年元件库、引脚类型、网络结构都会演进。如果没有版本号旧文件打开时会直接报错或者更危险的是静默丢失某些新格式才有的字段。有了版本号就可以实现“旧版本文件正常打开新字段填默认值”的后向兼容策略。9. 常见问题与排查思路写原理图编辑器的过程中有几个问题出现频率非常高我整理成了一张排查表。问题现象可能原因排查方式解决方案元件拖拽后位置错乱模型坐标与视图坐标不同步移动结束后没有把 pos 写回模型在 itemChange 里打印组件坐标比较 scenePos 和 model.x/y统一在 itemChange 的 ScenePositionHasChanged 阶段同步坐标缩放后引脚捕捉不到捕捉阈值按屏幕像素计算缩放后场景坐标尺度变了打印 scenePos 和鼠标位置观察两者距离阈值使用场景坐标或者在 view 的 transform 上做换算连线没有形成网络只画了 WireItem没有更新模型中的 Net检查 Wire 和 Net 的字段是否有关联连线完成时立即调用网络合并逻辑删除元件后连线悬空删除时只移除图形 Item没有清理 Net 中的 pin_refs删除后遍历 Net 检查遗留引用封装统一的 remove_component 接口连带清理网络打开旧文件报错文件格式没有版本号字段变更无法兼容查看解析异常栈确认缺少的字段增加 version 字段和迁移逻辑缺失字段填默认值原理图数量变大后卡顿场景中 Item 数量过多每次交互都全量扫描使用 Qt Profiler 统计耗时位置对 Item 做空间索引或仅在局部区域重新绘制其中第 2 个问题是最容易踩坑的。原理图编辑器支持缩放后如果引脚捕捉用的是“屏幕像素距离”那么放大 200% 以后鼠标看起来离引脚很远却被判定为命中反过来缩小 50% 以后又会出现“看得见但点不中”的情况。解决思路是先把鼠标的视图坐标转换成场景坐标再计算场景坐标距离阈值使用固定的场景坐标单位。10. 工程建议与后续学习方向到这里一个最小原理图编辑器的轮廓已经很清晰了。最后再给出几条面向真实项目的工程建议。第一条模块边界要守好。模型层、视图层、交互层、规则层各司其职不要因为“改起来方便”就在视图层直接写模型逻辑。否则项目会随着规则增加而迅速腐化。第二条撤销/重做在设计初期就要考虑。不要等问题出现了再补。一个常见的做法是在模型层引入 Command 模式每次修改模型都封装成一个命令对象统一提供 execute 和 undo 方法。视图层只负责调用命令不直接操作数据。这样做虽然初期代码量会增加一点但后续添加批量编辑、脚本录制、协同编辑都会容易很多。第三条网络模型从第一天就开始建立不要等到导出网表再补。画一条线背后就立刻更新 Net 数据。等到导出网表时才发现模型里没有网络结构那时改造成本非常高。第四条元件库和原理图编辑器之间最好解耦。元件的图形不是由代码硬编码的矩形而是可以由“元件库描述”驱动的比如用一个 JSON 描述元件的引脚分布、图形轮廓、默认属性。这样就能实现“添加新元件不需要改编辑器代码”的目标。如果后续想深入可以从下面几个方向继续从原理图到网表导出把 Net 数据转换成分立器件连接表这是原理图编辑器连通 PCB 的点。元件库管理设计一个可扩展的元件描述规范支持多厂商、多封装、多原理图符号。原理图仿真联动把网络模型和 SPICE 仿真器对接实现真正的设计闭环。协同编辑多人同时编辑同一张原理图时如何解决网络、元件 ID 的冲突。对一个做软件的人来说把原理图编辑器拆到这个程度你会发现自己看 EDA 工具的眼光已经变了它不再是黑盒而是一层一层的软件架构、一次一次的数据同步、一条一条的规则校验。下一步与其停留在看资料不如自己动手把上面这段 PySide6 骨架代码补齐。真正写完一个能放元件、能连线、能导网的迷你原理图编辑器你对 EDA 的理解会上一个大台阶。