1. 为什么Altium Designer的BOM导出总让人反复折腾？
在PCB设计流程里，BOM（Bill of Materials）从来不是个“导出来就完事”的环节。它是一份承上启下的技术契约：上游连着原理图元器件属性的完整性与一致性，下游直通采购、贴片、仓库和生产追溯系统。我做过上百个量产项目，几乎每个新同事接手第一个量产板时，都会卡在BOM导出这一步——不是字段漏了，就是位号乱序，要不就是封装名和实际贴片料号对不上。最典型的一次，客户拿着我们导出的Excel BOM去备料，结果发现“R102”在表里显示为“0603_10kΩ”，而实际贴片站用的却是“RC0603JR-0710KL”，两个名称看着像，但ERP系统根本认不出，整批物料被退回重审。
Altium Designer本身并不提供“一键生成标准BOM”的魔法按钮。它的BOM能力是模块化、可配置的，核心逻辑在于：BOM不是被“生成”的，而是被“映射”出来的。你告诉AD“我要从哪些字段取值”“按什么规则排序”“哪些元件该被过滤掉”，它才把原理图数据库里的原始数据，按你的指令重新组织、筛选、格式化。所以所谓“两种形式”，本质是两种映射路径：一种走内置报表引擎（Report Output），靠模板驱动；另一种走OutJob工程输出（Output Job），靠任务链驱动。前者灵活、即时、适合调试；后者稳定、可复用、适合归档。很多人混淆这两者，以为只是菜单位置不同，结果在量产前夜才发现OutJob里没勾选“Include Designator”，整张BOM丢了位号列，返工三小时。
更隐蔽的问题藏在元器件属性里。比如热词里提到的“sch元器件属性properties只显示simulation generic”，这是AD 26.6.0版本一个UI显示bug——属性面板默认折叠了Custom Parameters区域，但BOM模板恰恰依赖这些自定义字段（如Manufacturer、MPN、Description）。你肉眼看不见它们，模板却在默默读取，一旦字段名拼错一个字母，BOM里对应列就全空。这不是软件缺陷，而是设计习惯问题：老工程师习惯在Comment字段填料号，新人直接复制粘贴到Manufacturer字段，结果BOM里出现“Manufacturer: R10K”这种无效值。我后来强制团队在库元件创建规范里加了一条：“所有BOM必需字段必须显式声明为Custom Parameter，且命名全小写无空格”。执行后，BOM首次通过率从62%升到94%。
提示：BOM导出失败的80%原因不在导出操作本身，而在原理图阶段的数据质量。检查BOM前，请先确认：① 所有元件都有唯一Designator；② 关键字段（MPN、Manufacturer、Description）已填且无空格/特殊字符；③ 没有使用“*”或“?”作为位号占位符（AD会将其识别为通配符而非文字）。
2. 内置报表引擎：实时调试BOM的“手术刀式”工具
当你需要快速验证某个字段是否生效、测试排序逻辑、或者临时给客户发一份带特殊备注的BOM时，内置报表引擎（Reports → Bill of Materials）是不可替代的。它不依赖任何工程文件，直接读取当前打开的原理图，所见即所得。但正因如此，它的配置项分散、逻辑隐晦，新手常陷入“点了导出却没反应”的窘境。
2.1 报表配置窗口的三层结构解析
打开报表窗口后，界面分为三个垂直区域，每层解决一个核心问题：
第一层：Filter（过滤器）
这是BOM范围的“闸门”。默认是“All Components”，但实际项目中必须主动设置。常见误操作是勾选“Exclude No ERC Components”——本意是剔除未放置的元件，结果却把所有未连接网络的测试点、安装孔也删了。正确做法是用“Custom Filter”：IsPlaced = True AND IsSheetSymbol = False。这个表达式确保只包含已放置、非页符号的元件。如果要做分板BOM，再加条件BoardAreaName = 'MainBoard'（需提前在元件Properties里设置BoardAreaName参数）。
第二层：Grouped Columns（分组列）
这是BOM结构的“骨架”。AD默认按Designator分组，但工业级BOM要求按MPN+Manufacturer合并同类项。这里的关键是理解“Group By”的真实含义：它不是简单去重，而是将满足所有分组字段完全相同的行，合并为一行，并对数值型字段（如Quantity）自动求和。例如，R1、R2、R3都用“RC0603JR-0710KL”，分组后显示为“RC0603JR-0710KL ×3”。但若R1的Manufacturer填了“Yageo”，R2填了“YAGEO”，因大小写不一致，它们会被视为不同项——这就是为什么强制字段标准化如此重要。
第三层：Columns（字段列）
这是BOM内容的“血肉”。左侧列表是可用字段源，右侧是已选字段。重点注意三个易错点：
Part Comment和Comment是不同字段：前者来自库元件定义，后者来自原理图放置时的覆盖值。量产BOM必须用Part Comment，否则改库后BOM不更新。Footprint字段显示的是封装名称（如“SOIC-8”），但采购需要的是封装尺寸代码（如“SOIC_150MIL”）。解决方案是在库元件Custom Parameters里添加PackageCode字段，BOM模板中调用它。Designator默认显示为“R1, R2, R3”，但SMT贴片机需要“R1-R3”格式。AD不支持原生范围压缩，需在Excel里用公式处理，或在OutJob中用脚本实现。
2.2 自定义BOM模板：从XML到实际应用
AD的报表模板本质是XML文件，存放在C:\Users\{用户名}\AppData\Roaming\Altium\Altium Designer\Reports目录下。你可以直接编辑DefaultBOM.xsl，但更安全的做法是另存为新模板。关键节点如下：
<xsl:for-each select="Components/Component"> <xsl:sort select="@Quantity">import pandas as pd import re def validate_bom(file_path): df = pd.read_excel(file_path) # 检查位号唯一性 if df['Designator'].duplicated().any(): raise ValueError("Duplicate Designators found!") # 检查MPN格式（必须含字母+数字，长度4-20） invalid_mpn = df[~df['MPN'].str.contains(r'^[A-Za-z0-9\-_]{4,20}$', na=False)] if not invalid_mpn.empty: raise ValueError(f"Invalid MPN format in rows: {invalid_mpn.index.tolist()}") # 检查数量为正整数 if not (df['Quantity'] > 0).all(): raise ValueError("Quantity must be positive integer") print("BOM validation passed.") validate_bom("Project Outputs/BOM/Project_BOM.xlsx")这个脚本拦截了87%的低级错误：重复位号、MPN含空格、数量为0或负数。它不替代人工审核，而是把审核者从“找错”升级为“判责”——当脚本报错时，责任人必须在Jira里提交修复记录，形成可追溯的审计链。
5.3 给新人的三条硬性纪律
最后，分享我在带新人时必讲的三条纪律，它们比任何技术细节都重要：
- 永远不要手动修改导出的BOM。哪怕只是改一个错别字，也必须回到原理图修正，重新导出。手动修改的BOM是“幽灵文件”，下次导出时会覆盖，导致数据不一致。
- BOM字段名必须与ERP系统字段名100%一致。我们曾因ERP用
Mfr_Part_Number而AD用MPN，导致自动导入失败。解决方案：在AD Custom Parameter里建一个Mfr_Part_Number字段，值=MPN，BOM模板调用前者。 - 每周五下午，用报表引擎随机抽查10个元件的BOM行，与Datasheet核对。这不是为了挑错，而是建立对数据质量的肌肉记忆。坚持半年后，新人的BOM首次通过率能达到90%以上。
BOM导出这件事，技术含量其实不高，难的是把简单的事做到极致。当你能把R1的料号、封装、数量、供应商信息，在每一次导出中都保证零误差，你才真正掌握了PCB设计的底层逻辑——不是画线，而是构建可信的数据链。
