简介这是一套面向 Altium Designer 的交互式 BOM 表导出插件主要供硬件工程师、PCB 设计人员及需要处理元件清单的相关岗位使用。它针对传统 BOM 表格只能静态查看、不支持按封装/位号快速筛选和定位的痛点通过内置脚本在 AD 中直接生成具备搜索、高亮、折叠分类等能力的 HTML 交互页面方便生产、采购与维修环节高效查阅。资源包共包含 30 个文件整体大小仅 139KB。文件以 JavaScript 脚本为主17 个 js 文件负责 BOM 数据处理与页面渲染辅以 HTML/CSS 模板用于定义交互界面外观另有批处理脚本用于快速初始化与卸载插件以及工程脚本和窗体定义文件用于接入 AD 菜单与界面。目前已有 2304 人学习使用该资源。除了核心导出功能和可直接运行的批处理脚本外包内还提供示例页面和用户自定义模块便于使用者理解交互逻辑并做二次开发整个包结构紧凑、无需复杂安装适合希望替代传统 BOM 输出方式的工程师快速接入。1. 交互 BOM把 Altium Designer 的装配数据变成一张“能点的板子”实际装配时最耗时的不是看表格而是在 PCB 视图里找位号。传统 BOM 经 AD 导出成 Excel 或 PDF 后与版图完全割裂要确认某颗 0.1uF 电容贴在哪得在表格里查位号再回头用 CtrlF 在 PCB 上搜索。这个插件改变了工作流——它把 AD 的 PCB 数据导出成一个独立的交互式 HTML 文件元件以图形化方式呈现点击 BOM 行对应器件在板图上高亮点击板图上的器件BOM 行同步定位。整个过程不依赖 AD 环境浏览器打开就能用。这套方案的底层是一组 Altium Designer 脚本工程InteractiveHtmlBomForAD由 Delphi 窗体脚本和 JavaScript 脚本混合组成。它适合需要频繁输出装配文档的硬件工程师、PCB 设计人员以及需要跟产线、贴片厂对接 BOM 的工艺岗位。它解决的问题不是生成 BOM 表而是让 BOM 表能跟 PCB 对上话。2. 脚本工作台解剖InPcb API、坐标映射与 lz-string 数据链路2.1 AD 脚本系统的运行机制为什么插件要混用 Delphi 与 JSAltium Designer 的脚本系统支持 DelphiScript、VB Script 和 JavaScript 三种语言工程文件以.PrjScr结尾。这个插件的主工程文件是InteractiveHtmlBomForAD.PrjScr从文件列表能看出它同时携带了.dfmDelphi 窗体定义和.jsJavaScript 逻辑文件。mainWin.dfm定义的是导出参数对话框界面而mainWin.js负责业务逻辑这是 AD 脚本中很常见的窗体骨架用 Delphi、逻辑用 JavaScript的混合写法因为 JS 处理字符串拼接和数组遍历更顺手。插件通过 AD 的脚本运行接口获得当前 PCB 文档对象。InPcb.js是这一层的关键封装它把 AD 内部 PCB API 包装成插件可调用的方法比如遍历元件、读取坐标、获取网络名。AD10.js的存在说明插件兼容了 AD10 时代的 API 差异——Altium 从 AD10 到 AD20 虽然接口大体一致但部分 PCB 对象属性在不同版本中有变化插件单独保留一个版本适配文件就是为了处理这类兼容性问题。脚本运行的典型时序是这样的用户在 AD 里执行脚本 - mainWin 窗体弹出 - 用户选择导出路径和参数 - 确认后脚本访问 PCBServer 接口枚举当前 PCB 的全部元件 - 数据整理成 JSON - 经 lz-string 压缩后嵌入 HTML 模板。2.2 数据提取与坐标映射从 AD 对象模型到 Canvas 渲染AD 的 PCB 对象模型中每个元器件Component至少包含以下属性位号Designator、封装Pattern/Footprint、元件类型LibReference/Value、中心坐标X/Y、旋转角度Rotation、所在层Layer。插件要做的第一件事就是把它们读出来// 通过 AD 的 PCBServer 接口枚举 PCB 上的所有元件 var pcb PCBServer.GetCurrentPCBBoard(); // 获取当前 PCB 文档 var iterator pcb.BoardIterator_Create(); // 创建对象迭代器 iterator.AddFilter_ObjectSet(MkSet(ePCBComponent)); // 只遍历元件类对象 var comp iterator.FirstPCBObject(); while (comp ! null) { var designator comp.Designator.Text; // 位号如 R12 var value comp.Comment.Text; // 值/型号如 10K var pattern comp.Pattern; // 封装名如 0402 var x comp.X; // 坐标AD 内部单位是 10nm var y comp.Y; var rotation comp.Rotation; // 旋转角度 var layer comp.Layer; // TopLayer / BottomLayer iterator.Next(); } PCB.BoardIterator_Destroy(iterator);这段代码中MkSet(ePCBComponent)是 AD 脚本里的标准过滤写法告诉迭代器我只要元器件不要走线、过孔、铺铜。坐标单位是 AD 内部单位1 单位等于 10 纳米导出前需要换算成 mil 或 mm否则到 HTML 页面上坐标会差好几个数量级。comp.Layer用来区分顶层和底层元件这个信息最终会体现在交互页面的镜像翻转逻辑里。拿到原始数据后下一步是建立 PCB 坐标到浏览器画布坐标的映射。PCB 的原点在板框外某个位置而 HTML 画布的(0,0)在左上角。常见做法是先计算所有元件的包围盒bounding box得到板子整体的最小 X、最小 Y 值和宽高再按比例缩放到画布尺寸同时做居中处理。这一步如果算错导出的板图会出现元件位置整体偏移或放大缩小比例不对。2.3 数据封装与前端渲染lz-string 压缩与 render.js原始 BOM 数据量不大一个千元件板子的 JSON 文本通常在几十 KB 量级但插件要把整个 PCB 的元件布局也内嵌进 HTML就会带来 JSON 体积膨胀。插件引入了lz-string.js做压缩压缩后以字符串形式嵌进 HTML 的 script 标签里浏览器加载页面时再用同样的库解压还原 JSON。这种单文件自包含的交付方式方便直接发给产线或客户不依赖任何外部服务器。前端核心是ibom.js和render.js。ibom.html是页面骨架ibom.css是样式render.js负责把元件坐标渲染成 Canvas 图形。pep.js是 Pointer Events 的 polyfill用来统一鼠标和触摸事件——这样在平板上打开导出的 HTML 也能正常交互。split.js用于实现 BOM 列表和板图之间的可拖拽分栏。user.js、user.css、userheader.html、userfooter.html这几个文件是留给使用者做自定义扩展的钩子插件作者把用户可改的部分单独抽出来避免升级时覆盖自定义内容。结构上这是相当成熟的做法文件职责mainWin.dfm导出参数对话框的窗体定义mainWin.js对话框逻辑、参数收集InPcb.jsAD PCB API 封装AD10.js老版本 API 兼容适配ibom.js核心交互逻辑点选、高亮、合集切换render.jsCanvas 绘制板图与元件util.js数组去重、字符串处理等工具函数lz-string.js数据压缩/解压newstroke_font.js矢量笔画字体用于在 Canvas 上绘制文字config.ini导出参数配置Initialize.bat/UnInitialize.bat安装/卸载脚本newstroke_font.js很有意思。Canvas 原生fillText依赖系统字体不同电脑打开字体不一致会导致位号文字位置漂移插件采用 stroke font笔画字体方案把每个字符定义为一组线段坐标绘制时逐笔画出来保证了在任何设备上渲染结果完全一致。代价是中文支持有限这也是很多用户反映位号中文显示异常的根本原因。2.4 HTML 与 JS 的协作交互高亮是怎么实现的整个交互流程围绕BOM 行 ↔ 板图元件的双向绑定展开。左侧 BOM 表按 ValueFootprint 分组每一组对应一类器件右侧 Canvas 板图上每个元件绘制为一个小图形。当鼠标悬停在 BOM 行上ibom.js会遍历该分组下所有元件在 Canvas 上执行重绘非目标元件降低透明度目标元件用高亮色绘制边框。点击板图上的元件时反向通过元件的唯一索引找到 BOM 分组滚动列表并重点突出对应行。网络高亮是交互 BOM 的另一项核心功能。用户点击某个焊盘插件会找出该焊盘所属的网络然后把同网络的所有走线、过孔、焊盘一并高亮显示。这个功能在审核阶段特别有用能直观看到某个电源网络覆盖了哪些区域。实现上仍然走 Canvas 重绘但需要 AD 端在导出时额外写入网络信息——这就是为什么插件读取数据时不仅要遍历元件还要遍历走线和过孔。3. 安装与配置从 Initialize.bat 到 config.ini 的逐项说明3.1 Initialize.bat 做了什么AD 脚本目录与工程注册插件压缩包解压后目录下有两个批处理文件Initialize.bat和UnInitialize.bat。前者负责把脚本工程安装到 AD 能识别到的位置最常见的方式是复制整个目录到C:\Users\Public\Documents\Altium Designer\AD 20\Scripts或用户文档目录下的 Scripts 文件夹后者负责清理。提示AD 的脚本扫描路径可以在 DXP - Preferences - Scripting System 里查到。不同 AD 版本的默认脚本目录不一样安装前先确认一下。打开 Initialize.bat典型的逻辑是echo off rem ---------- InteractiveHtmlBomForAD 安装脚本 ---------- set SCRIPT_SRC%~dp0 set TARGET_DIR%PUBLIC%\Documents\Altium Designer\AD 20\Scripts\InteractiveHtmlBomForAD rem 目标目录不存在则创建 if not exist %TARGET_DIR% mkdir %TARGET_DIR% rem 将插件源码整体复制到脚本目录 xcopy %SCRIPT_SRC%* %TARGET_DIR% /E /I /Y rem 提示安装完成 echo Install done. Restart Altium Designer. pause%~dp0获取当前批处理所在路径/E表示复制所有子目录/I表示目标路径按目录处理/Y覆盖不提示。如果你的 AD 装在 D 盘或者脚本目录被改过需要手动把TARGET_DIR改成实际路径。安装完成后要重启 AD脚本才会出现在可执行列表里。卸载脚本的逻辑正好相反删除目标目录并提示用户。这里有一个细节如果用户后续把自定义的 user.js 放进了脚本目录卸载会一并删掉——我自己会在改完 user.js 后先把文件备份一份到压缩包外。3.2 在 Altium Designer 中运行脚本的两种方式安装完成后运行方式有两种。第一种是通过菜单DXP - Run Script或文件 - 运行脚本在弹出的文件选择框里定位InteractiveHtmlBomForAD.PrjScr选择要执行的函数入口。第二种是在脚本工程窗口中直接打开文件选中入口函数点击运行按钮。插件通常在 mainWin.js 里暴露了入口类似function main() { var dlg new MainWin(); dlg.ShowModal(); }ShowModal()让对话框以模态窗口运行意味着必须关掉对话框才能回到 AD 主界面。这样设计是为了防止用户在导出过程中继续编辑 PCB导致数据不一致。对话框出现后你需要设置输出目录、文件名等参数然后等待脚本执行完成。首次运行时如果 AD 没有任何反应最常见的两个原因一是代码中访问了不存在的 PCB 文档没有打开任何 .PcbDoc二是脚本编译时抛出了语法错误。插件对网络和 PCB 对象有直接依赖确保当前激活的文档是 PCB而不是原理图。3.3 config.ini 参数表哪些配置影响导出结果config.ini是插件的又一个用户配置入口它的作用类似于导出默认值。插件读取配置后填入对话框省去每次手动填写的麻烦。常见配置项包括配置项作用建议值OutputDir导出文件保存目录绝对路径如D:\BOM_ExportFileNamePrefix文件名前缀比如ProjectA_BOMCompressData是否压缩内嵌数据true一般保持开启IncludeBottomSide是否包含底层器件true除非你对贴装顺序有特殊要求ShowTopAssembly默认视图显示顶层装配图trueBoardOutlineOnly是否只绘制板框false大多数时候需要显示丝印参数具体的键名在不同版本里会有差异但思路一致。改完 config.ini 后需要重启 AD 才能生效因为脚本在启动阶段一次性加载了配置。如果插件运行时报无法读取配置文件多半是路径中包含了中文字符AD 的部分老版本脚本引擎对 Unicode 路径支持不好我的做法是把整个工程路径统一改为纯英文。3.4 完整导出流程与产物验证安装配置完成后导出一个实际项目大约需要三个步骤。先打开目标 PCB 文件确认元件编号完整Tools - Design Rule Check 跑一遍排除未布线或未标号元件。然后运行脚本设置输出目录和文件名项目规模决定等待时间一个 200 元件的小板子几秒钟就能完成上千元件且铺铜复杂的板子可能需要十几秒。关键点来了输出的 HTML 文件是自包含的。拿到产物后我强烈建议做一次换机验证——把 HTML 复制到一台没装 AD 也没有任何插件库的电脑上用浏览器打开确认交互正常。因为所有数据已经压进了 HTML所以只要浏览器能跑就说明产物没问题。此时给工厂发出去的 BOM 就不只是一张表格了它是一个可搜索、可定位、可镜像翻面的装配图。4. 二次定制把 user.js / user.css / config.js 变成自己的交付模板4.1 user.css改造导出页面的视觉识别度交付给产线的 BOM 页面默认视觉风格可能不够直观。user.css是 Custom 样式的扩展点插件在加载完默认ibom.css之后再加载user.css所以这里的规则可以覆盖前者。常见定制包括把 BOM 分类表的表头改为深色底白字、增加打印排版适配、给高亮状态增加更强对比度。/* user.css - 定义公司 BOM 模板样式 */ .bom-table th { background-color: #2d2d2d !important; color: #fff !important; position: sticky; /* 表头滚动吸顶长列表方便看字段 */ top: 0; } .component-highlighted { stroke: #ff6a00 !important; /* 高亮描边改成醒目橙色 */ stroke-width: 2px !important; } media print { .split-pane { display: block !important; } /* 打印时改为单栏 */ }position: sticky配合top: 0让 BOM 表头在向下滚动时固定住几百行列表时不用来回滚动找列名。打印模式下把分栏布局改成块状避免板图和 BOM 表被拆分到不同页面。配色上注意不要只用颜色区分状态丝印图和位号文字在黑白打印时会重叠建议同时叠加线宽变化。4.2 user.js补充“供应商链接”和“复制位号”两个高价值功能完全默认的 BOM 表格只包含位号、封装、值三层信息。实际交付中采购需要的是物料编码或者至少一键打开供应商搜索。在 user.js 里可以扩展一个供应商链接列实现方式是先定义映射表然后在表格渲染完成后执行插入逻辑。// user.js - 在 BOM 表中注入供应商查询链接 var supplierMap { STM32F103C8T6: https://item.szlcsc.com/global/search.html?q, AMS1117-3.3: https://item.szlcsc.com/global/search.html?q }; window.enhanceBOMPanel function () { // 找到 BOM 面板容器插件默认会给一个 id var panel document.getElementById(bom-panel); if (!panel) return; // 遍历每个分组的 Value 单元格 panel.querySelectorAll(.bom-value).forEach(function (cell) { var value cell.textContent.trim(); var url supplierMap[value]; if (url) { var link document.createElement(a); link.href url encodeURIComponent(value); link.target _blank; link.textContent 采购; link.style.marginLeft 6px; cell.appendChild(link); } }); }; // 插件在数据加载完成后会调用用户钩子如 onUserScriptLoaded if (typeof onUserScriptLoaded function) { window.addEventListener(load, enhanceBOMPanel, false); }这段代码的逻辑是在 BOM 面板渲染完成后扫描每个分组的 Value 单元格命中映射表就追加一个采购链接。encodeURIComponent用来转义物料关键字中的特殊字符防止链接拼接出错。onUserScriptLoaded是插件预留的用户钩子具体名称需要打开 ibom.js 源码确认如果不确定退而求其次是监听window.load事件。另一个实用功能是复制全部位号。当某个分组有几十个位号时用户想直接粘贴到邮件或表格工具里手工一个个复制效率太低。常见做法是给分组的位号列加一个复制按钮var designators dataItem.designators.join(,); navigator.clipboard.writeText(designators).then(function () { console.log(Designators copied:, designators); }).catch(function () { // 老浏览器没有 clipboard 的 fallback var ta document.createElement(textarea); ta.value designators; document.body.appendChild(ta); ta.select(); document.execCommand(copy); document.body.removeChild(ta); });优先使用navigator.clipboardAPI失败时退回document.execCommand(copy)。考虑到导出后的 HTML 可能在不同年代的浏览器上打开这段兼容代码很有必要。4.3 config.js调整分组策略和默认视图config.js是 IBD 页面端运行时参数不同于提前读取的config.ini。它在 HTML 加载时生效主要控制页面显示行为。比如默认按Value Footprint分组但如果你需要更细的拆分粒度可以改成把位号前缀也纳入分组维度或者设置打开页面时默认显示 BOM 列表面板。值得注意的参数是是否默认启用网络高亮、是否在加载时自动滚动到第一个元件、BOM 表初始排序方向按值还是按位号。这些设置直接影响一线操作者打开文件后的第一眼体验。我一般会关闭自动滚动因为产线使用时通常是先搜索位号而不是依赖加载顺序。4.4 自定义输出模板的保存防止升级覆盖如果你花了不少时间调好了 user.css 和 user.js请记住把它们单独保存一份到压缩包外。插件升级时通常替换整个目录如果直接覆盖你的定制就没了。我的做法是维护一个my-custom文件夹里面放自己版本的 user.js 和 user.css升级后把这两个文件复制回去而不是在压缩包内直接修改原文件。5. 实战排错坐标漂移、中文显示、大板卡顿的三个典型坑5.1 坐标偏移原点不一致导致板图跑偏板图整体偏移最常见的成因是 PCB 原点不在板框左下角。AD 默认的绝对原点在图纸左下角但设计者在布局时可能把原点挪到了板框内某个器件旁导致导出的元件绝对坐标与板框相对位置产生固定差值。解决办法有两个层面一是调整 PCB 原点位置后在导出前重新执行脚本二是如果你不想动 PCB就需要在生成 HTML 前对坐标做一次整体平移。检查手段很简单在 AD 里按快捷键EO把原点复位到板框左下角重新导出看坐标是否对齐。如果对齐了那问题就出在原点。部分版本插件会在导出界面提供固定偏移量选项这时直接填上原点到板框的相对偏移即可。设计上更稳妥的做法是PCB 绘制期间原点固定在板框外固定位置导出文档前强迫自己确认一次。5.2 位号中文显示为线段stroke font 的字符集边界前文提到newstroke_font.js是为保证跨设备渲染一致性而引入的矢量字体但它本质是一套笔画字体只覆盖了 ASCII 字符集。如果你的位号含有中文比如U_电源模块交互页面会绘制出一些奇怪的线段拼凑图案完全不可读。这类场景我一般走两条路线一是统一位号规范为纯英文这本身也是行业规范二是放弃笔画字体渲染改用 Canvas 原生fillText绘制中文。第二种方案要改render.js中的字体渲染函数风险是不同系统在没有安装对应中文字体时页面上可能出现方框。折中思路是优先fillText捕获到字体缺失异常时回退到 stroke font。5.3 上千元件的大板卡顿数据的体积瓶颈元件数量达到 1500 时HTML 文件体积可能达到 1030 MB原因是原始 JSON 包含坐标、位号、网络、封装等字段即使经过 lz-string 压缩数据体量依然不小。浏览器打开时要去压缩、解析、绘制整个初始化过程会明显卡顿。排查思路是分步确认瓶颈。先在 DevTools 的 Performance 面板查看是解析阶段慢还是绘制阶段慢。解析慢就减少内嵌数据导出时过滤掉不必要的网络、隐藏层或机械层的对象绘制慢则要降低 Canvas 重绘频率——render.js里常见的优化手法是维护一个脏标记只有用户交互切到某个器件时才重绘这一层而不是每次高亮都全量重绘。最简单的优化是导出时关闭不必要的铺铜显示只保留板框、丝印和元件。5.4 复用技巧把交互 BOM 嵌入公司内部工艺系统如果能跑通基本导出这个项目的价值还能进一步放大。可以把它嵌入内部工艺文档系统后端接收 AD 导出的 HTML 文件解析其中的 BOM 数据配合 ERP 中的物料编号做交叉匹配前端在交互页面上直接展示库存状态。实现方式无需改动插件的 AD 端只需要在前端写一个解析函数读取 lz-string 解压后的 JSON 结构。ISO 文件、工艺卡、首件确认单都能以这份 HTML 为核心载体做到一物多用。5.5 最后一步用最小板子验证配置换环境后所有功能失灵时别急着找大项目测试先做一个最小验证新建一块空 PCB只放一个电阻和一个电容各加一个。导出 HTML打开浏览器确认两个元件都能高亮、网络能选中、BOM 分组正确再把整目录迁移到新机器。小项目跑通能排除 80% 的路径、权限和配置问题剩下的才是真正需要深挖的插件 bug。本文还有配套的精品资源点击获取