做工厂自动化的朋友一定对BarTender不陌生标签排版、条码生成、打印管理是它的看家本领。但如果生产线上每天要打印几百上千张不同内容的标签还在人工改模板、手动点打印早晚会被拖垮。用Python控制BarTender软件打印就是把“打开模板→填入数据→选择打印机→点打印”这串重复劳动交给脚本几十行代码就能让标签打印自动跑起来。这篇东西从环境配置讲到踩坑记录适合正在琢磨怎么把BarTender和MES、ERP对接的人也适合刚开始接触Python打印自动化的新手。1. 思路拆解为什么用Python“指挥”BarTender1.1 实际业务场景批量标签、动态数据、与MES/ERP对接BarTender本身是个很成熟的标签打印软件但它本质上是个图形化工具。你可以把标签模板排得很好看条码、二维码、文本、图片、表格都安排到位可一旦标签内容是动态变化的麻烦就来了。最常见的场景是生产线上打序列号标签。今天生产1000台设备每台设备有单独的序列号、批次、生产日期、物料代码这些数据来自MES系统或者ERP系统。人工操作的话一个人一天能做的也就是几百张而且特别容易漏打、重打、打错序列号。更烦的是有些订单的标签内容还不完全一样型号不同、数量不同、客户要求的条码格式也不同靠模板复制粘贴去维护基本是一场灾难。于是“Python控制BarTender打印”就成了一个很自然的需求。BarTender负责输出规范、稳定、可扫描的标签Python负责把业务系统里的数据变成一条条打印指令。比如产线上扫一下工单号Python就从数据库里查出对应的型号、数量、序列号区间自动打开BarTender模板把数据填进去调用打印接口一气呵成。整个过程不需要人再去碰BarTender界面。这类需求的另一个常见入口是ERP里已经有了一份Excel或CSV数据表里面是几千条标签内容需要按某个模板批量打印。传统做法是手工在BarTender里导入数据源再做“打印预览”找到不同之处费时费神。用Python脚本只需要监控某个目录下的新文件或者通过接口拉取数据然后批量触发打印。1.2 方案选型COM接口、命令行、SDK到底选哪个做技术方案时市面上可选的路子其实有三条COM/ActiveX自动化、BarTender命令行、官方的.NET SDK。我实际用下来绝大多数场景首选COM自动化也就是Python通过win32com来调用BarTender。三者的对比如下方案实现方式适用场景上手难度COM自动化Python win32com.client.Dispatch动态改标签内容、选打印机、嵌入业务系统低命令行模式bartend.exe /F /P 等参数固定模板、固定打印机、简单批量打印最低.NET SDK官方SDK封装大型系统集成、C#生态中高为什么推荐COM因为BarTender把它的对象模型暴露出来了Python可以通过win32com.client.Dispatch(BarTender.Application)拿到正在运行的BarTender实例然后操作文档、修改变量、指定打印机。这种方式对数据的控制最灵活比如你想根据数据库内容动态修改序列号、型号、批号或者一个标签里同时出现多个动态字段COM都能搞定。命令行方式适合“模板参数已经固定只负责打印”的场景但数据交互弱很多变量没法方便地传进去。.NET SDK功能更强但需要在项目里引用BarTender的SDK程序集Python用起来绕了一圈部署也麻烦。所以除非是公司统一的技术栈规定用C#否则Python脚本走COM是最划算的方案。需要多说一句BarTender的COM自动化是基于Windows的整套方案只能在Windows环境跑。如果你指望放在Linux服务器上远程控制打印那这条思路基本走不通还得回到Windows虚拟机或者专用打印服务器上。2. 动手前的准备Python环境与模板设计2.1 安装Python依赖Python侧所需要的核心依赖只有一个pywin32它包含了win32com.client和win32print。前者负责调用BarTender的COM接口后者用来枚举Windows系统里的打印机列表。安装就一条命令pip install pywin32安装完以后建议先做一个最基础的连通性检查python -c import win32com.client; print(ok)能正常输出ok说明环境基本没问题。这里有个小坑如果你使用的是绿色版Python或者某些公司精简过的虚拟环境pywin32装完后可能出现ImportError此时一般重新跑一下安装命令或者安装完整版Python就能解决。另外Python的32位和64位版本在调用COM时偶尔会有位宽不一致的报错真碰到429这种ActiveX错误可以换一下Python的位数再试。2.2 BarTender软件侧配置Python环境准备好了还不够BarTender本身也要能接受自动化调用。首先BarTender必须已经完整安装最好在电脑上手动打开过一次确认软件能正常运行。如果你装的是试用版或者公司服务器上用的授权没有购买“自动化”相关的模块那么Python调用COM时可能报权限类错误或者BarTender界面突然弹出来但脚本卡住不动。这个问题最隐蔽排查优先级反而要排在最前面。其次如果公司IT策略比较严格BarTender的ActiveX自动化可能会被管理员通过组策略禁用。遇到这种情况需要去BarTender的系统设置或Administrator控制台里确认Automation/ActiveX相关选项处于启用状态。不同版本的BarTender菜单位置有差异但搜索“Automation”基本都能找到。还有一点如果打算让脚本在无人值守的情况下长期运行建议在Windows的“计划任务程序”里创建一个手动登录会话下的计划任务而不是把Python脚本做成Windows服务直接后台运行。COM自动化在会话0和服务器环境中比较容易出现权限和界面交互问题用计划任务方式可以省掉很多麻烦。2.3 模板变量怎么命名才是关键很多初学者最容易栽在“变量名”上。BarTender模板里可以有很多文本对象但这些文本对象本身不是Python可以随便改的动态变量。你要修改某个文本里的局部内容通常需要把它设置为“命名子串”也就是named substring。举个例子。模板里有一行文本显示型号: %Model% 序列号: %SN%我想让Python分别改“Model”和“SN”那就需要在BarTender设计界面中找到那个文本对象在文本编辑器里选中%Model%这段子串然后在属性窗口里给它起一个名字比如就叫Model。同样地给%SN%命名为SN。保存模板后Python才能通过NamedSubStrings(Model)和NamedSubStrings(SN)去赋值。变量命名有几点建议全部用英文、数字、下划线不要带空格。名称要和业务字段一一对应比如数据库里的part_no就叫part_no别叫p1。大小写尽量保持一致COM接口里的名字在很多版本中是大小写敏感的。如果标签里同时有二维码和文本需要确保二维码的数据源也指向同一个命名子串这样二维码内容才会跟着文本一起变。这些细节决定了脚本写出来以后是能复用还是到处打补丁。我见过太多人模板里的变量名是“Text1”“Text2”Python脚本里全是一堆看不懂的fmt.NamedSubStrings(Text1)换一个标签样式就要全部重写。命名整理清楚后面能省一大半时间。3. Python调用BarTender的实操过程3.1 连接COM实例打开标签模板一切准备妥当以后终于可以写代码了。先用Dispatch连接到BarTenderimport win32com.client bt_app win32com.client.Dispatch(BarTender.Application) print(BarTender version:, bt_app.Version)执行这行代码时BarTender会自动启动。如果电脑上已经有一个BarTender窗口打开着Python也会连接上那个正在运行的实例而不是再启动一个。这对调试有好处你可以在旁边开着BarTender观察脚本每一步的效果。接下来是打开标签模板fmt bt_app.Documents.Open(rD:\labels\product_label.btw, False)第二个参数按False传目的是避免打开过程中出现额外的用户交互弹窗。这里要注意路径最好用绝对路径并且模板文件的扩展名通常为.btw。如果一次性打开多个文档建议每打开一个就用变量接住返回的Format对象不要依赖ActiveDocument因为多窗口环境下ActiveDocument很容易拿错对象。打开模板后可以做一次简单检查确认模板确实被正确加载。比如打印一下模板里的命名子串数量或者先读取某个子串当前的值try: val fmt.NamedSubStrings(model).Value print(current model:, val) except Exception as e: print(NamedSubStrings error:, e)这个技巧在排查“为什么改数据没生效”时特别有用。3.2 动态写入数据NamedSubStrings与变量模板打开后就可以往里填数据了。还是用之前设计的命名子串fmt.NamedSubStrings(model).Value PLC-2000 fmt.NamedSubStrings(batch).Value 20240601-A fmt.NamedSubStrings(qty).Value 100这里有个细节Value接收的是字符串不接收数字。所以赋值之前最好先转成str()不然遇到qty字段是整数时COM接口可能报类型转换错误。日期和时间字段也一样建议先在Python里格式化好from datetime import datetime fmt.NamedSubStrings(date).Value datetime.now().strftime(%Y-%m-%d)如果你的标签内容不是直接显示在文本对象里而是来自BarTender的数据库字段那情况会复杂一点。比如模板绑定了一个外部Excel作为数据源Python这边硬改NamedSubStrings可能并不能改变数据库字段的值。正确的做法是让Python去更新Excel或数据库表然后通过BarTender的数据库连接刷新标签。这个在下一部分讲批量打印时再展开。3.3 选择打印机并执行打印标签内容填好以后最核心的一步是打印。不过打印之前得先确认打印机名称。Windows系统里打印机名要和“控制面板 → 打印机”里看到的名称完全一致建议用Python枚举一遍import win32print printers [p[2] for p in win32print.EnumPrinters(2)] for name in printers: print(name)枚举出来的列表中name就是可直接传给BarTender的打印机名。比如我的环境里有一台Zebra GK420d名字可能是ZDesigner GK420d。接着执行打印fmt.PrintOut(False, False, 2, ZDesigner GK420d)这里的四个参数我按照实际项目里的用法解释一下第一个参数False表示不弹出打印设置对话框。第二个参数False表示普通打印不作为导出文件处理。第三个参数是打印份数传几就打印几张。第四个参数是打印机名字符串。为什么强调“份数和打印机名是最重要的两个参数”因为在生产环境里最容易出问题的就是这两项。份数传错会导致标签重复打印或漏打印打印机名传错会导致打印任务跑到别的机器上。如果打印机名叫错了BarTender通常不会直接报错而是默默使用模板默认打印机这个坑非常容易踩。如果你的标签模板本身已经指定了默认打印机第四参数也可以传空字符串fmt.PrintOut(False, False, 2, )这样BarTender会用模板默认打印机。不过为了可追溯我建议每次都在代码里明确指定打印机。3.4 完整示例批量打印标签把前面几个环节串起来一个最简单的批量打印脚本就是这样的import time import win32com.client import win32print PRINTER_NAME ZDesigner GK420d TEMPLATE_PATH rD:\labels\product_label.btw data_list [ {model: PLC-2000, sn: SN0001, qty: 1}, {model: PLC-2000, sn: SN0002, qty: 2}, {model: HMI-7, sn: SN0003, qty: 1}, ] bt_app win32com.client.Dispatch(BarTender.Application) fmt bt_app.Documents.Open(TEMPLATE_PATH, False) for item in data_list: fmt.NamedSubStrings(model).Value item[model] fmt.NamedSubStrings(sn).Value item[sn] fmt.NamedSubStrings(qty).Value str(item[qty]) fmt.PrintOut(False, False, item[qty], PRINTER_NAME) time.sleep(0.2) fmt.Close(False) bt_app.Quit()这段代码的逻辑很直白一次打开模板循环填充数据逐条打印最后关闭文档并退出BarTender。有几个经验值得分享循环数量较大的时候不要每次都重新打开模板。打开文档是COM操作里比较慢的一步一次打开、多次赋值的模式效率比反复开关模板高得多。在循环里加一点time.sleep(0.2)是为了避免在极短时间内连续触发打印导致BarTender内部队列拥堵或者打印机驱动来不及响应。份数小的时候不加也没事大批量时能明显减少丢任务。fmt.Close(False)的False表示关闭文档时不保存修改。因为我们的脚本只是在运行时修改了子串的值并不希望把这些临时数据写回模板文件所以不要传True。3.5 不写Python也行的命令行模式备选如果使用场景非常简单比如模板固定、打印机固定、只需要把CSV数据源丢给BarTender打印可以看看你安装的BarTender版本是否支持命令行模式。BarTender安装目录下通常有bartend.exe可以用类似下面的参数调用bartend.exe /FD:\labels\product_label.btw /P /DD:\data\labels.csv不同版本命令参数略有差异有些版本还支持/C份数、/S打印机名等参数。具体以你安装版本的官方命令行参考为准。命令行模式最大的优势是不需要写Python脚本用批处理或计划任务就能触发劣势是数据交互和错误处理都比较弱一旦打印失败很难在业务系统里做联动处理。所以我一般把它当作“备选方案”生产系统里还是走COM自动化更可靠。4. 常见问题与排查技巧实录4.1 COM调用失败或连接超时最常出现的错误是win32com.client.Dispatch直接抛异常或者报一个类似“无效类字符串”的错误。看到这类问题按下面的顺序排查先确认BarTender真的安装了。这个听起来很蠢但我在实际项目里见过有人在没装BarTender的机器上跑脚本自然报错。装好以后手动打开一次BarTender确认软件能正常进到主界面。再检查Python位数。如果BarTender是32位版本而你用的是64位Python在部分系统上COM调用会失败。反之亦然。这时换一个位数一致的Python环境问题通常就消失了。然后检查许可证。BarTender有“Automation”相关的授权模块某些试用版或基础版不允许外部程序调用ActiveX接口。如果代码连接正常但打印时弹出“无法执行该操作”之类的提示十有八九是授权问题。最后检查运行权限。计划任务是否以管理员身份运行、当前用户是否属于有权限访问BarTender的组这些都会影响COM调用的稳定性。另外作为Windows服务运行Python脚本会比作为普通进程运行更容易出权限问题建议尽量用计划任务代替。4.2 内容不刷新或打印出旧数据脚本跑起来了打印也出来了但Next条标签内容和上一条一样或者一直都是模板里的默认值。这个问题我遇到得最多。原因基本是三类NamedSubStrings名称写错赋值赋到了一个不存在的子串上界面又没有任何报错。模板里真正起作用的是数据库字段而不是文本子串Python只改了界面上的静态文本。条码和文本使用的是两个不同的数据源文本改了条码没改。排查时先做一个最小验证打印之前读取一下刚才赋的值确认是否已经写进去。比如fmt.NamedSubStrings(sn).Value SN0001 print(fmt.NamedSubStrings(sn).Value)如果读出来确实是SN0001说明赋值生效问题出在打印或模板设计如果读出来还是旧值说明名字可能写错了或者模板里没有这个命名子串。如果标签内容来自数据库你得换个思路让Python去更新数据源。比如模板绑定了一张Excel表脚本就把新的SN写进Excel然后让BarTender刷新数据库连接。直接把Python的变量硬塞进数据库字段在COM层面并不总是支持这也是很多初学者百思不得其解的地方。4.3 条码扫不出来或打印出来比例不对标签打印出来最尴尬的问题是东西印出来了但条码枪扫不出来。这个锅不一定在Python但在自动化打印场景下Python侧可以把好关。先检查条码内容本身。如果你往二维码里放的内容是一个字符串而这个字符串里带着换行符、回车符或者不可见字符条码枪很可能扫不出正确结果。Python里最简单的处理方式就是加一个strip()barcode_data data[barcode].strip() fmt.NamedSubStrings(barcode).Value barcode_data另外如果条码内容包含中文条形码通常不支持二维码则要保证字符编码正确。BarTender模板里不要用系统默认字体去生成QR码最好用专门的QR码对象并把模式设置为自动或二进制这样才能兼容中文。还有和打印机驱动相关的问题。条码打出来发虚、边缘不清晰基本都是打印浓度过低或打印速度太快。这个不在Python脚本里控制而是要去调整打印机驱动里的浓度、速度参数。203dpi的打印机打小标签时喜欢把速度降到76mm/s甚至更低条码扫码成功率会明显提升。4.4 长期运行崩溃、内存增长、BarTender进程残留批量打印几千张标签时脚本在本地跑几天之后可能会出现越来越慢甚至报内存不足的情况。这是因为COM调用每一次都要跨进程传递数据BarTender自己也可能会残留一些临时对象。我的建议是单次任务处理完一定要bt_app.Quit()并在退出前把文档关闭。如果任务量非常大不要一个进程跑几个小时可以参考“分段重启”策略比如处理500条后主动退出BarTender再重新启动Python脚本继续下一批。在循环里只保留必要的引用对象用过的变量及时清理。某个Format对象不再使用时设置成None让Python垃圾回收去处理。关注Windows任务管理器里的BarTender进程。如果脚本结束后进程还在多半是COM实例没有真正退出后续调用可能会越连越多。有一种极端情况标签内容里大部分是重复的只有少量字段不同。这时不必每条都单独调用PrintOut可以把相同内容合并成一份只在差异点上切换打印份数直接传给BarTender。这样会大幅降低COM调用次数减少因跨进程通信带来的性能损耗。最后说点实际体会。自动化打印这件事真正难的不是Python代码怎么写而是你对自己业务数据的理解程度。我在做第一个BarTender自动化项目时花了大量时间改模板里的变量名和数据结构真正写脚本的时间反而很少。先把模板里的命名子串、数据库字段、打印机列表整理成一张映射表再让Python按表操作后面会顺畅很多。如果你手里已经有了一套成熟的BarTender模板建议先拿一条产品线做自动化试点跑通后再逐步扩大范围这个过程中踩到的坑就是你后面最值钱的经验。