先把结论放前面如果你的电脑里躺着几十上百个 EasyEDA Pro 工程又有一半以上可能要被丢进 KiCad 继续维护那 epro2kicad 这个命令行转换工具值得你花一个下午认真试试。它把 EasyEDA Pro 的 .epro 工程直接在终端里转成 KiCad 整套工程文件全程不需要打开两次图形界面不需要手动导出再导入更不需要对着两个 EDA 的弹窗反复核对网络表。这篇文章是我用这个工具把一批历史项目从 EasyEDA Pro 迁到 KiCad 的实操记录里面有安装方式、命令参数、转换原理和大量踩坑经验适合准备做库迁移、格式交接、自动化构建的硬件工程师。1. 为什么需要命令行转换工具1.1 EasyEDA Pro 与 KiCad 的格式鸿沟EasyEDA Pro国内习惯叫立创 EDA 专业版和 KiCad 虽然都是做 PCB 设计但底层的文件格式完全是两套逻辑。EasyEDA Pro 的工程文件本质上是自有格式的 JSON 数据包原理图和 PCB 的图形对象、网络连接、封装信息都塞在结构化的字段里而 KiCad 用的是文本化的 s-expression 格式从 .kicad_sch 到 .kicad_pcb 都是可以直接用编辑器打开的纯文本。这两者的差别有点像 Word 和 Markdown一个是私有打包一个是开放文本互相读取本来就不容易。更麻烦的是EasyEDA Pro 的文件结构里还大量引用立创自己的元件库体系和封装库体系很多封装在 KiCad 里根本没有对应名。就算人工导入也会遇到元器件找不到封装焊盘形状对不上这类问题。文件格式不兼容加上第三方库依赖导致两个工具之间不能靠简单的另存为完成转换。epro2kicad 做的事情就是在命令行里把这一层转换逻辑封装好解析 EasyEDA Pro 的工程数据重新组织成 KiCad 的工程结构并尽量把层、网络、封装、焊盘映射过去。1.2 图形界面导入的痛点其实 KiCad 官方和 EasyEDA Pro 本身都提供了一些交互式的导入办法EasyEDA 有导出 KiCad 格式的入口KiCad 也有导入其他 EDA 格式的插件。但是走图形界面的路有几个实际痛点特别明显。一是批量处理基本不可能。一次只能导一个工程如果有 30 个历史工程要迁移点 30 次鼠标只是入门麻烦的是每个工程都可能弹提示、卡在封装缺失上你必须在旁边盯着手工确认。二是可重复性差。同一个工程这次导入和那次导入选项稍微点错一点结果就不一样。三是无法审计。图形界面转完就完事日志不规范出了问题你很难复盘是哪一步转错的。四是不好集成进自动化流程。硬件团队一旦上了 CI 或者版本化工程管理就希望转换动作本身是一个可调用的命令而不是人类坐在屏幕前点点点。这些痛点本质上都是交互式操作和批量化、可脚本化之间的冲突。只要你有超过一个工程要转或者你希望转换步骤能写进自动化流水线命令行工具的优势就压过图形界面了。1.3 命令行的独特价值epro2kicad 这类工具最大的价值在于把转换变成了一条可复用的指令。输入是 .epro 工程文件输出是 .kicad_pro / .kicad_sch / .kicad_pcb 文件集合中间所有映射规则都可以用参数或配置文件控制。这样一来你可以写一个 for 循环批量处理整个目录下的工程也可以把转换命令写进 Jenkins 或 GitHub Actions每次提交 EasyEDA Pro 工程后自动生成 KiCad 版本。另一个容易被忽略的价值是差异对比。KiCad 的工程文件是文本格式转换完以后你可以直接放进 Git 做 diff看看这次转换改了什么、哪个焊盘漂移了、哪个网络断了。这一点是图形界面转换几乎做不到的。2. 工具安装与环境准备2.1 获取 epro2kicad 的几种方式epro2kicad 不是 KiCad 自带的组件所以要先安装。从我的经验来看它比较常见的发布方式是通过 Git 仓库分发源码需要你自己克隆代码后安装依赖也可能直接发布了 Python 包或 Rust 二进制。我这次用的是 Python 版本整个安装过程没有遇到编译障碍相对省心。如果你习惯从源码跑典型步骤是:git clone https://github.com/your-epro2kicad-repo/epro2kicad.git cd epro2kicad pip install -r requirements.txt python -m epro2kicad --version如果项目发布了包也可以直接通过 Python 包管理器安装。不同环境会略有差异但通常不会要求你手动编译 C 扩展所以整体安装成本很低。2.2 依赖与运行要求以 Python 实现为例我建议在 Python 3.9 以上的环境里运行。它依赖的库包括解析 JSON 用的标准库、处理命令行参数用的 click 或 argparse、以及一些文件处理和日志库。此外如果工具支持读取加密或者压缩过的工程包可能还会依赖解压库。反正我自己的建议是在开始转换之前先建一个虚拟环境避免和系统里其他 Python 工具打架。KiCad 本身也需要安装而且要保证版本不能太旧。epro2kicad 输出的工程格式是 KiCad 6 以后的 s-expression 格式如果你电脑上还只有 KiCad 5可能打不开生成的工程。这也是我后面反复强调版本匹配的原因。转换工具在生成文件时通常会按照某个目标版本来组织内容版本不一致很可能会出现格式虽然生成了但打开就报错的情况。2.3 快速验证安装装好以后不要急着转大工程先跑一下帮助命令确认工具正常epro2kicad --help正常能看到子命令列表比如 convert、inspect、list-layers 之类。然后再准备一个最小的测试工程最好是新建一个只有一个原理图页、一个 PCB 的简单项目先跑一遍完整转换确认打开后的 PCB 至少能正常显示再去处理复杂的板子。这一步能帮你把问题和工具本身的 bug 区分开。3. 核心命令详解与转换实操3.1 基本转换命令最核心的命令是 convert基本的用法非常直白epro2kicad convert ./demo.epro -o ./kicad_out命令行里的 demo.epro 是 EasyEDA Pro 的工程文件kicad_out 是输出目录。执行完以后输出目录里会多出配套的工程文件。如果你的 EasyEDA Pro 工程是原理图和 PCB 一体的那么转换后会同时生成原理图文件和 PCB 文件不需要分别指定。第一次跑的时候我建议打开日志输出观察每条转换信息epro2kicad convert ./demo.epro -o ./kicad_out --verbose日志里会明确告诉你当前在解析什么对象、映射哪一层、跳过哪个封装。这一步特别重要因为你能够看到工具在哪些地方做了取舍哪些东西被丢弃了。很多工程师拿到转换结果后直接打开 KiCad看到一堆封装缺失、网络丢失就开始骂工具不行。其实工具早就打了警告只是你开着默认日志没看。3.2 常用参数与映射配置epro2kicad 的转换参数里我实际用得最多的是下面这几个参数作用使用建议-o / --output指定输出目录每次都用独立目录方便对比--verbose显示详细日志初次转换务必开启--board-only只转 PCB跳过原理图原理图本来就有问题的工程先用这个隔离--schematic-only只转原理图需要单独处理原理图时用--format 6/7/8指定 KiCad 目标版本必须和你安装的 KiCad 主版本一致--skip-libraries不自动搜索缺的封装库库目录混乱时控制转换范围--map-file xxx.json指定自定义映射规则项目有固定封装命名规则时用这个表格看起来简单但实际用起来每个参数都可能影响最终结果。尤其是 --format 这个参数我曾经在一台只装了 KiCad 7 的机器上回忆着默认值没管就直接转。工具默认生成的是它自己批次对应的目标版本结果转完的 .kicad_pcb 打开就报解析错误。后来强制指定 --format 7 重新转换问题立刻消失。3.3 一个完整实例的转换记录我自己最先拿来做测试的是一块双电机驱动板板子上有两颗大功率 MOS、一组 H 桥、若干限流电阻和各种接插件。转换命令如下epro2kicad convert ./motor_driver.epro -o ./motor_driver_kicad --format 7 --verbose转换过程比我想象的快一个三四十个元件的板子大概两三秒就完成了。日志里能看到它在读取 .epro 工程数据然后逐层扫描 PCB 的形状、覆铜、丝印、钻孔文件。生成的文件包括:motor_driver.kicad_proKiCad 工程文件motor_driver.kicad_sch原理图文件motor_driver.kicad_pcbPCB 文件motor_driver.kicad_prt如果版本支持等打开 PCB 后板子外形、走线、焊盘基本都在。但我也发现丝印层上不少文本变成了默认字体以前在 EasyEDA Pro 里用中文标注的电源输入电机A这些字符串在 KiCad 里要么变成问号要么变成方框。这是字体映射的问题后面我会专门讲。3.4 转换结果的目录结构转换成功后建议不要直接把输出目录里的文件拖出来乱放。KiCad 工程通常是一个目录加若干工程文件的结构你最好让 .kicad_pro、.kicad_sch、.kicad_pcb 保持同一个目录。如果工具还输出了封装备份和缓存目录也不要急于删掉因为这些文件对于后续同步元件库非常有用。有一个细节KiCad 的 .kicad_sch 和 .kicad_pcb 都是文本文件转换完之后你可以用文本编辑器打开确认网络名、焊盘坐标、覆铜区域是否合理。第一次看到这么直观的 EDA 工程我是有点震惊的配合文本搜索定位某个网络名比在图形界面里找快多了。这也是我强烈建议硬件工程师适应 KiCad 格式的原因之一。4. 转换原理与映射规则4.1 从 epro 的 JSON 结构说起要理解 epro2kicad 为什么能转为什么要这么转得先看看 EasyEDA Pro 工程文件的内部结构。简单来说.epro 是一个容器里面用 JSON 描述了原理图页面的符号、连线、网络标签、PCB 里层的图形、走线、过孔和整板信息。工具做的第一件事不是直接把它当成 PCB 文件去读而是先解包、解析 JSON再建立一套中间数据模型。这个中间数据模型很重要。它有点像翻译过程中的语义层先把 EasyEDA Pro 里的对象变成中性的元器件、网络、层、封装描述然后再把这些描述输出成 KiCad 的 s-expression。好处是将来 EasyEDA Pro 改版了工具作者只要改前端的解析器而不用重写 KiCad 生成器。4.2 层、封装、焊盘的映射逻辑PCB 的层映射是转换里最核心的部分。EasyEDA Pro 的信号层命名和 KiCad 不一样工具需要按照默认规则把 EasyEDA Pro 的顶层对应到 F.Cu底层对应到 B.Cu中间信号层对应到 In1.Cu 到 In30.Cu。丝印层也是一样顶层丝印对应 F.Silkscreen底层丝印对应 B.Silkscreen。如果板子上有机械层或者开窗层工具一般会映射到 KiCad 的 Edge.Cuts 或 User.Drawings但这部分就要小心了因为不同的 EasyEDA Pro 版本对开窗层的使用习惯并不一致转换后必须人工核对。焊盘的映射要复杂一些。EasyEDA Pro 里的焊盘形状有圆形、方形、圆角矩形、异形焊盘等KiCad 的焊盘模型虽然也有类似描述但参数细节不一样。比如同样是矩形焊盘EasyEDA Pro 通过角半径、宽度、高度描述KiCad 可能还要关心焊盘旋转角度、相对位置。工具转换的时候如果直接把字段搬过去很可能出现角半径丢失或者旋转量差异这在连接器焊盘上尤其常见。我看到的现象是排针、贴片电阻电容这类简单封装基本能完美转换而带有圆形挖空、异形散热焊盘的封装转出来之后需要手工修一下。封装映射又是另一个坑。EasyEDA Pro 里元件引用的封装名往往带了立创库的命名特征比如CAP-TH_5x11mm这种KiCad 自带库里未必有同名的封装。工具通常提供两种策略一是尝试根据尺寸参数自动生成封装文件二是把缺失的封装记录到日志里让你在 KiCad 里手动补。我个人更偏好第二种至少不会出现装错封装的风险。4.3 一定会丢的东西任何转换工具都不可能 100% 无损epro2kicad 也一样。常见的丢失项包括EasyEDA Pro 的私有属性字段比如自定义的 BOM 参数、采购链接、制造商编号部分 3D 模型路径尤其是立创商城自带的 step 模型关联文档级设置比如图纸模板、自定义标题栏复用模块和子图逻辑如果原理图里用了大量模块复用转换后很可能会被展开成普通图块中文文本的原始字体样式理解这些丢失项不是为了劝退你而是为了在转换前做好心理准备。我的原则是PCB 的物理连接、覆铜、走线、焊盘这些决定电路能否工作的信息优先级最高丝印上的中文标注、自定义属性这些锦上添花的信息转完再花时间补不值得在转换前花大量时间做格式对齐。5. 常见问题排查与避坑清单5.1 封装库缺失怎么办这是我最常被问的问题也是转换后打开 KiCad 第一眼最容易发现的毛病一堆封装修补符。处理原则很简单先判断这个封装是不是标准封装。如果是标准封装比如 0805 电阻电容、SOT-23 晶体管、DIP-8 芯片你直接在 KiCad 自带的库列表里搜索替换就行不需要从 EasyEDA Pro 那边挣扎。如果不是标准封装而是定制化的异形封装建议把 EasyEDA Pro 里对应的封装信息导出然后在 KiCad 封装编辑器里照着参数重新画一个。千万不要图省事随便找尺寸相近的封装顶上热焊盘或散热焊盘尺寸差一点生产就可能出问题。如果你想批量处理可以利用工具提供的 --map-file 参数把 EasyEDA Pro 的封装名映射到 KiCad 的标准库封装名。比如{ RES-0805: Resistor_SMD:R_0805_2012Metric, CAP-0805: Capacitor_SMD:C_0805_2012Metric }这种映射文件一次配置以后所有工程都能复用。我后来把项目里常用的五十多个封装都整理到了映射文件里转换旧工程的速度明显快了很多。5.2 字体乱码与汉字标注转换后打开原理图或 PCB最扎眼的就是原先的中文标注变成了一串方框。原理很简单KiCad 默认的西文字体不含中文字形而 EasyEDA Pro 里你用的中文字体在 KiCad 里根本不存在。解决方案有三个层次。第一个层次是治标把不在丝印层的中文注释删掉把需要在板子上体现的标注改成英文比如电源输入改成PWR IN。生产上大多数丝印标注用英文完全够用还能让板子更整洁。第二个层次是治本如果是原理图里的中文注释在 KiCad 里用文本工具重新录入借助系统字体渲染显示没问题。第三个层次是给工具做字体映射让转换后的文本使用一个支持中文的字体文件。不过老实说这条路径并不总是可靠因为 KiCad 本身对自定义字体的把持比较严格你最终可能还是要接受手工调整。5.3 网络丢失和覆铜异常转换后网络丢失多半不是工具把网络线弄丢了而是网络名的映射规则出了问题。比如 EasyEDA Pro 里一个网络叫VCC_5V0在 KiCad 里可能因为非法字符或长度限制被截断导致原本应该连接的网络被分成了两个弱连接域。出现这种问题时你可以在 .kicad_pcb 文件里搜索网络名看看是否有类似截断的字符串。覆铜是另一个高频雷区。转换后的覆铜区域不是自动填充状态里面的热焊盘连接和网格线都需要在 KiCad 里重新执行一遍覆铜填充。这是 KiCad 的正常行为不是 bug。你打开 PCB 编辑器按一下 B 键或菜单里的 Fill All Zones覆铜才会真正铺出来。另外转完以后覆铜与焊盘的连接方式可能还是 EasyEDA Pro 的散热连接设置如果生产厂家反馈铜皮连接异常优先检查覆铜热焊盘的规则。5.4 焊盘和过孔参数对不上焊盘尺寸对不上最常见的原因是单位换算或精度舍入。EasyEDA Pro 默认单位有时是 mm有时在描述毫米小数四舍五入后KiCad 里以纳米单位保存就会出现细微偏差。解决办法是不要逐个焊盘去改而是先看全局的尺寸公差如果所有贴片焊盘都小了 0.01mm那大概率是精度丢失不是个别错误。过孔方面也有一个容易踩的坑EasyEDA Pro 里的盲埋孔定义和 KiCad 的层对结构不同转换后盲埋孔可能被当成普通通孔处理导致生产文件层面出现问题。如果你板子上有盲埋孔转换后一定要逐层检查孔信息确认 Start Layer 和 End Layer 正确。5.5 转完打不开或报错打开就报错的情况九成是 KiCad 版本和目标格式不匹配。KiCad 6 工程的文件和 KiCad 7、8 并不完全兼容你在命令行指定 --format 的时候要严格用你电脑上实际安装的那个 KiCad 版本号。如果开了新版本 KiCad预备把旧工程打开再自动升级也不一定 100% 成功所以最好第一次就指定正确版本。还有一类打不开的原因是输出路径下的文件名带了中文或空格。KiCad 对工程路径中的非英文字符不算友好我遇到过一次因为工程名带了个中文括号导致原理图和 PCB 关联不上的诡异问题。建议转换输出前把工程命名统一改成英文字母、数字、下划线组合。6. 这些场景用起来特别值6.1 批量迁移历史工程前面说的都是单个工程转换但 epro2kicad 真正的威力在批量处理。比如你有一个目录里面存着几十个 EasyEDA Pro 工程每个工程都有自己的 .epro 文件你可以用 shell 脚本一把梭for f in ./projects/*.epro; do dir./kicad_out/$(basename $f .epro) mkdir -p $dir epro2kicad convert $f -o $dir --format 7 --verbose done这个脚本看着简单但有几个细节要注意。一是每个工程单独输出目录避免文件互相覆盖。二是建议脚本里面加个循环内的日志把转换成功和失败的工程名分别记录下来方便批量跑完后集中处理。我第一次批量跑的时候以为全程顺利结果后面打开一批文件才发现有几块板子的丝印层被映射成了内层原因就是那几个工程使用了不常见的机械层命名。所以批量跑完后必须抽查。6.2 在 CI 里做格式校验如果你的团队已经开始用 Git 管理硬件工程epro2kicad 还能扮演格式校验员的岗位。可以在 push 或者 tag 时触发一个任务把 EasyEDA Pro 工程转换到 KiCad 格式并在转换失败时阻止合并。这样就算团队里有人仍然用 EasyEDA Pro也不会影响其他人用 KiCad 协作。我搭过的流程很简单CI 容器里装好 Python、克隆 epro2kicad 代码、安装依赖然后跑一条转换命令最后用 git diff 检查生成的工程文件有没有实际变化。整个过程没有任何图形界面非常适合在服务器环境跑。6.3 团队协作里减少工具锁死硬件团队常常会遇到一个问题少数人习惯 KiCad少数人习惯 EasyEDA Pro图纸交给另一边就完全打不开。过去遇到这种情况只能让人手动导出文件既麻烦又容易带丢数据。有了命令行转换流程之后团队可以约定EasyEDA Pro 工程为原始输入KiCad 工程为发布输出每次变更通过转换命令生成新的 KiCad 版本。版本管理里同时保留两种格式谁都能打开谁都能审查。而且 KiCad 工程是文本化的code review 的时候可以直接看网络的增删、元件的替换这在以前用私有格式时是完全不敢想的。我自己在实际操作后的体会是转换工具有没有用不在于它能不能把每个细节都完美搬过来而在于它能不能把换工具这件事从手动熬夜变成自动巡检。epro2kicad 离完美还差得远但方向已经对了所有能交给命令行的就不要交给鼠标。