简介SolidWorks二次开发参数化建模项目源码包面向具备C基础、希望借助SolidWorks API实现零件尺寸与结构自动驱动的高校学生和工程技术人员。包内以h头文件、cpp源文件为核心配套tlh类型库、dll/lib等编译与接口文件以及bmp界面位图和工程配置共95个文件、约4.33MB呈现了从界面交互到模型参数化生成的完整工程组织。已有624人学习下载可作为课程设计、毕业设计或企业插件原型的参考。读者可从中了解SolidWorks二次开发中部件文档访问、参数读写、对话框与属性页搭建、类型库引入及VC6工程编译的组织思路并借助现成工程快速定位函数封装与模块划分减少从零搭建环境的时间。同时可观察DLL注册、属性页与文档对象封装等细节为独立完成参数化插件开发提供可复用参考源码结构较完整适合对照调试和二次扩展但需具备一定的COM与C阅读能力。1. 从一张图改到一百张SolidWorks 二次开发与参数化建模到底解决什么问题一张零件图改一个孔距装配体里的配合开始报警工程图上的标注跟着跑位这种场景在 SolidWorks 二次开发和参数化建模落地时几乎躲不开。资源包要解决的不是“教你点菜单”而是把 API 连接、尺寸驱动、配置切换、装配重建、工程图导出串成一条可复现的链路让改参数这件事从手工动作变成可重复执行的脚本。它适合三类人经常做系列化零件、一天要改十几套尺寸的建模工程师手里有大量历史图纸、想做批量替换和导出的工艺人员以及已经会用 VBA 录宏、但脚本一换机器就翻车的二次开发新手。资源里的示例零件、参数表模板和脚本骨架价值在于把对象名、单位、重建顺序这些容易踩坑的细节固定下来。2. 拆开源码包看骨架COM 入口、对象链与参数化建模的数据流SolidWorks 二次开发绕不开 COM。无论外面包的是 C# 插件、VBA 宏还是 Python 批处理最终都要落到SldWorks.Application这个入口再沿ISldWorks - IModelDoc2 - IConfiguration - IFeature - IDimension的对象链往下取东西。资源包把这条链拆成三层不是为了好看而是为了让“连接失败”“打开失败”“尺寸取不到”“重建失败”这四类问题能分开排查。第 2 章先不急着写业务先把最小链路跑通后面参数化建模才有地基。2.1 先认 COM 入口为什么录制宏比翻文档更快新手最容易犯的错是拿着一张对象模型图硬背。SolidWorks 的 API 文档很全但对象名、方法签名、返回类型在不同版本里有差异光看文档很容易写出“语法对、运行空引用”的代码。我一般会让对方先做一件事在 SolidWorks 里手动改一个尺寸同时录制宏然后看宏里到底用了哪个对象、哪个方法、尺寸全名长什么样。宏录出来的代码不一定优雅但它能告诉你当前这台机器、当前这个界面语言下对象是怎么被拿到的。比如同一个草图尺寸中文界面可能叫D1草图1英文界面可能叫D1Sketch1。脚本里写死一个名字换一台机器就找不到。资源包里的示例脚本没有把尺寸名藏在代码深处而是放到参数表或配置项里就是为了让这种差异暴露在明面上。常见做法是先用宏录制拿到“尺寸全名”再把全名写进参数表脚本只负责读表、匹配、赋值。这样界面语言变了改表比重写代码便宜。选型上VBA 适合快速验证和单人小工具C# 适合做常驻插件和强类型封装Python 适合批处理和跟 Excel、数据库打交道。资源包没有强行统一一种语言而是把连接层和模型层用脚本示例讲清楚批处理层留出接口。下面这张表是实际落地时的取舍不是语言优劣排名。方式适合场景优点边界VBA 宏验证对象名、单人改图录制快、无需编译难维护、异常处理弱C# 插件团队工具、菜单按钮强类型、易做界面需要工程配置和部署Python 脚本批量读表、批量导出改起来快、生态多COM 调用要处理类型和释放2.2 资源包的三层骨架连接层、模型层、批处理层连接层只干一件事拿到ISldWorks设置可见性处理打开文档的返回值。模型层负责“打开哪个文档、激活哪个配置、改哪个尺寸、什么时候重建”。批处理层负责“从 Excel 读多少行、每行输出什么文件、失败了怎么记”。三层混在一起写脚本短的时候没事一旦要批量跑几百个配置日志里全是“失败”你根本不知道是连接断了、尺寸名错了还是导出路径没权限。资源包里的示例把路径、尺寸名、输出目录都提到外部参数里代码里只保留流程。这个做法看起来多了一步但它把“改参数”和“改代码”分开了。参数化建模的核心不是写多少行代码而是让尺寸、配置、输出命名变成可管理的数据。尺寸名、配置名、导出名这三样东西一旦进了表后面做版本对比、回滚、重跑都方便。2.3 最小可运行链路连接、打开、改尺寸、重建、保存先跑一个最小链路不要一上来就批量。下面这段 Python 用win32com.client连接 SolidWorks打开一个示例零件按尺寸全名改值重建并保存。代码里的路径、尺寸名、目标值都是示例替换成你手头的模板即可。import win32com.client SW_PATH rD:\demo\demo_part.SLDPRT DIM_NAME D1草图1 # 尺寸全名先用宏录制确认 NEW_VALUE_MM 42.5 sw win32com.client.Dispatch(SldWorks.Application) sw.Visible True model sw.OpenDoc(SW_PATH, 1) # 1 零件2 装配体3 工程图 if model is None: raise RuntimeError(打开失败先查路径、文件占用、SolidWorks 是否已正常启动) dim model.Parameter(DIM_NAME) if dim is None: raise RuntimeError(f找不到尺寸 {DIM_NAME}用宏录制或 FeatureManager 确认全名) dim.SystemValue NEW_VALUE_MM / 1000.0 # API 尺寸单位是米 ok model.EditRebuild3() if not ok: raise RuntimeError(重建失败查过定义、方程式循环、配置是否激活) model.Save3(1, 0, 0) # 静默保存不同版本参数类型报错时用录制宏核对签名 sw.CloseDoc(model.GetTitle())这段代码的逻辑是“连接 - 打开 - 取尺寸 - 赋值 - 重建 - 保存 - 关闭”。OpenDoc的第二个参数是文档类型零件传 1装配体传 2工程图传 3。Parameter拿到的对象是尺寸SystemValue的单位是米所以毫米要除以 1000。EditRebuild3返回布尔值失败时不要继续保存否则会把错误状态写进文件。Save3的第一个参数是保存选项示例用 1 表示静默保存如果当前版本提示参数类型不对不要猜直接用宏录制一次保存动作按录制出来的签名改。注意Parameter的尺寸全名跟界面语言、配置、特征名都有关。先在目标模板上录制宏确认全名再写进参数表。最小链路跑通的标准不是“没报错”而是打开文件后肉眼看到尺寸变了、重建后模型没报错、保存后重新打开值还在。三个条件缺一个后面批量跑得越快错得越多。3. 参数化建模落地从 Excel 参数表到尺寸、配置与批量导出参数化建模最容易写成“把尺寸写死在代码里”。这样做的后果是每来一个新型号就要改脚本改完还要重新测。资源包的做法是把驱动尺寸、配置名、导出名放进 Excel脚本只认表头。第 3 章把参数表设计、尺寸赋值、配置切换、批量导出这四件事拆开讲重点不是代码多高级而是参数边界在哪里、失败时看什么。3.1 参数表怎么设计驱动尺寸、从动尺寸、配置名、导出名参数表不要只放“尺寸名”和“值”两列。实际落地时至少要有配置名、尺寸全名、目标值、单位、导出名、导出类型、是否启用。配置名决定脚本激活哪个配置尺寸全名决定改哪个对象单位决定要不要换算导出名决定输出文件叫什么是否启用决定这一行要不要跑。多一列“备注”不是浪费后面排查“为什么这行没跑”时能救命。下面这张表是资源包里参数模板的字段设计列名可以改但含义不要省。字段含义示例注意config_name要激活的配置名配置A必须与模型内配置完全一致dim_name尺寸全名D1草图1中文/英文界面不同value_mm目标值毫米42.5脚本内除以 1000export_name输出文件名零件A.step不带路径路径由脚本拼export_type导出类型step/pdf/dxf大小写统一enabled是否执行1/0空值按不执行处理驱动尺寸和从动尺寸要分开。驱动尺寸是你能改的从动尺寸是方程式或关系算出来的。脚本只改驱动尺寸改从动尺寸要么被方程式覆盖要么直接报错。资源包的示例表里有一列“类型”不是为了分类好看而是提醒执行时跳过从动项。常见做法是先在模型里把关键尺寸重命名比如孔距_主、板厚再让参数表用这些可读名而不是全靠D1草图1这种系统名。3.2 用 API 改尺寸并重建代码与参数边界批量脚本不要每改一个尺寸就保存一次。正确顺序是打开模板循环配置激活配置改尺寸重建导出最后统一保存或关闭。下面这段代码读 Excel按行激活配置、改尺寸、按类型导出。示例只写 STEP 分支PDF 和 DXF 用同样的思路加分支。import os import openpyxl import win32com.client PARAM_XLSX rD:\demo\params.xlsx TEMPLATE rD:\demo\template_part.SLDPRT OUT_DIR rD:\demo\out os.makedirs(OUT_DIR, exist_okTrue) wb openpyxl.load_workbook(PARAM_XLSX, data_onlyTrue) ws wb[params] rows list(ws.iter_rows(min_row2, values_onlyTrue)) sw win32com.client.Dispatch(SldWorks.Application) sw.Visible False model sw.OpenDoc(TEMPLATE, 1) if model is None: raise RuntimeError(模板打开失败) for row in rows: config_name, dim_name, value_mm, export_name, export_type, enabled row[:6] if not enabled or not config_name or not dim_name: continue model.ShowConfiguration2(config_name) # 激活目标配置 dim model.Parameter(dim_name) if dim is None: raise RuntimeError(f{config_name} 下找不到 {dim_name}) dim.SystemValue float(value_mm) / 1000.0 if not model.EditRebuild3(): raise RuntimeError(f{config_name} 重建失败先停在这一行排查) out_path os.path.join(OUT_DIR, export_name) if str(export_type).lower() step: model.SaveAs3(out_path, 0, 2) # 0 覆盖2 静默签名用宏录制核对 else: raise RuntimeError(f未处理的导出类型{export_type}) model.Save3(1, 0, 0) sw.CloseDoc(model.GetTitle())逻辑上ShowConfiguration2先激活配置Parameter再按尺寸全名取对象。顺序反了可能取到默认配置的尺寸改完看起来成功实际改错了地方。EditRebuild3放在导出之前导出放在保存之前是为了让输出文件反映最新几何。参数上PARAM_XLSX、TEMPLATE、OUT_DIR都提到外部换项目只改这三处。value_mm转 float 再除以 1000空值或文本会在这一行直接报错比后面导出空文件好查。注意SaveAs3的参数在不同版本里可能要求不同签名不要照抄网上代码。录制一次“另存为 STEP”的宏按宏里的参数改。3.3 配置与方程式什么时候用配置什么时候用方程式配置适合“同一套拓扑、不同尺寸组合”的系列件。比如一块安装板孔距、板厚、边距有三组标准值用配置切换比复制三个文件好维护。方程式适合“尺寸之间有固定关系”的场景比如板厚变了筋厚按比例跟着变。两者的边界是配置管“选哪一组值”方程式管“值之间怎么算”。脚本改配置里的驱动尺寸时方程式会自动重算从动尺寸脚本如果去改从动尺寸要么被覆盖要么触发重建失败。资源包里的示例模型把驱动尺寸放在配置里把比例关系放在方程式中。批量跑之前先手动切一遍配置确认每个配置都能重建。常见翻车是配置里有一个尺寸被压缩了脚本一激活就报错但错误信息不会告诉你“这个配置本来就有问题”。所以参数表里加一列“预检通过”跑批量前先按配置做一次空跑只激活、只重建、不导出。3.4 批量导出STEP/PDF/DXF 的命名与失败重试批量导出不要用“零件名时间戳”这种不可预测的命名。参数表里的export_name要能一眼看出是哪个配置、哪组参数。输出目录按批次分别把几百个文件倒进同一个文件夹。失败重试不要无脑循环先区分“文件被占用”“路径不存在”“导出类型不支持”三类。文件被占用时重试有用路径不存在时重试一百次也没用。我一般会在导出前做三件事检查输出目录可写、检查同名文件是否只读、检查模型是否处于轻化或压缩状态。轻化模式在大装配里能提速但脚本改尺寸前要确保参考已加载否则会出现“尺寸改了、几何没变”的玄学现象。资源包里的批处理脚本没有默认开轻化就是为了让第一次跑的人先看到真实重建结果等链路稳定后再按装配规模决定要不要开。4. 装配体与工程图联动改一个孔距后谁先重建、谁后更新零件级参数化建模跑通后下一步一定是装配体和工程图。很多脚本在零件里改尺寸没问题一到装配体就出现配合报警一到工程图就出现标注跑位。根因通常不是 API 不会用而是重建顺序错了。第 4 章按“零件 - 装配体 - 工程图”的顺序讲联动重点讲骨架草图、配合参考、模型项和轻化模式的取舍。4.1 装配体配合的驱动逻辑骨架草图、布局、参考关系装配体参数化不要直接改零件上的配合面尺寸先看这个尺寸有没有被骨架草图或布局驱动。常见做法是在装配体里建一个骨架草图把关键孔距、总长、安装高度放在骨架里零件通过“转换实体引用”或“派生草图”引用骨架。这样脚本只改骨架尺寸零件和配合跟着更新。直接改零件尺寸也能跑但配合关系多的时候重建顺序很难控制。资源包里的示例装配体用了一个简化骨架零件上的两个安装孔通过骨架草图定位。脚本改骨架尺寸后先重建骨架所在零件再重建装配体。如果先重建装配体骨架还没更新配合会按旧几何算结果就是报警。这个顺序不是 SolidWorks 的硬性规定是实际跑批量时总结出来的血泪经验谁被谁引用谁就先重建。4.2 工程图标注跟随模型项、尺寸覆盖与重建顺序工程图能不能跟着更新取决于标注是不是“模型项”。从模型插入的尺寸模型改了它会跟着变手动标注或覆盖过的尺寸可能不会自动更新。脚本能做的是重建工程图但没法替你把手动覆盖的标注改回模型项。所以参数化建模要在建模阶段就把工程图模板定好该用模型项的用模型项该用从动尺寸的用从动尺寸别在工程图里手工改数值。重建顺序上零件保存后再打开工程图工程图重建前先确保参考模型已加载。工程图里如果用了轻化模式脚本重建前要解析轻化组件否则会出现“模型已改、图纸没动”的情况。资源包里的示例工程图没有开轻化批量导出 PDF 前先EditRebuild3再保存再导出。这个顺序看起来笨但稳定。4.3 批量替换与轻化模式大装配提速的取舍大装配批量跑轻化模式能明显缩短打开时间但脚本改尺寸、重建、导出这三步对轻化的容忍度不一样。打开可以轻化改尺寸前要确保目标零件已加载重建装配体时要解析轻化组件导出工程图时又要确保模型项已刷新。资源包没有把轻化开关写死而是留了一个配置项让使用的人按装配规模决定。常见做法是小装配直接全加载别为了省几秒引入不确定性大装配先轻化打开只对本次要改的零件做解析改完重建再保存。批量替换零件时不要一边替换一边重建先把替换清单跑完再统一重建。替换过程中每步都重建失败点会被放大日志也很难看懂。4.4 一个可复现的端到端脚本改参数、重建装配、导出图下面这段脚本把零件、装配体、工程图串起来。它先改零件尺寸并保存再打开装配体解析轻化组件、重建、保存最后打开工程图重建并导出 PDF。示例路径和尺寸名都要替换成你的模板。import win32com.client PART rD:\demo\demo_part.SLDPRT ASSEMBLY rD:\demo\demo_assy.SLDASM DRAWING rD:\demo\demo_drawing.SLDDRW DIM_NAME D1草图1 NEW_MM 50.0 sw win32com.client.Dispatch(SldWorks.Application) sw.Visible True part sw.OpenDoc(PART, 1) if part is None: raise RuntimeError(零件打开失败) dim part.Parameter(DIM_NAME) if dim is None: raise RuntimeError(f零件里找不到 {DIM_NAME}) dim.SystemValue NEW_MM / 1000.0 if not part.EditRebuild3(): raise RuntimeError(零件重建失败) part.Save3(1, 0, 0) assy sw.OpenDoc(ASSEMBLY, 2) if assy is None: raise RuntimeError(装配体打开失败) assy.ResolveAllLightWeightComponents(True) # 轻化组件先解析 if not assy.EditRebuild3(): raise RuntimeError(装配体重建失败查配合和参考) assy.Save3(1, 0, 0) drw sw.OpenDoc(DRAWING, 3) if drw is None: raise RuntimeError(工程图打开失败) if not drw.EditRebuild3(): raise RuntimeError(工程图重建失败查模型项和参考) drw.Save3(1, 0, 0) drw.SaveAs3(rD:\demo\out\demo_drawing.pdf, 0, 2) sw.CloseDoc(drw.GetTitle()) sw.CloseDoc(assy.GetTitle()) sw.CloseDoc(part.GetTitle())逻辑是“零件先改、装配再跟、工程图最后刷”。ResolveAllLightWeightComponents(True)放在装配体重建前是为了让轻化组件参与计算工程图没有加这一步因为示例工程图没开轻化如果你的模板开了按同样思路先解析再重建。参数上NEW_MM是毫米SystemValue前除以 1000SaveAs3的 PDF 路径要提前建好目录。失败时先看哪一步的RuntimeError先抛出来不要跳步重跑。顺序对象动作失败先看1零件改尺寸、重建、保存尺寸全名、过定义、方程式2装配体解析轻化、重建、保存配合参考、骨架是否更新3工程图重建、保存、导出模型项、参考路径、轻化5. 避坑与排查SolidWorks 二次开发最常见的五个翻车点SolidWorks 二次开发的报错信息经常很“黑匣子”同一个空引用可能是位宽问题也可能是文档没打开。避坑章不列大道理只记五类实际跑批量时最常遇到的翻车连上了却空引用、改完尺寸重建失败、批量导出卡死、工程图不更新、换机器就报错。每条按“现象 - 原因 - 解决”写方便对着日志查。5.1 连上了却空引用先查位宽、COM 注册和文档返回值现象脚本能启动 SolidWorksDispatch也没报错但一取model.Parameter就空引用或者OpenDoc返回None。原因常见有三种。脚本进程位数和 SolidWorks 不一致COM 调用能看到应用但拿不到文档对象SolidWorks 没有正常完成启动Dispatch拿到的是壳OpenDoc的路径或文档类型不对返回值本来就是空。还有一种隐蔽情况文件被另一个进程占用打开失败但不抛异常。解决先看OpenDoc返回值空就停不要往下走。确认脚本和 SolidWorks 位数一致路径用绝对路径文档类型别把装配体写成零件。文件被占用时先关闭占用程序或者复制一份到临时目录再打开。空引用不要靠加try吞掉吞掉之后日志里只剩“失败”没有原因。5.2 改完尺寸重建失败过定义、方程式循环、配置没激活现象SystemValue赋值成功EditRebuild3返回 False模型树上出现红色报错或者几何根本没变。原因尺寸改大了导致草图过定义方程式之间互相引用形成循环目标尺寸属于另一个配置当前配置没激活尺寸是从动尺寸被方程式覆盖。还有一种情况是尺寸名取到了但取到的是工程图里的从动尺寸赋值不生效。解决先在界面上手动改同一个尺寸看会不会报错排除模型本身的问题。脚本里在赋值前打印当前配置名确认ShowConfiguration2成功。从动尺寸不要改改它的上游驱动尺寸。重建失败时不要保存保存会把错误状态写进文件。批量跑之前每个配置做一次“只激活、只重建、不导出”的空跑。5.3 批量导出卡死或文件被占用事件没释放、Visible 设置不当现象跑几十行后脚本卡住SolidWorks 无响应或者导出目录里出现一堆 0 字节文件或者提示文件被占用。原因每轮都新建Dispatch但没有释放COM 对象越积越多Visible设成 True 但界面弹窗没人点导出路径不存在或同名文件只读SaveAs3失败后脚本继续跑下一行错误被淹没。解决整个批次只建一个Dispatch循环内复用批量时Visible设 False但失败排查时临时设 True 看弹窗导出前检查目录和只读属性每行导出后检查文件是否存在且大小大于 0。不要用无限重试掩盖路径错误路径错重试一百次还是错。5.4 工程图尺寸不更新、标注跑位模型项丢失和重建顺序错现象零件尺寸改了装配体也重建了工程图打开后尺寸还是旧值或者标注跑到视图外面。原因工程图里的标注不是模型项是手动标注或覆盖过的尺寸工程图参考的模型没保存先重建工程图再重建零件顺序反了工程图开了轻化参考模型没解析。解决建模阶段就把工程图模板定好关键尺寸用模型项插入少在工程图里手工改值。脚本顺序按“零件保存 - 装配保存 - 工程图重建”走。工程图开轻化时重建前先解析参考。标注跑位如果是视图比例或图纸格式导致脚本改不了要在模板里修。5.5 换机器就报错路径、模板、语言、单位四个变量现象同一份脚本在自己机器上跑得好好的换一台机器就找不到尺寸、打开失败、导出路径不存在。原因尺寸全名跟界面语言有关模板路径写死在本机目录默认单位或文档单位不同输出目录没有写权限SolidWorks 默认模板位置不一样。解决尺寸名、模板路径、输出目录全部外置到参数表或配置文件脚本启动时打印当前语言相关设置和单位路径用os.path.join拼不手写反斜杠换机器先跑最小链路再跑批量。不要假设目标机器和你本机环境一样这个假设是二次开发里最贵的后悔药。6. 把脚本变成可交付工具日志、回滚与验收的硬指标脚本能跑通和能交付是两件事。能交付的标志是跑失败知道哪一行失败、改坏了能回到原样、换一组边界参数还能站住。参数化建模脚本尤其如此尺寸改错一个后面装配和工程图全跟着错。第 6 章落三个硬指标日志能追溯、回滚有后悔药、验收用边界参数说话。6.1 日志与失败清单让批处理可追溯日志不要只记“成功/失败”。至少记时间、配置名、尺寸名、旧值、新值、重建结果、导出路径、错误描述。旧值很重要回滚时不用翻原始文件。失败清单单独输出一份方便重跑时只跑失败行。字段用途时间定位批次和并发问题配置名知道哪组参数出错尺寸名知道哪个对象没取到旧值/新值回滚和对比重建结果区分赋值成功和几何成功导出路径检查文件是否真的生成错误描述给下一次排查留线索6.2 回滚与版本先复制再改保留原始配置批量脚本不要直接改原始模板。先复制一份到批次目录改副本输出到独立目录。原始模板保留只读配置不要覆盖。每次批次带一个版本号或日期目录失败时整个目录丢弃不影响上一版。尺寸旧值写进日志回滚时按日志反向赋值即可。这个习惯看起来慢但比“改坏了再手工找回”快得多。6.3 验收清单用一组边界参数验证验收不要只跑正常值。至少准备四组最小值、最大值、缺失尺寸、重复配置。最小值看会不会过定义最大值看会不会超出边界缺失尺寸看脚本是否停在明确报错重复配置看会不会覆盖输出。每组跑完检查模型能打开、工程图能重建、导出文件非空。从那以后我每次交付参数化脚本都强制先跑一遍最小链路和这组边界参数再谈批量。希望帮到你。本文还有配套的精品资源点击获取
简介SolidWorks二次开发参数化建模项目源码包面向具备C基础、希望借助SolidWorks API实现零件尺寸与结构自动驱动的高校学生和工程技术人员。包内以h头文件、cpp源文件为核心配套tlh类型库、dll/lib等编译与接口文件以及bmp界面位图和工程配置共95个文件、约4.33MB呈现了从界面交互到模型参数化生成的完整工程组织。已有624人学习下载可作为课程设计、毕业设计或企业插件原型的参考。读者可从中了解SolidWorks二次开发中部件文档访问、参数读写、对话框与属性页搭建、类型库引入及VC6工程编译的组织思路并借助现成工程快速定位函数封装与模块划分减少从零搭建环境的时间。同时可观察DLL注册、属性页与文档对象封装等细节为独立完成参数化插件开发提供可复用参考源码结构较完整适合对照调试和二次扩展但需具备一定的COM与C阅读能力。1. 从一张图改到一百张SolidWorks 二次开发与参数化建模到底解决什么问题一张零件图改一个孔距装配体里的配合开始报警工程图上的标注跟着跑位这种场景在 SolidWorks 二次开发和参数化建模落地时几乎躲不开。资源包要解决的不是“教你点菜单”而是把 API 连接、尺寸驱动、配置切换、装配重建、工程图导出串成一条可复现的链路让改参数这件事从手工动作变成可重复执行的脚本。它适合三类人经常做系列化零件、一天要改十几套尺寸的建模工程师手里有大量历史图纸、想做批量替换和导出的工艺人员以及已经会用 VBA 录宏、但脚本一换机器就翻车的二次开发新手。资源里的示例零件、参数表模板和脚本骨架价值在于把对象名、单位、重建顺序这些容易踩坑的细节固定下来。2. 拆开源码包看骨架COM 入口、对象链与参数化建模的数据流SolidWorks 二次开发绕不开 COM。无论外面包的是 C# 插件、VBA 宏还是 Python 批处理最终都要落到SldWorks.Application这个入口再沿ISldWorks - IModelDoc2 - IConfiguration - IFeature - IDimension的对象链往下取东西。资源包把这条链拆成三层不是为了好看而是为了让“连接失败”“打开失败”“尺寸取不到”“重建失败”这四类问题能分开排查。第 2 章先不急着写业务先把最小链路跑通后面参数化建模才有地基。2.1 先认 COM 入口为什么录制宏比翻文档更快新手最容易犯的错是拿着一张对象模型图硬背。SolidWorks 的 API 文档很全但对象名、方法签名、返回类型在不同版本里有差异光看文档很容易写出“语法对、运行空引用”的代码。我一般会让对方先做一件事在 SolidWorks 里手动改一个尺寸同时录制宏然后看宏里到底用了哪个对象、哪个方法、尺寸全名长什么样。宏录出来的代码不一定优雅但它能告诉你当前这台机器、当前这个界面语言下对象是怎么被拿到的。比如同一个草图尺寸中文界面可能叫D1草图1英文界面可能叫D1Sketch1。脚本里写死一个名字换一台机器就找不到。资源包里的示例脚本没有把尺寸名藏在代码深处而是放到参数表或配置项里就是为了让这种差异暴露在明面上。常见做法是先用宏录制拿到“尺寸全名”再把全名写进参数表脚本只负责读表、匹配、赋值。这样界面语言变了改表比重写代码便宜。选型上VBA 适合快速验证和单人小工具C# 适合做常驻插件和强类型封装Python 适合批处理和跟 Excel、数据库打交道。资源包没有强行统一一种语言而是把连接层和模型层用脚本示例讲清楚批处理层留出接口。下面这张表是实际落地时的取舍不是语言优劣排名。方式适合场景优点边界VBA 宏验证对象名、单人改图录制快、无需编译难维护、异常处理弱C# 插件团队工具、菜单按钮强类型、易做界面需要工程配置和部署Python 脚本批量读表、批量导出改起来快、生态多COM 调用要处理类型和释放2.2 资源包的三层骨架连接层、模型层、批处理层连接层只干一件事拿到ISldWorks设置可见性处理打开文档的返回值。模型层负责“打开哪个文档、激活哪个配置、改哪个尺寸、什么时候重建”。批处理层负责“从 Excel 读多少行、每行输出什么文件、失败了怎么记”。三层混在一起写脚本短的时候没事一旦要批量跑几百个配置日志里全是“失败”你根本不知道是连接断了、尺寸名错了还是导出路径没权限。资源包里的示例把路径、尺寸名、输出目录都提到外部参数里代码里只保留流程。这个做法看起来多了一步但它把“改参数”和“改代码”分开了。参数化建模的核心不是写多少行代码而是让尺寸、配置、输出命名变成可管理的数据。尺寸名、配置名、导出名这三样东西一旦进了表后面做版本对比、回滚、重跑都方便。2.3 最小可运行链路连接、打开、改尺寸、重建、保存先跑一个最小链路不要一上来就批量。下面这段 Python 用win32com.client连接 SolidWorks打开一个示例零件按尺寸全名改值重建并保存。代码里的路径、尺寸名、目标值都是示例替换成你手头的模板即可。import win32com.client SW_PATH rD:\demo\demo_part.SLDPRT DIM_NAME D1草图1 # 尺寸全名先用宏录制确认 NEW_VALUE_MM 42.5 sw win32com.client.Dispatch(SldWorks.Application) sw.Visible True model sw.OpenDoc(SW_PATH, 1) # 1 零件2 装配体3 工程图 if model is None: raise RuntimeError(打开失败先查路径、文件占用、SolidWorks 是否已正常启动) dim model.Parameter(DIM_NAME) if dim is None: raise RuntimeError(f找不到尺寸 {DIM_NAME}用宏录制或 FeatureManager 确认全名) dim.SystemValue NEW_VALUE_MM / 1000.0 # API 尺寸单位是米 ok model.EditRebuild3() if not ok: raise RuntimeError(重建失败查过定义、方程式循环、配置是否激活) model.Save3(1, 0, 0) # 静默保存不同版本参数类型报错时用录制宏核对签名 sw.CloseDoc(model.GetTitle())这段代码的逻辑是“连接 - 打开 - 取尺寸 - 赋值 - 重建 - 保存 - 关闭”。OpenDoc的第二个参数是文档类型零件传 1装配体传 2工程图传 3。Parameter拿到的对象是尺寸SystemValue的单位是米所以毫米要除以 1000。EditRebuild3返回布尔值失败时不要继续保存否则会把错误状态写进文件。Save3的第一个参数是保存选项示例用 1 表示静默保存如果当前版本提示参数类型不对不要猜直接用宏录制一次保存动作按录制出来的签名改。注意Parameter的尺寸全名跟界面语言、配置、特征名都有关。先在目标模板上录制宏确认全名再写进参数表。最小链路跑通的标准不是“没报错”而是打开文件后肉眼看到尺寸变了、重建后模型没报错、保存后重新打开值还在。三个条件缺一个后面批量跑得越快错得越多。3. 参数化建模落地从 Excel 参数表到尺寸、配置与批量导出参数化建模最容易写成“把尺寸写死在代码里”。这样做的后果是每来一个新型号就要改脚本改完还要重新测。资源包的做法是把驱动尺寸、配置名、导出名放进 Excel脚本只认表头。第 3 章把参数表设计、尺寸赋值、配置切换、批量导出这四件事拆开讲重点不是代码多高级而是参数边界在哪里、失败时看什么。3.1 参数表怎么设计驱动尺寸、从动尺寸、配置名、导出名参数表不要只放“尺寸名”和“值”两列。实际落地时至少要有配置名、尺寸全名、目标值、单位、导出名、导出类型、是否启用。配置名决定脚本激活哪个配置尺寸全名决定改哪个对象单位决定要不要换算导出名决定输出文件叫什么是否启用决定这一行要不要跑。多一列“备注”不是浪费后面排查“为什么这行没跑”时能救命。下面这张表是资源包里参数模板的字段设计列名可以改但含义不要省。字段含义示例注意config_name要激活的配置名配置A必须与模型内配置完全一致dim_name尺寸全名D1草图1中文/英文界面不同value_mm目标值毫米42.5脚本内除以 1000export_name输出文件名零件A.step不带路径路径由脚本拼export_type导出类型step/pdf/dxf大小写统一enabled是否执行1/0空值按不执行处理驱动尺寸和从动尺寸要分开。驱动尺寸是你能改的从动尺寸是方程式或关系算出来的。脚本只改驱动尺寸改从动尺寸要么被方程式覆盖要么直接报错。资源包的示例表里有一列“类型”不是为了分类好看而是提醒执行时跳过从动项。常见做法是先在模型里把关键尺寸重命名比如孔距_主、板厚再让参数表用这些可读名而不是全靠D1草图1这种系统名。3.2 用 API 改尺寸并重建代码与参数边界批量脚本不要每改一个尺寸就保存一次。正确顺序是打开模板循环配置激活配置改尺寸重建导出最后统一保存或关闭。下面这段代码读 Excel按行激活配置、改尺寸、按类型导出。示例只写 STEP 分支PDF 和 DXF 用同样的思路加分支。import os import openpyxl import win32com.client PARAM_XLSX rD:\demo\params.xlsx TEMPLATE rD:\demo\template_part.SLDPRT OUT_DIR rD:\demo\out os.makedirs(OUT_DIR, exist_okTrue) wb openpyxl.load_workbook(PARAM_XLSX, data_onlyTrue) ws wb[params] rows list(ws.iter_rows(min_row2, values_onlyTrue)) sw win32com.client.Dispatch(SldWorks.Application) sw.Visible False model sw.OpenDoc(TEMPLATE, 1) if model is None: raise RuntimeError(模板打开失败) for row in rows: config_name, dim_name, value_mm, export_name, export_type, enabled row[:6] if not enabled or not config_name or not dim_name: continue model.ShowConfiguration2(config_name) # 激活目标配置 dim model.Parameter(dim_name) if dim is None: raise RuntimeError(f{config_name} 下找不到 {dim_name}) dim.SystemValue float(value_mm) / 1000.0 if not model.EditRebuild3(): raise RuntimeError(f{config_name} 重建失败先停在这一行排查) out_path os.path.join(OUT_DIR, export_name) if str(export_type).lower() step: model.SaveAs3(out_path, 0, 2) # 0 覆盖2 静默签名用宏录制核对 else: raise RuntimeError(f未处理的导出类型{export_type}) model.Save3(1, 0, 0) sw.CloseDoc(model.GetTitle())逻辑上ShowConfiguration2先激活配置Parameter再按尺寸全名取对象。顺序反了可能取到默认配置的尺寸改完看起来成功实际改错了地方。EditRebuild3放在导出之前导出放在保存之前是为了让输出文件反映最新几何。参数上PARAM_XLSX、TEMPLATE、OUT_DIR都提到外部换项目只改这三处。value_mm转 float 再除以 1000空值或文本会在这一行直接报错比后面导出空文件好查。注意SaveAs3的参数在不同版本里可能要求不同签名不要照抄网上代码。录制一次“另存为 STEP”的宏按宏里的参数改。3.3 配置与方程式什么时候用配置什么时候用方程式配置适合“同一套拓扑、不同尺寸组合”的系列件。比如一块安装板孔距、板厚、边距有三组标准值用配置切换比复制三个文件好维护。方程式适合“尺寸之间有固定关系”的场景比如板厚变了筋厚按比例跟着变。两者的边界是配置管“选哪一组值”方程式管“值之间怎么算”。脚本改配置里的驱动尺寸时方程式会自动重算从动尺寸脚本如果去改从动尺寸要么被覆盖要么触发重建失败。资源包里的示例模型把驱动尺寸放在配置里把比例关系放在方程式中。批量跑之前先手动切一遍配置确认每个配置都能重建。常见翻车是配置里有一个尺寸被压缩了脚本一激活就报错但错误信息不会告诉你“这个配置本来就有问题”。所以参数表里加一列“预检通过”跑批量前先按配置做一次空跑只激活、只重建、不导出。3.4 批量导出STEP/PDF/DXF 的命名与失败重试批量导出不要用“零件名时间戳”这种不可预测的命名。参数表里的export_name要能一眼看出是哪个配置、哪组参数。输出目录按批次分别把几百个文件倒进同一个文件夹。失败重试不要无脑循环先区分“文件被占用”“路径不存在”“导出类型不支持”三类。文件被占用时重试有用路径不存在时重试一百次也没用。我一般会在导出前做三件事检查输出目录可写、检查同名文件是否只读、检查模型是否处于轻化或压缩状态。轻化模式在大装配里能提速但脚本改尺寸前要确保参考已加载否则会出现“尺寸改了、几何没变”的玄学现象。资源包里的批处理脚本没有默认开轻化就是为了让第一次跑的人先看到真实重建结果等链路稳定后再按装配规模决定要不要开。4. 装配体与工程图联动改一个孔距后谁先重建、谁后更新零件级参数化建模跑通后下一步一定是装配体和工程图。很多脚本在零件里改尺寸没问题一到装配体就出现配合报警一到工程图就出现标注跑位。根因通常不是 API 不会用而是重建顺序错了。第 4 章按“零件 - 装配体 - 工程图”的顺序讲联动重点讲骨架草图、配合参考、模型项和轻化模式的取舍。4.1 装配体配合的驱动逻辑骨架草图、布局、参考关系装配体参数化不要直接改零件上的配合面尺寸先看这个尺寸有没有被骨架草图或布局驱动。常见做法是在装配体里建一个骨架草图把关键孔距、总长、安装高度放在骨架里零件通过“转换实体引用”或“派生草图”引用骨架。这样脚本只改骨架尺寸零件和配合跟着更新。直接改零件尺寸也能跑但配合关系多的时候重建顺序很难控制。资源包里的示例装配体用了一个简化骨架零件上的两个安装孔通过骨架草图定位。脚本改骨架尺寸后先重建骨架所在零件再重建装配体。如果先重建装配体骨架还没更新配合会按旧几何算结果就是报警。这个顺序不是 SolidWorks 的硬性规定是实际跑批量时总结出来的血泪经验谁被谁引用谁就先重建。4.2 工程图标注跟随模型项、尺寸覆盖与重建顺序工程图能不能跟着更新取决于标注是不是“模型项”。从模型插入的尺寸模型改了它会跟着变手动标注或覆盖过的尺寸可能不会自动更新。脚本能做的是重建工程图但没法替你把手动覆盖的标注改回模型项。所以参数化建模要在建模阶段就把工程图模板定好该用模型项的用模型项该用从动尺寸的用从动尺寸别在工程图里手工改数值。重建顺序上零件保存后再打开工程图工程图重建前先确保参考模型已加载。工程图里如果用了轻化模式脚本重建前要解析轻化组件否则会出现“模型已改、图纸没动”的情况。资源包里的示例工程图没有开轻化批量导出 PDF 前先EditRebuild3再保存再导出。这个顺序看起来笨但稳定。4.3 批量替换与轻化模式大装配提速的取舍大装配批量跑轻化模式能明显缩短打开时间但脚本改尺寸、重建、导出这三步对轻化的容忍度不一样。打开可以轻化改尺寸前要确保目标零件已加载重建装配体时要解析轻化组件导出工程图时又要确保模型项已刷新。资源包没有把轻化开关写死而是留了一个配置项让使用的人按装配规模决定。常见做法是小装配直接全加载别为了省几秒引入不确定性大装配先轻化打开只对本次要改的零件做解析改完重建再保存。批量替换零件时不要一边替换一边重建先把替换清单跑完再统一重建。替换过程中每步都重建失败点会被放大日志也很难看懂。4.4 一个可复现的端到端脚本改参数、重建装配、导出图下面这段脚本把零件、装配体、工程图串起来。它先改零件尺寸并保存再打开装配体解析轻化组件、重建、保存最后打开工程图重建并导出 PDF。示例路径和尺寸名都要替换成你的模板。import win32com.client PART rD:\demo\demo_part.SLDPRT ASSEMBLY rD:\demo\demo_assy.SLDASM DRAWING rD:\demo\demo_drawing.SLDDRW DIM_NAME D1草图1 NEW_MM 50.0 sw win32com.client.Dispatch(SldWorks.Application) sw.Visible True part sw.OpenDoc(PART, 1) if part is None: raise RuntimeError(零件打开失败) dim part.Parameter(DIM_NAME) if dim is None: raise RuntimeError(f零件里找不到 {DIM_NAME}) dim.SystemValue NEW_MM / 1000.0 if not part.EditRebuild3(): raise RuntimeError(零件重建失败) part.Save3(1, 0, 0) assy sw.OpenDoc(ASSEMBLY, 2) if assy is None: raise RuntimeError(装配体打开失败) assy.ResolveAllLightWeightComponents(True) # 轻化组件先解析 if not assy.EditRebuild3(): raise RuntimeError(装配体重建失败查配合和参考) assy.Save3(1, 0, 0) drw sw.OpenDoc(DRAWING, 3) if drw is None: raise RuntimeError(工程图打开失败) if not drw.EditRebuild3(): raise RuntimeError(工程图重建失败查模型项和参考) drw.Save3(1, 0, 0) drw.SaveAs3(rD:\demo\out\demo_drawing.pdf, 0, 2) sw.CloseDoc(drw.GetTitle()) sw.CloseDoc(assy.GetTitle()) sw.CloseDoc(part.GetTitle())逻辑是“零件先改、装配再跟、工程图最后刷”。ResolveAllLightWeightComponents(True)放在装配体重建前是为了让轻化组件参与计算工程图没有加这一步因为示例工程图没开轻化如果你的模板开了按同样思路先解析再重建。参数上NEW_MM是毫米SystemValue前除以 1000SaveAs3的 PDF 路径要提前建好目录。失败时先看哪一步的RuntimeError先抛出来不要跳步重跑。顺序对象动作失败先看1零件改尺寸、重建、保存尺寸全名、过定义、方程式2装配体解析轻化、重建、保存配合参考、骨架是否更新3工程图重建、保存、导出模型项、参考路径、轻化5. 避坑与排查SolidWorks 二次开发最常见的五个翻车点SolidWorks 二次开发的报错信息经常很“黑匣子”同一个空引用可能是位宽问题也可能是文档没打开。避坑章不列大道理只记五类实际跑批量时最常遇到的翻车连上了却空引用、改完尺寸重建失败、批量导出卡死、工程图不更新、换机器就报错。每条按“现象 - 原因 - 解决”写方便对着日志查。5.1 连上了却空引用先查位宽、COM 注册和文档返回值现象脚本能启动 SolidWorksDispatch也没报错但一取model.Parameter就空引用或者OpenDoc返回None。原因常见有三种。脚本进程位数和 SolidWorks 不一致COM 调用能看到应用但拿不到文档对象SolidWorks 没有正常完成启动Dispatch拿到的是壳OpenDoc的路径或文档类型不对返回值本来就是空。还有一种隐蔽情况文件被另一个进程占用打开失败但不抛异常。解决先看OpenDoc返回值空就停不要往下走。确认脚本和 SolidWorks 位数一致路径用绝对路径文档类型别把装配体写成零件。文件被占用时先关闭占用程序或者复制一份到临时目录再打开。空引用不要靠加try吞掉吞掉之后日志里只剩“失败”没有原因。5.2 改完尺寸重建失败过定义、方程式循环、配置没激活现象SystemValue赋值成功EditRebuild3返回 False模型树上出现红色报错或者几何根本没变。原因尺寸改大了导致草图过定义方程式之间互相引用形成循环目标尺寸属于另一个配置当前配置没激活尺寸是从动尺寸被方程式覆盖。还有一种情况是尺寸名取到了但取到的是工程图里的从动尺寸赋值不生效。解决先在界面上手动改同一个尺寸看会不会报错排除模型本身的问题。脚本里在赋值前打印当前配置名确认ShowConfiguration2成功。从动尺寸不要改改它的上游驱动尺寸。重建失败时不要保存保存会把错误状态写进文件。批量跑之前每个配置做一次“只激活、只重建、不导出”的空跑。5.3 批量导出卡死或文件被占用事件没释放、Visible 设置不当现象跑几十行后脚本卡住SolidWorks 无响应或者导出目录里出现一堆 0 字节文件或者提示文件被占用。原因每轮都新建Dispatch但没有释放COM 对象越积越多Visible设成 True 但界面弹窗没人点导出路径不存在或同名文件只读SaveAs3失败后脚本继续跑下一行错误被淹没。解决整个批次只建一个Dispatch循环内复用批量时Visible设 False但失败排查时临时设 True 看弹窗导出前检查目录和只读属性每行导出后检查文件是否存在且大小大于 0。不要用无限重试掩盖路径错误路径错重试一百次还是错。5.4 工程图尺寸不更新、标注跑位模型项丢失和重建顺序错现象零件尺寸改了装配体也重建了工程图打开后尺寸还是旧值或者标注跑到视图外面。原因工程图里的标注不是模型项是手动标注或覆盖过的尺寸工程图参考的模型没保存先重建工程图再重建零件顺序反了工程图开了轻化参考模型没解析。解决建模阶段就把工程图模板定好关键尺寸用模型项插入少在工程图里手工改值。脚本顺序按“零件保存 - 装配保存 - 工程图重建”走。工程图开轻化时重建前先解析参考。标注跑位如果是视图比例或图纸格式导致脚本改不了要在模板里修。5.5 换机器就报错路径、模板、语言、单位四个变量现象同一份脚本在自己机器上跑得好好的换一台机器就找不到尺寸、打开失败、导出路径不存在。原因尺寸全名跟界面语言有关模板路径写死在本机目录默认单位或文档单位不同输出目录没有写权限SolidWorks 默认模板位置不一样。解决尺寸名、模板路径、输出目录全部外置到参数表或配置文件脚本启动时打印当前语言相关设置和单位路径用os.path.join拼不手写反斜杠换机器先跑最小链路再跑批量。不要假设目标机器和你本机环境一样这个假设是二次开发里最贵的后悔药。6. 把脚本变成可交付工具日志、回滚与验收的硬指标脚本能跑通和能交付是两件事。能交付的标志是跑失败知道哪一行失败、改坏了能回到原样、换一组边界参数还能站住。参数化建模脚本尤其如此尺寸改错一个后面装配和工程图全跟着错。第 6 章落三个硬指标日志能追溯、回滚有后悔药、验收用边界参数说话。6.1 日志与失败清单让批处理可追溯日志不要只记“成功/失败”。至少记时间、配置名、尺寸名、旧值、新值、重建结果、导出路径、错误描述。旧值很重要回滚时不用翻原始文件。失败清单单独输出一份方便重跑时只跑失败行。字段用途时间定位批次和并发问题配置名知道哪组参数出错尺寸名知道哪个对象没取到旧值/新值回滚和对比重建结果区分赋值成功和几何成功导出路径检查文件是否真的生成错误描述给下一次排查留线索6.2 回滚与版本先复制再改保留原始配置批量脚本不要直接改原始模板。先复制一份到批次目录改副本输出到独立目录。原始模板保留只读配置不要覆盖。每次批次带一个版本号或日期目录失败时整个目录丢弃不影响上一版。尺寸旧值写进日志回滚时按日志反向赋值即可。这个习惯看起来慢但比“改坏了再手工找回”快得多。6.3 验收清单用一组边界参数验证验收不要只跑正常值。至少准备四组最小值、最大值、缺失尺寸、重复配置。最小值看会不会过定义最大值看会不会超出边界缺失尺寸看脚本是否停在明确报错重复配置看会不会覆盖输出。每组跑完检查模型能打开、工程图能重建、导出文件非空。从那以后我每次交付参数化脚本都强制先跑一遍最小链路和这组边界参数再谈批量。希望帮到你。本文还有配套的精品资源点击获取
