
简介InteractiveHtmlBomForAD是专为Altium Designer开发的PCB快速BOM生成插件适合电子硬件工程师、PCB Layout人员及焊接调试岗位使用解决传统BOM生成环节依赖人工整理、信息分散且不直观的痛点。压缩包共55个文件大小约246KB其中包含17个JavaScript脚本、13个示例文件、3个HTML页面、3个Markdown文档及配置文件等js脚本负责BOM的生成渲染与交互示例文件便于参考实际用法HTML页面提供结果展示载体Markdown文档提供说明与使用指引批处理文件则可简化插件安装和卸载。资源已有2319人学习下载实用性获得较多关注。安装后用户可在Altium Designer环境中为现有PCB直接输出交互式HTML格式的物料清单该BOM表除列出元件位号、型号、数量、封装等常规字段外还能同步展示每个器件在板上的坐标、角度、尺寸并支持网页内搜索、缩放和高亮定位任意元件。在焊接与调试阶段这种可视化方式能显著减少查找器件的时间降低贴错元件或漏装风险整体提升硬件研发和生产效率。 干了这么多年硬件BOM我见过Excel的、PDF的、打印A4纸贴墙上的但自从试了InteractiveHtmlBomForAD这个AD插件之后其他格式基本就不怎么想碰了。它不是一个花里胡哨的小玩具而是真能把原理图、PCB、位号、物料清单揉成一个独立HTML文件浏览器一开想高亮哪里点哪里——焊接、贴片、维修、核对库存整个流程都能用它兜底。这篇文章就把它的安装、配置、踩坑过程完整写一遍不管是画板一年的新手还是十几年老师傅只要你在用Altium Designer都值得花十分钟了解一下。1. 为什么BOM要用交互式HTML来呈现1.1 传统BOM在实战里的痛点以前用AD自带的BOM功能导出Excel拿到手就是一张干巴巴的表格位号、Value、Footprint三列对着线路板找位置得靠肉眼扫丝印。整板三百个电阻电容还好遇到两千个元件的板卡光找一颗R123就能把人看花眼。PDF版本的BOM也差不多唯一优点是不容易被不小心改坏但同样没法解决“这个元件到底贴在板子哪个位置”的问题。AD自带的BOM表其实也能做到“点击BOM行、PCB里高亮元件”前提是你得在AD软件里打开PCB文件同时把BOM面板和PCB面板并排摆放。问题在于实际生产场景里车间工人、维修工程师、库房备料员往往并没有装AD的电脑更不可能人手一份正版License。就算装了AD软件启动一次也要几分钟让工人搞清楚怎么在工程文件里打开PCB再点BOM面板培训成本又是另一笔账。1.2 HTML格式到底好在哪里InteractiveHtmlBomForAD的做法很简单你在自己的电脑上用AD打开PCB文件运行这个插件它就把整块板子的元件位置、位号、封装、Value等信息全部打包成一个独立的HTML文件。这个文件不需要装任何软件浏览器打开就能用。它的交互性是纸质BOM给不了的点击BOM表任意一行PCB视图里对应的元件立刻高亮并居中放大位号、丝印、焊盘全看得一清二楚。反向操作也行点击PCB视图里的某个元件BOM表自动滚到那一行。焊接完某一类电阻想看下一类放在哪里直接在过滤框里输入新的Value界面就只显示目标元件干净利落。单文件还有一个隐藏好处——方便归档。Gerber、坐标文件、BOM Excel、交互式HTML四个文件往项目文件夹里一扔后续改板、返单、维修随便找台电脑打开浏览器就能查。2. 安装与快速上手从下载到第一条BOM2.1 下载和安装我踩过的两个坑先到GitHub搜索“InteractiveHtmlBomForAD”进到项目主页找最新的Release版本下载zip压缩包。注意别跟另一个叫InteractiveHtmlBom的核心库搞混了那个是针对KiCad的虽然界面类似但安装路径和菜单入口完全不同。AD专用的这个后缀是ForAD下错版本的话在AD里根本装不进去。第一个坑是安装目录。下载下来的zip包解压之后里面是一整个文件夹。有些人图省事直接把这个文件夹放到AD的安装根目录下结果重启后菜单死活不出来。正确做法是把整个插件文件夹放到AD安装目录下的Extensions子目录里或者放到系统用户目录下的Altium插件搜索路径。放好之后在AD的“Extensions and Updates”界面里点“Load from file”安装选择插件文件夹里的.ins安装文件确认后重启AD菜单才会出现。我一开始就是图省事直接扔根目录折腾了半小时才反应过来。第二个坑是版本兼容。插件在AD17以上的版本里基本都能正常工作但AD16及以下版本因为脚本接口差异装上后可能报错或者菜单灰掉无法点击。手头还在用老版本AD的建议先把AD升级到17以上。另外这个插件运行在PCB编辑器环境下打开原理图文件时Tools菜单里根本找不到入口第一次用的人很容易卡在这一步。2.2 生成第一条BOM参数面板怎么填安装成功后在PCB编辑器下点击Tools菜单往下找“InteractiveHtmlBomForAD”子菜单点Generate打开参数面板。面板选项不少但真正需要每次调整的就那么几个。输出目录和文件名按项目习惯填我习惯用“项目名_版本号_BOM.html”这种格式比如ad_bom_test_v1.2_BOM.html跟Gerber文件放一起后面对账方便。面板里有一项“Merge BOM Lines by Value and Footprint”字面意思是把相同Value且相同封装的元件合并成一行。这个强烈建议勾上不勾的话100颗100nF的0402电容会拆成100行BOM表长到看不完勾上之后合并成一行位号列表用逗号分隔备料、点料都舒服很多。位号排序方式里有个小细节。默认可能是按字母排序结果就会出现R10排到R2前面的情况手工焊接时按位号找元件特别别扭。建议改成按数字排序的方式R2、R10、R100这样的顺序才符合人的直觉。过滤配置里建议把测试点TP、定位孔Mounting Hole、机械件这一类不需要焊接的元件排除掉。插件提供了按位号前缀排除的输入框填上TP、MH、JIG之类的关键词即可。少了这些干扰项BOM表干净不少。2.3 从零到一完整操作流程说一次我最近实际走过的完整流程。一块双层板128个元件价值不高但量多全是常规阻容。打开PCB文件后Tools菜单里运行插件输出目录选到桌面文件名改成“test_board_v1.3_BOM.html”合并同类项勾上排除掉TP开头的测试点颜色方案默认。点Generate插件转了几秒钟浏览器自动打开生成的HTML。第一眼看到的是整板预览图默认显示顶层右侧BOM表格从C1到R128排列得清清楚楚。鼠标点一下BOM里的C5左侧PCB视图里C5那个封装立刻亮起黄色高亮框附近丝印、邻近元件全部可见比对着打印图纸找位号快得多。整个流程从运行插件到浏览器出画面不到半分钟。3. 核心功能拆解与实操心得3.1 高亮联动焊接工位的神器这个功能听起来简单实际用起来才知道多省事。以前手焊样板手里拿着镊子眼睛在丝印层上找位号遇到丝印压在焊盘下面或者被走线盖住的还得拿放大镜凑近了看。用这个HTML文件之后点击BOM表里某一行的位号PCB视图马上缩放到对应位置那个元件以高亮颜色显示周围元件变暗视觉焦点非常明确。反向查料的场景在维修时更常见。拿到一块故障板发现某个位置的电容鼓包想知道它是多少容值的料直接点击PCB视图里那个元件右侧BOM表就会定位到对应行Value、Footprint、甚至你在AD里填的其他自定义属性全都显示出来。不用再抱着原理图来回翻。3.2 颜色方案怎么选按封装还是按值插件提供好几种颜色映射方式默认按Layer区分顶底层这个适合结构工程师确认板面布局。真正手工焊接时我更推荐按Value或者按Footprint分配颜色。按Footprint分配时所有0402的电阻电容统一显示为同一种颜色所有SOIC-8的芯片显示为另一种颜色。焊接到某一步时只在界面上开启某个颜色对应的类别别的元件全部以低亮度显示这样就不会拿错封装。按Value分配时100nF是一个颜色10uF是另一个颜色专门用来防止贴错容值。具体怎么选取决于整批料里哪类更容易混淆。我做过一次实验在一块全是0402、0603混用的板子上按Footprint着色后焊接错料率从肉眼挑料的接近一成降到了零。3.3 搜索、过滤与测量三个容易被忽略的细节右上角的过滤框支持模糊搜索输入“R”会同时过滤出R1、R2、R10、R100等所有以R开头的位号输入“100nF”就把对应容值的元件全挑出来。实际使用时这个过滤框配合浏览器自带的“查找”CtrlF很顺手过滤框缩小范围CtrlF在地图上精确跳跃。插件还内置了一个测量工具可以测量两点间的物理距离单位默认公制毫米。偶尔需要快速确认两个器件封装间距时不用回AD里量直接在这个HTML里拖一下就行。截图导出功能我也经常用生成时勾上输出PNG选项会导出一张带高亮效果的整板装配图发工作群里沟通问题时非常直观。4. 大板、复杂板与多场景落地经验4.1 大板卡性能实测不是所有板子都像测试板那么轻松。我最近做过一块12层的通信板5762个元件光电阻就有两千多颗。插件生成HTML文件花了一分多钟生成的HTML文件约28MB用Edge浏览器打开后整体流畅度还行但拖动PCB视图时偶尔会有轻微卡顿。实测下来Edge和Chrome表现最好Firefox稍差一点。用平板上的浏览器打开缩放、高亮也都能用就是大板卡在平板上拖动不如电脑流畅。元件数量超过一万的板子建议在生成HTML时把BOM表格的实时联动显示选项关掉或者限制显示的元件层优先渲染当前关注的板层。插件默认配置对大板卡没做特殊优化第一次生成出来如果卡得不能忍可以把“渲染平滑度”调低一些换回来的是拖动流畅度提升视觉上几乎没差别。4.2 手工焊接、维修与备料环节怎么用手工焊接的场景我前面已经聊了不少再补充一个管理上的用法。样板焊接外包给焊接厂时我会把交互式HTML文件连同Gerber、BOM一起打包发过去。焊接厂工艺员反馈说以前对位号要找半天现在鼠标一点就定位到坐标AOI编程也省了很多事。维修场景里交互式BOM的价值更加明显。有一次客户退回一块板子故障现象是某路电源短路。我在公司电脑上打开对应版本的HTML文件先用过滤框输入“C1”找到C1这颗电容的位置再用浏览器查找功能在PCB视图中确认附近的滤波电容很快就锁定了可疑区域。整个过程不需要打开AD工程文件不需要重新导出图纸一个HTML文件全搞定。备料环节同样能沾光。库房按BOM发料时打开HTML文件按Footprint过滤一次就能看到整板所有0402封装的位置和数量跟实物料盘逐一核对比对着Excel表格一张一张翻效率高得多。4.3 从AD到Allegro、PADS跨工具的思路不少同事用Allegro画板看到我这边用交互式BOM这么方便也在问Allegro有没有类似的工具。其实Allegro社区也有第三方的交互式BOM脚本但配置成本相对更高需要额外安装Python环境输出效果也参差不齐。PADS这边也有类似方案但同样不如AD版这个插件顺手。个人建议如果公司同时有AD和Allegro两套工具链画板速度要求高的项目用AD加这个插件快速出交互式BOM给到生产和维修复杂板卡用Allegro的可以在后端建立标准化的BOM数据库。两种工具并不冲突关键在于BOM数据源要保持一致——“自动化设备如何选BOM”这个问题归根到底不是选哪个软件导出的问题而是元件库、封装库、物料编码是否规范统一的问题。数据源头整整齐齐用哪个工具导出的BOM都不会太难看。5. 常见问题与排查技巧实录5.1 常见问题速查表现象可能原因解决办法装好插件但Tools菜单里看不到入口当前打开的是原理图不是PCB文件切到PCB编辑器再查看Tools菜单插件菜单是灰色无法点击AD版本过低脚本接口不兼容升级AD到17及以上版本生成的HTML打开后白屏浏览器版本过旧或文件路径含中文换用Edge/Chrome输出路径改纯英文BOM表里少了一部分元件元件未放置或者没有有效封装勾选“Include Unplaced”补全封装后重新生成位号显示乱码元件参数里带了特殊符号或中文引号规范元件参数去掉中文、空格、引号大板卡打开HTML后拖动卡顿元件数量多渲染压力大降低渲染平滑度关闭实时高亮选项生成的PNG图片空白系统截图组件或打印驱动异常改用浏览器打印功能导出PDF再转PNG5.2 排查思路与避坑细节安装完找不到菜单这个问题是最容易被忽视的。插件安装后AD需要完全重启不是关掉PCB文件再重新打开而是把AD进程整个退出再启动菜单才会加载。AD20之后的新版UI里插件菜单偶尔会被折叠到Tools菜单底部的“扩展”分组里不仔细看很容易漏掉。HTML白屏的问题绝大多数是因为输出路径或文件名里有中文字符。插件生成的HTML文件内部用了本地脚本访问本地数据路径里的中文在部分浏览器里会导致脚本无法加载界面就一直空白。我踩过一次后从此所有项目输出文件都改成英文命名哪怕项目名是“电源板”输出目录也建一个“power_board”文件夹。位号乱码的问题源头在AD的元件参数。有些封装库是在网上下载的里面注释字段带着中文字符或者特殊符号导入AD后插件读取参数就乱。处理办法很直接在AD里把元件参数清理干净让Value、Footprint字段保持纯英文和数字。6. 关于BOM管理我踩过几个坑之后的体会6.1 交互式BOM是最后一公里规范才是源头插件用起来很爽但它不会帮你把乱糟糟的元件库变干净。如果你的AD库里Comment字段填得乱七八糟同一个电容有的写“100nF”有的写“0.1uF”导出的交互式BOM按Value过滤时这两批电容会被当成不同的类别分开显示。交互式BOM能不能发挥最大作用前提是元件库的数据规范。强烈建议画板之前就把元件的Value、Footprint、厂商料号、供应商料号这些字段建好物料管理和BOM管理应该从建库那天就开始而不是等到导出BOM那天才想起来。6.2 版本归档与团队协作建议每次发板出去我都会让流程固定下来Gerber、坐标文件、BOM Excel、交互式HTML这四件套一起归档放进以“项目名_版本号_日期”命名的文件夹里。这样后续无论是改板还是返单都能找到当时的完整数据。跟团队协作时有个更实际的建议不要只把HTML文件发给一个岗位。焊接工位需要它定位元件维修岗位需要它反向查参数品质部门需要它核对物料一致性采购部门需要它整理备料清单。一个文件全公司都能用比每个人手里一份不同版本的Excel靠谱得多。最后再分享一个小习惯。我手焊样板时会把交互式BOM按Value过滤出某一类元件然后把对应的位号表截图贴在工位旁焊完一类划掉一类。这种笨办法配上这个插件的交互定位我最近那块0.5mm间距LQFP封装的板子手焊了四十多颗物料错料率基本为零。InteractiveHtmlBomForAD不是什么高深工具但它是把“元器件清单”从一张表格变成一个可交互的设备地图的工具一旦用过就很难回去了。本文还有配套的精品资源点击获取