KiCad能直接导入.cir网表文件吗？如何正确转换与加载？

Question

KiCad **不能直接导入标准 SPICE `.cir` 网表文件**（如 LTspice、NGSPICE 生成的纯文本网表）。其原理图工具（Eeschema）仅支持通过“网表导入”功能加载 KiCad 自身生成的 `.net`（基于 XML 的网表）或兼容的 `.xml` 格式，而 `.cir` 是面向仿真器的指令式描述，不含元件封装、引脚映射、层次结构等 KiCad 所需的 PCB/原理图元数据。常见误区是试图双击 `.cir` 文件或拖入 Eeschema——这将失败或被忽略。正确做法分两步：① **反向工程重建原理图**：依据 `.cir` 中的器件（`.model`、`Xxxx` 子电路）、连接关系和节点名，在 Eeschema 中手动绘制并分配 KiCad 库元件；② **或借助脚本转换**（如 Python 解析 `.cir` → 生成 KiCad Schematic Symbol + Netlist），但需严格对齐引脚命名与封装。注意：`.cir` 中的 SPICE 特有语句（`.ac`、`.tran`）在 KiCad 中无意义，不可保留。本质是“网表复用”不等于“格式互通”，需以 KiCad 数据模型为基准重构。

Answer 1

```html

一、现象层：为什么双击 .cir 文件在 KiCad 中毫无反应？

用户常将 LTspice 导出的 amp.cir 拖入 Eeschema 窗口，或尝试通过「文件 → 导入 → 网表」加载，结果静默失败。根本原因在于 KiCad 的网表导入器（netlist_importer.cpp）仅注册了 .net（XML）、.xml 和 KiCad 6+ 新增的 .kicad_net 解析器，对 SPICE 文本语法零感知。该层问题属于“格式误判”，是所有后续障碍的起点。

二、模型层：KiCad 与 SPICE 的数据语义鸿沟

维度	KiCad 原理图模型	SPICE .cir 模型
元件标识	UUID + 库路径 + 引脚电气类型（input/output/bidir）	器件类型码（R1、Q2、XU1）+ 节点编号（n001, n002）
连接抽象	网络标签（Net Label）+ 层次端口（Hierarchical Pin）+ 总线定义	扁平节点名（无作用域）+ 子电路实例化（XU1 n1 n2 n3 uopamp）
元数据承载	封装（Footprint）、值（Value）、字段（Datasheet、Manufacturer）	纯仿真参数（.model QNPN NPN(IS=1E-14 BF=200)）

二者本质是不同领域的 DSL：KiCad 描述“可制造的物理系统”，SPICE 描述“可仿真的数学系统”。强行桥接不解决语义失配，只会引入引脚错位、模型丢失、层次坍塌等硬伤。

三、实践层：两种合规重构路径深度对比

1. 人工反向工程法：适用于小规模（≤50 器件）、高可靠性要求场景。需逐行解析 .cir，识别 .subckt 边界、提取 Xxxx 实例的端口顺序，并在 KiCad 中创建对应符号（Symbol），严格保证引脚名称（如 IN+ vs INP）与 SPICE 节点顺序一致；
2. 自动化脚本转换法：面向中大型设计（≥200 器件）。推荐 Python + pyspice 或自研解析器，输出 KiCad v7 兼容的 .kicad_sym（符号）和 .kicad_net（网表）。关键校验点：① 所有 .model 必须映射为 KiCad 字段（Spice_Model）；② 子电路调用必须转为层次符号实例；③ 删除全部 .ac/.dc/.tran 控制语句。

四、架构层：KiCad 网表导入机制源码级剖析

// src/eeschema/netlist.cpp: NetlistReaderFactory::CreateReader()
if( aFileName.EndsWith( wxS( ".net" ) ) || 
    aFileName.EndsWith( wxS( ".xml" ) ) ||
    aFileName.EndsWith( wxS( ".kicad_net" ) ) )
{
    return new NETLIST_READER_KICAD( aFileName );
}
// 注意：此处无 .cir / .sp / .txt 分支 —— 无注册即无支持

该机制由插件式工厂模式驱动，扩展需实现 NETLIST_READER 接口并注册 MIME 类型。社区曾提案 NETLIST_READER_SPICE，但因语义不可逆转换风险被 KiCad 核心团队否决（详见 RFC #1289）。

五、演进层：未来可能的协同范式（非兼容性方案）

graph LR A[SPICE .cir] -->|Python AST 解析| B(中间语义图
• 节点拓扑
• 器件类型图谱
• 子电路依赖树) B --> C{转换策略选择} C -->|人工审核模式| D[生成 KiCad 符号模板
+ 带注释的网表草案] C -->|全自动模式| E[调用 KiCad CLI
kicad-cli symbol create ...] D --> F[Eeschema 手动精修] E --> G[CI/CD 流水线验证
引脚映射一致性检查]

此路径不追求“一键导入”，而是构建“语义可信的双向追溯链”：每个 KiCad 元件标注其原始 SPICE 行号与模型声明位置，确保仿真-设计闭环可审计。

```