简介：面向需要在Altium Designer与Cadence Allegro之间复用PCB封装的设计人员，这份docx文档聚焦跨平台封装迁移与Allegro封装生成这一常见难题，适合具备一定PCB基础、希望减少重复建库工作的读者参考。压缩包内为1个docx文件，大小约63KB，篇幅精简，便于随查随用。内容围绕AD封装转入Allegro后的文件组织与库路径管理展开，涉及symbol、shape、焊盘等生成文件的归类，以及路径命名和封装一致性检查等容易出错的环节，可帮助读者理解迁移过程中的关键注意点。目前已有1475人学习或下载，说明该主题在EDA实操中具有较高关注度。对于需要快速复用已有封装、梳理跨软件库文件对应关系并降低返工概率的工程师和学生，这份资料能提供一条较清晰的参考线索。
1. AD 封装转 Allegro：一次转换省掉三天重建库
手上一个老项目要换平台，板子迁完了，卡在库上——几百个 AltiumDesigner（AD）封装要在 Allegro 里重画一遍，按一个封装四十分钟算，两个月就没了。这份 docx 笔记记录的就是绕开这件事的路子：把 AD 的封装经 PCB ASCII 中间格式导进 Allegro，自动吐出 dra、psm、ssm 和焊盘，再按 Allegro 的读取规则归位，让这些 AltiumDesigner 封装在 Allegro 里能被正常调出来。它不是多高深的技术，是一条六步流水线，但每一步都埋着能让人卡半天的细节。适合两类人：正在做 AD 到 Allegro 平台迁移的硬件工程师，和需要维护跨平台封装库的库管。新手照着走能出结果，熟手可以直接看后面几张文件归位表和避坑清单。
2. 转换前的准备：ASCII 落盘与路径清洗
2.1 为什么中间格式必须是 PCB ASCII 而不是二进制 PcbDoc
AD 的 .PcbDoc 本质是 OLE 复合文档，里面对象之间靠索引互相引用，用文本编辑器打开是一堆乱码；Allegro 那边执行转换的程序只认 AD 导出的 ASCII 记录流，也就是每条记录以|RECORD=开头的那种纯文本。这不是谁偷懒，ASCII 里图层名、焊盘栈、字符串全是明文的，转换器不用去反解 AD 的私有二进制结构，出错时日志还能指到具体是哪条记录挂了。
所以整条链路上，ASCII 是唯一的交接点，前后两端都围着它转。这也解释了为什么很多人直接拿 .PcbDoc 往转换器里塞，得到的是“文件无法识别”或者干脆没反应——转换器不是不认 AD，是不认那个容器格式。
提示：ASCII 文件比二进制大几倍到十几倍，几百个封装的板子导出来上百兆很正常，别当成导出失败去反复重试。
还有一个容易被忽略的兼容性问题。AD 的 ASCII 导出格式跟着软件版本走，而转换器能认的记录集是有限的，版本差得远的时候会出现“文件打开了但对象大面积丢失”，日志里却只有几条不痛不痒的 warning。我一般的做法是先用 AD 把源板子 Save As 到更早的格式版本，再重新导一次 ASCII，让记录集落回转换器的舒适区。这一步花两分钟，能省掉后面一小时的猜谜。
2.2 建空板、摆封装：把要搬的东西圈出来
不要拿原始设计文件直接导。原始板子上有覆铜、有走线、有 Room、有 3D 体，全都会被转换器当成待处理对象，日志直接变成一锅粥，出了问题你根本分不清是封装本身的问题还是板级对象的问题。正确姿势是新建一块空 PCB，只把要搬的封装摆上去。
具体步骤：
- AD 里 File → New → PCB，新建一块空板；
- 立刻 Save As 到纯英文、无空格的路径，比如
D:\ad2allegro\conv\packages.PcbDoc； - 打开 Components 面板，从库里逐个 Place 封装到空板上，或者用 Place → Component 手动挑；
- 摆的时候记下封装名清单，一份 txt 就够，后面核对数量用；
- 检查板上有没有混进 3D Body、覆铜、尺寸标注，有就删掉；
- 保存。
一次转换的封装数量建议控制在几十个。不是因为转换器处理不了更多，而是日志混合在一起之后，某个封装的 pad 名冲突你根本定位不到。分批导、分批验，虽然听起来笨，但返工率最低。
摆封装的时候还有一件事要顺手做：把每个封装的参考点确认一遍。AD 里封装的参考点可能是 1 脚，也可能是几何中心，取决于当初建库的人怎么设的。这个信息在转换过程中不会被完整带过去，Allegro 侧的原点是它自己认定的，两边对不上，后面贴片坐标就会整体偏移。现在花一分钟记下来，比后面打开 dra 一个个量原点省事得多。
2.3 另存为 PcbDoc ASCII 时的两个开关
真正的导出动作只有一个：File → Save As，保存类型选PCB ASCII File (*.PcbDoc)，文件名和路径保持纯 ASCII。AD 会弹一个提示告诉你 ASCII 文件体积会变大、部分特性可能不受支持，确认即可。
导完别急着切到 Allegro，先在本地做两个检查。第一个是确认落盘的真是 ASCII 而不是你以为改了扩展名的二进制；第二个是确认整个路径上没有非 ASCII 字符——这是最常见的一种“文件明明在那儿但转换器说找不到”的原因，尤其是路径里带中文目录名、带空格、带括号的时候。
# 1) 看文件头：ASCII 版的前若干字节应该是 |RECORD= 开头的文本记录 head -c 200 /work/ad2allegro/conv/packages.PcbDoc # 期望输出类似：|RECORD=Board|... # 如果打出乱码或者 "PK" / "ÐÏ" 之类，说明存成了二进制，回去重存 # 2) 检查当前工作目录里有没有非 ASCII 字符（中文、全角符号等） printf '%s' "$PWD" | grep -qP '[^\x00-\x7F]' \ && echo "路径含非 ASCII 字符，换到 /work 下面再试" \ || echo "路径干净"head -c 200只取前 200 字节，够判断格式了，不用把上百兆的文件全打开。第二条用的是grep -P的 PCRE 模式，[^\x00-\x7F]匹配任何非 ASCII 字节，命中就说明路径里有中文或者全角字符。这个检查看着土，但它把“路径问题”这一类故障从半小时的排查压缩成一条命令。
注意：
grep -P在部分精简版环境里没编译进去，报-P: unknown option的话换成LC_ALL=C grep -q '[^ -~]'，效果一样。
两条都过了，AD 这边的活就干完了。后面所有动作都在 Allegro 侧，中间不再需要回到 AD。
3. Allegro 侧的导入动作：CAD Translators 的实操路径
3.1 新建 brd 与 Import 菜单的入口
Allegro 打开后先 File → New，类型选 Board，给个纯英文名，比如import_tmp.brd，存到一个新建的空目录里。这块板子只用来承接导入结果，后面要不要留都行，但它必须存在——转换器的输出是往一个已有板工程上挂的，没有板它会直接拒绝执行。
入口在 File → Import → CAD Translators 下面找 Altium PCB 那一项。不同版本这个菜单的层级和命名会有点差别，有的直接叫 Altium PCB，有的归在 CAD Translators 子菜单里；如果实在翻不到，检查一下安装时有没有勾选对应的转换器组件，有些精简安装包默认不带。
点开之后是一个小对话框，要填的东西不多，但每一项都有后果。这一步最容易犯的错是把输出目录设成输入目录，或者设成一个已经有历史转换结果的目录——转换器不会帮你清理，几次转换的产物会混在一起，后面按扩展名归档的时候你会拿到两套不同版本的 psm，然后开始怀疑人生。
3.2 导入选项逐项对照
对话框里的可调项不多，我把常用的几项和自己习惯的设法定下来，配一张表，按这个走基本不会翻车。
| 配置项 | 我一般怎么设 | 理由 |
|---|---|---|
| 输入文件 | 2.3 步导出的.PcbDocASCII | 二进制版本转换器不认，这一步没得商量 |
| 输出目录 | 新建空目录，与输入目录分开 | 输出是一整棵文件树（板、symbol、pad、日志混在一起），目录脏了分不清批次 |
| 单位 | mm，与 AD 源文件保持一致 | 两边单位不一致时，取整误差最容易在焊盘尺寸上体现出来 |
| 日志输出 | 一定开，落到输出目录 | 后面所有排查都靠它，关掉等于蒙眼开车 |
| 图层处理 | 先全转，到 Allegro 里再裁 | 少转一层就少一份证据，出问题时无从对比 |
单位这一项值得多说一句。AD 侧很多人习惯用 mm 建库，Allegro 侧老库大量是 mil，转换器会做换算，但换算之后要落到 Allegro 数据库的精度格点上，0.01 mm 量级的取整偏差是正常的。如果板子是细间距器件，比如 0.4 mm pitch 的 BGA，这种取整在四边累积起来就会让焊盘间距看起来“差了一点点”。我的习惯是两边都用 mm，转换完先量三个焊盘的间距，确认误差在可接受范围内再往下走。
点执行之后转换可能要跑几十秒到几分钟，取决于封装数量和机器。跑完别急着关窗口，先看它给的统计信息：成功转换了多少个 symbol、多少个 padstack、跳过多少对象。跳过数量不为零就要去看日志，别自我安慰说“应该都是无关对象”。
3.3 导入日志怎么看：先看 error 还是先看 warning
日志文件在输出目录里，扩展名是 .log，用文本编辑器直接打开。新手常见的做法是从头往下读，几百行读完脑子已经糊了，而且真正的错误往往埋在中间。
我的顺序是固定的：先数 error，再看 not found / cannot / unsupported 这类关键词，最后才回头扫 warning。error 决定这次转换能不能用，warning 只决定这次转换的质量好不好，两者优先级完全不同。
LOG=/work/ad2allegro/out/altium_import.log # 1) 先看规模：有多少条 error，多少条 warning grep -ci 'error' "$LOG" grep -ci 'warning' "$LOG" # 2) 只看 error 的前 20 条，通常重复度很高，看头部就够定性 grep -i 'error' "$LOG" | head -20 # 3) 定位"对象级"的失败：找不到的焊盘、不支持的特性 grep -iE 'not found|cannot|unsupported|skipped' "$LOG" | head -30grep -ci用的-c是计数、-i是忽略大小写，先拿到数量级，心里有底。第二步的head -20是因为 error 往往集中在某一类问题上反复出现，看前二十条基本能判断是路径问题、格式问题还是某个特定封装的问题。第三步的正则是把“对象丢失”这一类挑出来，这类问题不会让转换直接失败，但会让你在 Allegro 里得到一个缺了焊盘或者缺了丝印的空壳封装，比直接报错更阴险。
提示：日志里出现
Padstack not found时，先别改封装，去确认输出目录下的 pad 是不是真的生成了。有时候是转换器把焊盘名里的特殊字符过滤掉了，文件在，名字对不上。
4. 生成物落位：dra / psm / ssm / pad 各回各家
4.1 一次导入到底吐出哪些文件
转换跑完，输出目录里会多出一堆东西。第一次看会有点懵，其实按扩展名分就四类，每一类的角色和归宿都不一样。搞不清这个对应关系，后面文件放错目录，Allegro 会给你一个非常含糊的“symbol not found”，够你查一下午。
| 文件类型 | 扩展名 | 作用 | 该放哪 | 谁读它 |
|---|---|---|---|---|
| 封装源图 | .dra | 可编辑的封装图形，原点、丝印、装配层都在这 | 源码目录，不参与加载 | 人 |
| 封装编译体 | .psm | Allegro 放置元件时真正读取的文件 | psmpath 覆盖的目录 | Allegro |
| shape 源图 | .dra | 异形焊盘的图形定义（和封装 dra 同名但不同物） | 源码目录 | 人 |
| shape 编译体 | .ssm | 异形焊盘被引用时读它 | psmpath 覆盖的目录 | Allegro |
| 焊盘栈 | .pad | 焊盘的孔径、盘径、阻焊开窗定义 | padpath 覆盖的目录 | Allegro |
| 转换日志 | .log | 过程记录 | 归档留存 | 人 |
| 中间板文件 | .brd | 这次转换生成的板，可删 | 输出目录 | 人 |
这张表里最关键的一行是.psm。很多人把.dra拷进库目录就以为完事了，结果 Place 里死活找不到封装——因为 Allegro 加载封装读的是.psm，.dra只是给人看和改的源文件。.dra和.psm是一对，同名，前者是源、后者是编译产物；只有.dra没有.psm，等于只有图纸没有零件。
.ssm这一行也常被漏掉。AD 里的异形焊盘（比如长圆形、自定义多边形）转到 Allegro 之后会变成 shape symbol，它的编译体是.ssm，读取路径同样走 psmpath。原文里提到 shape 的 dra 和.ssm要一起放进 shape-symbol 目录，这个做法是对的，但更准确的说法是：那个目录必须被 psmpath 覆盖，否则放了也白放。
4.2 三类路径与 env 变量的对应关系
Allegro 找库文件不是靠一个“库目录”，而是靠一组环境变量，每个变量管一类文件。搞库的人只需要记住两条：
padpath：管.pad。焊盘栈找不到，报的就是它。psmpath：管.psm和.ssm。封装和 shape symbol 找不到，报的是它。
我习惯在库根目录下建三个平级的子目录：pad、psm、shape，源文件另放dra。这样归档规则清晰，加新库的时候直接往对应目录扔，不用每次想“这个文件该进哪个文件夹”。
路径可以在图形界面里维护，也可以直接改 env 文件。界面入口在 Setup → User Preferences → Paths → Library，padpath和psmpath各是一行，多个目录用空格分隔。手工改 env 的话，写法和下面这段一致：
# 库根目录假设是 /home/eda/lib # padpath 管 .pad，多个目录用空格分隔，不要用逗号 set padpath = /home/eda/lib/pad # psmpath 同时管 .psm 和 .ssm，shape 目录必须写进来 set psmpath = /home/eda/lib/psm /home/eda/lib/shape这里有两个血泪经验。第一，分隔符是空格不是冒号也不是逗号，写成冒号的话 Allegro 会把整串当成一个目录名，然后告诉你目录不存在。第二，改完 env 最稳的做法是关掉 Allegro 重开，不要指望它自己发现——有的人改完不生效，反复怀疑路径写错了，其实只是进程还拿着旧的环境。界面里改完点 OK 一般会刷新，但这个行为在不同版本上不完全一致，重开一次最省心。
注意：目录路径本身也不能含空格和中文。
/home/eda/my lib/psm这种写法在 env 里会被拆成两个目录，等于白配。
4.3 用脚本批量归档，避免手抖
封装数量上到几十个之后，手工拖文件就开始出错了：漏一个.ssm、把一个 shape 的.dra覆盖了同名的封装.dra、.psm和.pad混进同一个目录。这类错误不会立刻报，等到你 Place 元件的时候才炸。
我一般用一个按扩展名分发的脚本，跑完再看一眼统计结果。
#!/usr/bin/env bash # dispatch.sh —— 把转换输出按 Allegro 的读取规则分发到库目录 set -euo pipefail SRC=${1:?用法: ./dispatch.sh <转换输出目录> [库根目录]} LIB=${2:-$HOME/eda/lib} # 扩展名 -> 目标目录 的映射，注意 dra 单独放，它不参与加载 declare -A MAP=( [psm]="$LIB/psm" # 封装编译体，由 psmpath 读取 [ssm]="$LIB/shape" # shape symbol 编译体，同样由 psmpath 读取 [pad]="$LIB/pad" # 焊盘栈，由 padpath 读取 [dra]="$LIB/dra" # 源图，只供人看和改 ) for ext in "${!MAP[@]}"; do mkdir -p "${MAP[$ext]}" n=$(find "$SRC" -type f -iname "*.${ext}" | wc -l) echo "== .${ext}: ${n} 个 -> ${MAP[$ext]}" # -n 表示不覆盖已存在的同名文件，避免把库里正在用的封装冲掉 find "$SRC" -type f -iname "*.${ext}" -exec cp -n {} "${MAP[$ext]}/" \; done echo "--- 各目录现有文件数 ---" for ext in "${!MAP[@]}"; do echo -n ".${ext}: " find "${MAP[$ext]}" -maxdepth 1 -type f -iname "*.${ext}" | wc -l doneset -euo pipefail让脚本在任何一步失败时立刻退出，不会带着半截结果往下跑。declare -A声明关联数组，键是扩展名、值是目标目录，加新类型只要在 MAP 里添一行。cp -n是关键参数——不加的话，同名文件会被静默覆盖，而.dra同名冲突在这条链路上极其常见（shape 的 dra 和封装的 dra 可能撞名），覆盖之后源图就没了，虽然不影响.psm加载，但你失去了改这个封装的能力。最后的统计段落是为了做数量对账：输出目录里有多少个.psm，库里就该多出多少个。
脚本跑完，把每个扩展名的数字记下来，和 2.2 步那份封装名清单对一遍。数量对不上，说明有一批封装在转换阶段就被跳过了，回去翻日志比在这里瞎猜快。
5. 避坑与排查：五个翻车现场
5.1 导入阶段：文件读不进去、日志一片红
现象一：转换器报文件无法打开，或者打开后统计信息里 symbol 数量为 0。原因基本只有两个：路径里有非 ASCII 字符，或者落盘的是二进制.PcbDoc。前者是转换器调用的底层文件接口不吃宽字符，后者是 Save As 的时候类型选错了——有人改了扩展名就以为转成 ASCII 了，实际内容还是 OLE 复合文档。解决办法是回到 2.3 步的两条命令：head -c 200看头部是不是|RECORD=Board，grep -P查路径里有没有非 ASCII 字节。两个检查十秒钟，比在日志里大海捞针强。
现象二：日志里 error 不多，但统计显示“跳过 N 个对象”，转换完的封装数量明显偏少。这种情况通常是版本兼容问题。AD 高版本导出的 ASCII 记录集，老的转换器认不全，遇到不认识的记录不是报错而是静默跳过，所以你看到的是“一切正常，只是少了一半东西”。解决办法是在 AD 里把源板子 Save As 到更早的格式版本，重新导一次 ASCII。判断依据是日志里那句unsupported record——只要它出现，就别再往下做了，先降版本。
5.2 几何阶段：焊盘尺寸、原点、丝印对不上
现象三：两个原本焊盘尺寸不同的封装，转过来之后焊盘变得一模一样。这是焊盘栈同名覆盖。转换器用焊盘名做唯一键，AD 里两个不同的 pad 如果叫了同一个名字（比如都叫PAD_1），转成.pad的时候后一个会盖掉前一个，两个封装就共用了同一个焊盘栈。这种错误在 Allegro 里看封装图形是正常的，只有量尺寸才发现不对。解决方式有两条：一是在 AD 侧把焊盘命名改成带尺寸后缀的唯一名（比如R0603_1.0x1.2），重新导；二是转换后在 dra 里逐个核对焊盘，发现尺寸错的用 Padstack Designer 重做。前者一次性解决，后者适合只错了一两个的情况。
现象四：封装摆到板上，贴片坐标整体偏了几毫米。AD 封装的参考点（1 脚或者几何中心）和 Allegro symbol 的原点不是一回事。转换器会自己认定一个原点，认错了整个封装的放置基准就跟着错。检查方法是打开.dra，看原点标记落在哪——它应该在 1 脚中心或者封装几何中心，落在丝印外框的角上就是错的。修正办法是在 dra 里把图形整体移动到正确位置，然后 File → Create Symbol 重新生成.psm。注意重新生成之后一定要覆盖旧.psm，否则你改的是图纸，Allegro 读的还是老零件。
现象五：丝印跑到焊盘上，或者阻焊层整个空了。AD 的 Top Overlay 对应 Allegro 的 SILKSCREEN_TOP，Top Solder 对应 SOLDERMASK_TOP，Top Paste 对应 PASTETOP。层名映射不上，转换器不会报错，它只是不生成对应层的图形，于是你拿到一个干干净净、没有丝印也没有阻焊开窗的封装。这种封装在 DRC 阶段才会暴露，那时候板子已经布了一半。解决习惯是：每批转换随机抽三个封装打开 dra，眼睛扫一遍有没有丝印、焊盘周边有没有阻焊环，没有就回去查层映射。
5.3 库加载阶段：Place 里翻不到刚导进来的封装
现象六：文件都放进库目录了，Place 面板里就是找不到新封装。两个原因，按概率排序。第一，只有.dra没有.psm——.dra是源图，Allegro 放置元件读的是.psm，没有它就不认。解决办法是打开 dra，File → Create Symbol 生成.psm，再放回 psmpath 覆盖的目录。第二，psmpath 没包含那个目录，或者改了 env 没重启。验证方法很简单：在 Allegro 命令行里查一下当前生效的路径（或者直接看 User Preferences 里 psmpath 的值），确认目录在里面、拼写没毛病、不含空格。这两条排完还找不到，再去怀疑文件权限和目录可读性。
6. 验证与复用：把一次性导入变成可重复流程
6.1 三处对齐校验
转换跑通、文件归位、Place 里能看到封装，这三件事都满足，很多人就开始画板了。我吃过这个亏：封装看着对，贴上去偏移，回头改库、重新出图、返工两天。所以每批导入我都会走一遍固定的三处校验，五分钟，一次都不省。
| 校验项 | AD 侧怎么量 | Allegro 侧怎么量 | 允许偏差 |
|---|---|---|---|
| 焊盘中心距 | Reports → Measure，或 Ctrl+M 量 | Display → Measure 拉两点 | 数据库精度内，实际看 0 |
| 焊盘长宽 | 双击焊盘看属性 | Padstack Designer 打开看参数 | 0.01 mm 量级 |
| 元件原点 | 库里封装的参考点设置 | dra 里看原点标记位置 | 与 1 脚或几何中心一致 |
| 阻焊开窗 | 看 Top Solder 层的扩展值 | 看 SOLDERMASK_TOP 相对焊盘的外扩 | 单边 0.05 mm 量级 |
表格里最容易偷懒的是第二行。焊盘长宽差 0.01 mm 在视觉上完全看不出来，但细间距器件上累积到四边就是贴片不良。我一般是拿一个最密的封装量，量完确认没问题，其余的就敢信了。
6.2 把一次性导入沉淀成可重复流程
第二次做平台迁移的时候，我才意识到这套动作应该模板化，而不是每次都临时想。现在我的做法是留三样东西：一块空 PCB 模板（就是 2.2 步那块，只留板框和原点），一份封装名清单 txt，还有 4.3 那个分发脚本。模板保证每次起点一致，清单保证数量对得上，脚本保证归位不靠手。
命名规则也顺手定死：.dra用封装名、.psm和它同名、焊盘带尺寸后缀、shape symbol 前面加SH_。这套规则不是给软件看的，是给人看的——半年后你回来改某个封装，看到SH_R0603_THERMAL就知道这是个异形焊盘，看到R0603_1.0x1.2就知道盘径是多少，不用打开一个个看。
从那以后我每次导库前都强制走一遍 2.3 那两条路径检查命令，宁可多花十秒，也不想再经历一次“文件明明在但就是读不到”的下午。库这种东西，出错的时候不会喊，只会在你最不想返工的时候提醒你。希望帮到你。
本文还有配套的精品资源，点击获取
