1. 从网表到JSON为什么这条导入链路值得单独拿出来讲画完原理图下一步就是把它变成PCB能读懂的语言。这个“翻译”过程行业里叫网表导出与导入。嘉立创EDA作为国内普及度极高的工具它的网表机制和传统OrCAD、Altium那一套有相似的地方也有自己的脾气。而JSON格式的引入让整个数据交换过程从“黑盒二进制”变成了“可读可改的文本”这对排查问题和做自动化处理来说价值非常大。我最初接触这条链路是因为一个多板卡项目。原理图由一位同事用OrCAD画PCB由另一位同事在嘉立创EDA里布局。两人各自干活没问题但一到网表对接就出岔子——不是封装对不上就是网络名被截断。后来我把整个流程拆开从网表生成、格式转换、JSON解析到最终导入每一步都做了记录和验证才把这条链路跑通。这篇文章就是那次折腾的完整总结适合正在做跨工具协作、或者想用脚本批量处理网表数据的同行参考。核心关键词先摆出来嘉立创EDA、网表、JSON、导入流程。这四个词贯穿全文后面每个章节都会围绕它们展开。不管你是刚接触EDA的新手还是已经画过几十块板子的老手只要涉及到网表在不同工具之间的流转这里面的细节都值得过一遍。2. 网表与JSON格式的核心概念拆解2.1 网表到底是什么用生活化类比讲清楚网表Netlist本质上就是一张“连接清单”。你可以把它想象成装修房子时的电路布线图哪个开关控制哪盏灯哪个插座接哪条线全部列在一张表上。PCB设计软件不关心你的原理图长什么样它只关心两件事——有哪些元件以及这些元件的引脚之间怎么连。网表里通常包含三类信息元件列表每个元件的位号如R1、C2、U3、封装类型如0402、SOP-8、值如10k、100nF。网络列表每个网络的名称如VCC、GND、CLK以及连接到该网络的所有引脚。属性信息元件的额外参数比如耐压值、精度、制造商料号等。传统网表格式有OrCAD的.net、Protel的.net、Allegro的.tel等它们大多是纯文本但格式各异。嘉立创EDA支持导入多种网表格式同时也支持导出自己的网表文件。2.2 JSON格式为什么被引入网表流程JSONJavaScript Object Notation是一种轻量级的数据交换格式用键值对的方式组织数据。它最大的好处是人眼可读、机器好解析。传统的网表文件虽然也是文本但格式紧凑、字段位置固定改一个字符就可能导致整个文件解析失败。JSON则不同它有明确的结构层次字段名和值一一对应容错性更好。在嘉立创EDA的语境下JSON格式的网表通常用于以下几种场景跨工具数据交换从OrCAD、Altium等工具导出网表后转换成JSON格式再导入嘉立创EDA。脚本自动化处理用Python、JavaScript等语言读取JSON网表批量修改元件属性、检查网络连接、生成BOM等。版本管理与差异对比JSON文件可以像代码一样用Git管理每次修改都能清晰看到差异。注意嘉立创EDA本身的原生工程文件格式并非JSON但它的导入接口支持解析JSON结构的网表数据。这一点在官方文档里写得比较简略实际使用时需要自己构造符合规范的JSON结构。2.3 嘉立创EDA网表导入的两种典型路径根据我的实际使用经验嘉立创EDA的网表导入主要有两条路径路径一直接导入传统网表文件。在嘉立创EDA的PCB编辑器中选择“导入网表”然后选取OrCAD、Protel等格式的网表文件。软件会自动解析并更新PCB中的元件和网络。这条路径适合大多数常规场景操作简单但遇到格式不兼容时排查困难。路径二通过JSON中转导入。先将传统网表转换为JSON格式对数据进行清洗和校验再通过嘉立创EDA的API或导入接口写入。这条路径适合需要批量处理、自动化校验或跨工具深度协作的场景。虽然步骤多但可控性强出问题容易定位。下面这张表对比了两条路径的核心差异对比维度直接导入传统网表通过JSON中转导入操作复杂度低几步点击完成中高需要脚本或手动转换容错能力低格式错误直接失败高可在JSON层校验和修正批量处理不适合非常适合排查难度高错误信息不明确低可逐字段检查适用场景单板、常规协作多板、自动化、跨工具3. 从OrCAD到嘉立创EDA网表导出的关键细节3.1 OrCAD导出网表的正确姿势OrCAD是很多公司原理图设计的首选工具它导出的网表格式丰富但默认设置往往不适合直接导入嘉立创EDA。我踩过的坑是直接用默认的.net格式导出结果嘉立创EDA导入后元件位号全部丢失网络名也被截断。正确的做法是在OrCAD中选择Other格式然后手动配置输出字段。具体步骤如下打开OrCAD Capture选中工程根节点。点击菜单栏Tools→Create Netlist。在弹出窗口中选择Other标签页。在Formatters中选择orTelesis.dll或orProtel2.dll这两个格式嘉立创EDA兼容性较好。勾选Create Netlist和View Output方便导出后立即检查。在Output Directory中指定导出路径文件名建议用英文避免中文路径导致解析异常。导出完成后用文本编辑器打开网表文件检查前几行是否包含元件位号和网络定义。如果看到类似(R1 R_0402 10k)和(VCC R1-1 C2-1)这样的结构说明格式基本正确。3.2 网表字段的清洗与规范化OrCAD导出的网表里经常有一些“脏数据”直接导入嘉立创EDA会报错。常见的脏数据包括位号重复同一张原理图里复制粘贴元件时位号没有自动重命名导致网表里出现两个R1。封装名不匹配OrCAD里的封装名是R0402嘉立创EDA的封装库叫0402名字对不上就找不到封装。网络名含特殊字符比如VCC_3.3V里的点号某些解析器会把它当成层级分隔符。空引脚定义有些元件的NC引脚在网表里被写成空连接导入后可能产生悬空网络。我的处理习惯是写一个简单的Python脚本读取网表文件逐行检查并修正这些问题。比如下面这段代码用来检测重复位号import re def check_duplicate_refs(netlist_path): refs [] with open(netlist_path, r, encodingutf-8) as f: for line in f: match re.match(r\((\w)\s, line) if match: refs.append(match.group(1)) duplicates set([r for r in refs if refs.count(r) 1]) if duplicates: print(f发现重复位号: {duplicates}) else: print(位号检查通过) return duplicates这段脚本虽然简单但在实际项目中帮我省了不少时间。每次导出网表后先跑一遍确认没有重复位号再往下走。3.3 封装库的预先对齐网表导入失败最常见的原因就是封装找不到。嘉立创EDA有自己的封装库体系和OrCAD的封装命名规则不完全一致。我的做法是提前在嘉立创EDA里建一个“封装映射表”把OrCAD里的封装名和嘉立创EDA里的封装名一一对应起来。比如OrCAD封装名嘉立创EDA封装名备注R04020402电阻电容通用C06030603电容SOP8SOP-8_3.9x4.9mm_P1.27mm需要指定具体尺寸QFN24QFN-24_4x4mm_P0.5mm需要指定引脚间距HDR2X5HDR-2x5_2.54mm排针这个映射表可以手动维护也可以用脚本自动生成。关键是在导入网表之前就把映射关系准备好而不是等导入报错了再一个个改。4. JSON格式网表的构造与解析实战4.1 一个标准JSON网表应该长什么样JSON网表没有统一的行业标准但根据嘉立创EDA的导入接口和常见实践一个可用的JSON网表通常包含以下几个顶层字段{ version: 1.0, components: [ { ref: R1, value: 10k, footprint: 0402, description: 贴片电阻 }, { ref: C1, value: 100nF, footprint: 0402, description: 贴片电容 } ], nets: [ { name: VCC, nodes: [R1-1, C1-1] }, { name: GND, nodes: [R1-2, C1-2] } ] }这个结构清晰明了components数组列出所有元件nets数组列出所有网络及其连接的引脚。引脚用位号-引脚号的格式表示比如R1-1表示电阻R1的第1脚。提示不同版本的嘉立创EDA对JSON字段名可能有细微差异。建议先用软件导出一个示例网表观察它的JSON结构再照着构造自己的数据。4.2 用Python把传统网表转成JSON有了上面的结构定义转换脚本就好写了。下面是一个完整的Python示例读取OrCAD风格的网表文件输出JSON格式import json import re def parse_netlist(netlist_path): components [] nets [] current_net None with open(netlist_path, r, encodingutf-8) as f: for line in f: line line.strip() # 匹配元件定义行例如 (R1 R_0402 10k) comp_match re.match(r\((\w)\s(\S)\s(\S)\), line) if comp_match: components.append({ ref: comp_match.group(1), footprint: comp_match.group(2), value: comp_match.group(3) }) continue # 匹配网络定义行例如 (VCC R1-1 C1-1) net_match re.match(r\((\w)\s(.)\), line) if net_match: net_name net_match.group(1) nodes net_match.group(2).split() nets.append({ name: net_name, nodes: nodes }) return { version: 1.0, components: components, nets: nets } if __name__ __main__: result parse_netlist(input.net) with open(output.json, w, encodingutf-8) as f: json.dump(result, f, indent2, ensure_asciiFalse) print(f转换完成{len(result[components])} 个元件{len(result[nets])} 个网络)这段脚本的核心逻辑是用正则表达式逐行匹配网表内容把元件和网络分别提取出来最后组装成JSON。实际使用时你可能需要根据网表的具体格式调整正则表达式。比如有些网表的元件定义是跨行的那就需要先做行合并再解析。4.3 JSON数据的校验与修正转换出来的JSON不能直接就用必须先校验。我通常检查以下几个方面元件位号唯一性用集合去重发现重复立即报错。网络节点有效性每个节点格式必须是位号-引脚号且位号必须在元件列表中存在。封装字段非空空封装会导致导入后元件无法放置。网络名合法性避免包含空格、点号、斜杠等特殊字符。下面是一个校验函数的示例def validate_json_netlist(data): errors [] refs [c[ref] for c in data[components]] # 检查位号重复 if len(refs) ! len(set(refs)): errors.append(存在重复位号) # 检查网络节点 for net in data[nets]: for node in net[nodes]: if - not in node: errors.append(f网络 {net[name]} 中节点 {node} 格式错误) continue ref node.split(-)[0] if ref not in refs: errors.append(f网络 {net[name]} 中节点 {node} 的位号 {ref} 不存在) # 检查封装 for comp in data[components]: if not comp.get(footprint): errors.append(f元件 {comp[ref]} 缺少封装信息) return errors校验通过后再把JSON文件导入嘉立创EDA。如果校验不通过根据错误信息逐项修正直到全部通过为止。5. 嘉立创EDA导入JSON网表的完整操作流程5.1 导入前的环境准备在嘉立创EDA里导入JSON网表之前有几件事必须提前做好第一确认软件版本。嘉立创EDA有标准版和专业版两个版本的导入接口不完全一样。专业版对JSON的支持更好建议用专业版做这类操作。我实测下来专业版v2.2以上版本对JSON网表的兼容性比较稳定。第二准备好封装库。网表里用到的所有封装必须已经在嘉立创EDA的库中存在。如果缺少某个封装导入时会提示“封装未找到”整个流程就会卡住。我的习惯是提前在嘉立创EDA的“封装管理器”里搜索一遍确认所有封装都能找到。第三备份当前工程。导入网表会覆盖PCB中现有的元件和网络连接。如果当前PCB已经布局布线了一部分导入前一定要先备份否则可能丢失工作成果。5.2 通过API导入JSON网表嘉立创EDA专业版提供了扩展API可以通过JavaScript脚本调用导入接口。下面是一个简化的示例// 假设已经通过文件读取获取了JSON数据 const netlistData { version: 1.0, components: [ { ref: R1, value: 10k, footprint: 0402 }, { ref: C1, value: 100nF, footprint: 0402 } ], nets: [ { name: VCC, nodes: [R1-1, C1-1] }, { name: GND, nodes: [R1-2, C1-2] } ] }; // 调用嘉立创EDA的导入接口 eda.pcb.importNetlist(JSON.stringify(netlistData)) .then(result { console.log(导入成功, result); }) .catch(error { console.error(导入失败, error); });这段代码的核心是eda.pcb.importNetlist方法它接收一个JSON字符串解析后更新PCB中的元件和网络。实际使用时你需要先通过eda对象获取当前PCB的上下文再调用导入方法。注意API的具体名称和参数可能随版本变化。建议在嘉立创EDA的扩展开发文档中确认最新的接口定义。5.3 手动导入的替代方案如果不想写脚本也可以手动操作。嘉立创EDA的PCB编辑器里有“导入网表”的菜单项支持选择JSON文件。操作路径大致是打开PCB工程进入PCB编辑器。点击菜单栏文件→导入→网表。在文件选择对话框中将文件类型切换为JSON Files (*.json)。选中之前生成的JSON文件点击打开。软件会弹出导入预览窗口显示将要添加的元件和网络。确认无误后点击“应用”完成导入。手动导入适合元件数量较少的场景。如果元件超过100个建议还是用脚本或API效率更高也更不容易出错。5.4 导入后的验证与修正导入完成后不要急着开始布局。先做几项验证元件数量核对在PCB的元件列表中数一下是否和原理图一致。网络连接检查用“网络检查”功能看是否有悬空网络或短路。封装位置确认所有元件是否都正确放置在了PCB边界内有没有跑到板框外面。位号显示确认每个元件的位号都正确显示没有重叠或丢失。如果发现问题最直接的排查方法是回到JSON文件逐字段检查。比如某个元件没导入成功就看它的footprint字段是否和嘉立创EDA库中的名称完全一致。大小写、空格、连字符都可能导致匹配失败。6. 常见问题与排查技巧实录6.1 导入失败的高频原因速查表问题现象可能原因解决方法提示“封装未找到”封装名不匹配或库中缺失检查封装映射表补充缺失封装元件位号全部丢失网表格式不兼容换用orTelesis.dll格式重新导出网络名被截断网络名含特殊字符在JSON中替换或删除特殊字符导入后PCB空白JSON结构不符合接口要求对照官方示例调整字段名和层级部分元件重复网表中位号重复用脚本检测并重命名重复位号引脚连接错误引脚号映射错误检查网表中引脚编号与封装引脚定义是否一致导入过程卡死JSON文件过大或格式错误分批导入先用小规模数据测试网络短路报警同一引脚被分配到多个网络检查网表确保每个引脚只属于一个网络6.2 我踩过的三个典型坑第一个坑OrCAD导出时选了默认格式。默认的.net格式字段分隔符和嘉立创EDA期望的不一样导入后元件全部堆在原点网络也全乱了。后来改用orTelesis.dll格式问题解决。这个坑的教训是不要用默认设置一定要手动选格式。第二个坑JSON里的引脚号用了字母。有些封装的引脚是A1、A2这样的编号但嘉立创EDA的网表解析器只认数字引脚号。结果导入后这些引脚全部悬空。解决办法是在JSON转换阶段就把字母引脚号映射成数字比如A1→1、A2→2同时在封装里做好对应。第三个坑网络名里的点号导致层级解析错误。比如VCC_3.3V被解析成了VCC_3和3V两个网络。后来我把所有网络名里的点号替换成下划线变成VCC_3_3V问题消失。这个坑提醒我网络命名要遵循简单原则避免特殊字符。6.3 提升导入成功率的几个实操心得先用小规模数据测试。不要一上来就导入整板网表。先拿两三个元件、两三个网络做一次完整流程确认没问题再放大。保持JSON字段名和官方示例一致。嘉立创EDA的导入接口对字段名比较敏感自己造字段名很容易失败。导入前关闭PCB的在线同步功能。有些版本在导入时会触发云端同步导致冲突。先在设置里关掉同步导入完成后再打开。保留中间文件。每次转换生成的JSON文件都留着按日期或版本号命名。出问题时可以快速回滚到上一个可用版本。用Git管理JSON网表。JSON是纯文本非常适合用Git做版本控制。每次修改都能看到具体差异比二进制文件方便得多。7. 自动化扩展用脚本批量处理多板网表7.1 批量转换的脚本框架如果一个项目有多块板卡每块板卡都有自己的原理图和网表手动一个个转换效率太低。我写了一个批量处理脚本遍历指定目录下的所有网表文件自动转换成JSON并校验import os import json from parse_netlist import parse_netlist, validate_json_netlist def batch_convert(input_dir, output_dir): if not os.path.exists(output_dir): os.makedirs(output_dir) for filename in os.listdir(input_dir): if not filename.endswith(.net): continue input_path os.path.join(input_dir, filename) output_path os.path.join(output_dir, filename.replace(.net, .json)) print(f处理: {filename}) data parse_netlist(input_path) errors validate_json_netlist(data) if errors: print(f 校验失败: {errors}) continue with open(output_path, w, encodingutf-8) as f: json.dump(data, f, indent2, ensure_asciiFalse) print(f 转换成功: {output_path}) if __name__ __main__: batch_convert(./netlists, ./json_netlists)这个脚本把转换和校验串在一起批量跑一遍就能把所有网表处理完。实际使用时可以根据项目需要增加更多校验规则比如检查特定网络是否存在、特定元件是否使用了指定封装等。7.2 与BOM生成的联动JSON网表还有一个好处是可以直接用来生成BOM。因为元件信息已经在JSON里结构化了提取出来就是一张BOM表。下面是一个简单的BOM生成函数def generate_bom(json_data): bom {} for comp in json_data[components]: key (comp[value], comp[footprint]) if key not in bom: bom[key] [] bom[key].append(comp[ref]) print(值\t封装\t数量\t位号) for (value, footprint), refs in sorted(bom.items()): print(f{value}\t{footprint}\t{len(refs)}\t{,.join(refs)})这个函数把相同值和封装的元件归为一组输出数量 and 位号列表。对于采购和焊接来说这张表比原始网表直观得多。7.3 版本差异对比的实用技巧用Git管理JSON网表后可以很方便地对比两个版本的差异。比如想知道这次改版删了哪些元件、加了哪些网络直接用git diff就能看到。但JSON的diff有时候不够直观因为字段顺序变化也会显示为差异。我的做法是在生成JSON时对键进行排序这样diff结果更干净json.dump(data, f, indent2, ensure_asciiFalse, sort_keysTrue)加上sort_keysTrue后每次生成的JSON字段顺序一致Git diff只会显示真正的内容变化不会因为字段顺序不同而产生噪音。8. 一些关于工具链选择的个人看法嘉立创EDA的网表导入功能和Altium、KiCad相比各有优劣。Altium的网表管理更成熟支持双向同步和实时更新KiCad的网表格式开放社区工具丰富嘉立创EDA的优势在于中文支持好、上手快、与打板流程无缝衔接。如果你的项目主要在国内打板嘉立创EDA的这条链路是值得花时间跑通的。JSON格式的引入让网表从“只能看不能改”变成了“可以编程处理”的数据。这对于需要做自动化、批量处理、跨工具协作的场景来说是一个很大的加分项。虽然目前嘉立创EDA对JSON网表的官方文档还不够详细但通过实际摸索和社区分享这条链路已经可以稳定跑通。我在最近一个项目中用这套流程处理了6块板卡、总计超过800个元件的网表导入从OrCAD导出到嘉立创EDA导入完成全程用了不到半小时。相比之前手动一个个改封装、对位号的方式效率提升非常明显。如果你也在做类似的事情希望这篇文章能帮你少走一些弯路。