简介以CATIA二次开发为核心的专题技术文档面向需要在VC 6.0环境中基于CAA组件应用架构扩展CATIA功能的工程师及学习者。文档首先梳理了CATIA二次开发的两种主要方式利用宏与Automation API的脚本化定制以及借助CAA-RADE进行的组件级开发并对比了进程内与进程外通信机制的差异。随后以实例重点讲解界面二次开发流程包括自行创建独立Workbench、添加自定义菜单与工具条、生成CATIA风格对话框、通过Command实现交互响应并直接以代码构建三维模型。最后基于五坐标数控机床运动仿真系统的开发展示了上述方法在具体工程项目中的落地路径。资源为1个doc格式的完整文档压缩包约205KB目前已有6405人浏览学习文档知识密度较高适合查阅关键步骤、借鉴程序框架和排查开发中的常见问题整体内容紧凑兼具方法论与范例价值。1. CATIA二次开发到底在做什么先想清楚你要哪一种开发我见过太多人一上来就搜“CATIA二次开发”然后被 CAA、RADE、VBA、知识工程这几个词绕晕。问清楚需求才知道有人只是想把重复的建圆柱、打孔操作自动化有人想给设计部门做个参数化模板还有人要在CATIA里跑一个需要几百次迭代的优化算法。这三类需求的开发路线完全不同投入成本从半天到半年不等。CATIA二次开发并不是一个单一的技术而是一套从宏录制到C原生API的分层体系。这篇文章按我的实操经验把选型、环境搭建、代码套路和坑一次讲透让你照着能做出来而不是停在收藏夹里。2. 选开发方式CAA、VBA、Java API 哪种适合你的场景2.1 三种主流方式的本质区别CATIA对外提供的开发接口分三层最外层是基于自动化对象Automation的VBA/VB Script中间是交互式宏录制最底层是CAAComponent Application Architecture的C API。另外还有一套Java API本质上是CAA的Java封装用得相对少。很多教程把“宏”和“二次开发”混为一谈这是第一个要纠正的认知。VBA方式工作在CATIA的进程内通过CATIA.Application这个顶层对象往下调模型、文档、参数对象。录制的宏就是VBA代码你可以在CATIA内置的Visual Basic编辑器中修改。它的优点是门槛极低不需要额外安装SDK缺点是很多底层几何操作没有暴露给Automation接口比如复杂的扫掠、曲面编辑、特征重排序经常做不了。CAA是真正的CATIA二次开发它用C访问CATIA的底层数据模型和命令交互机制。CATIA V5本身的很多功能就是用CAA架构写出来的所以理论上你能做的不限于建模还包括定制菜单、交互式命令、特征识别等。代价是开发环境搭建复杂需要安装专门的RADERapid Application Development Environment还需要特定版本的Visual Studio配合。我用过的组合是VS 2015对应CATIA V5-6R2017VS 2019对应V5-6R2021对不上版本连编译都会报一堆稀奇古怪的错误。Java API在CATIA V5后期版本里提供语法比CAA简单但能够访问的对象范围比CAA窄适合做数据提取和批处理做交互式命令很别扭。我的建议是如果你的周报里写的是“用CATIA画一些模型”VBA就够了如果写的是“开发CATIA功能模块”那只能选CAA。2.2 从维护成本和交付方式反推选型选型不能只看功能上限还要看交付后的维护成本。VBA脚本是文本文件.CATScript或.bas发给同事直接导入就能用改起来也方便。CAA程序需要编译成DLL然后通过环境管理器把注册好的命令加载进CATIA。DLL必须跟CATIA版本和Visual Studio运行时严格匹配CATIA打个小补丁都可能让DLL加载失败。我之前帮一个供应商做过轮胎模具参数化模块最初用CAA开发功能做得很完整结果对方换了台CATIA V5R21的电脑DLL加载不进去光排查加载过程就花了两天最后还是我远程改成VBA版本输出模型参数再重画才算解决问题。类似的教训让我形成了一个判断原则优先VBAVBA做不到的才考虑CAA。还有一个容易被忽略的选项是知识工程Knowledge Engineering配合设计表。如果需求是“改变几个数字重新生成模型”用PowerCopy、UDF或者Design Table有时候不写代码也能完成而且稳定性比任何宏都好。CATIA二次开发走到后面你会发现真正值钱的是用最少的代码让CATIA原生机制干活而不是把CATIA当成一个需要你用代码全程指挥的工具。2.3 快速判断你的需求属于哪一类我习惯用一个二维表来归类需求。维度一是操作对象是零件设计、装配设计还是工程图维度二是交互类型是“后台静默执行”还是“用户交互式操作”。如果是后台批量改参数、导出图纸、提取BOMVBA足够甚至很多不用Automation直接用CAA的Batch模式。如果要做类似于“用户点一个按钮弹出对话框在3D模型上动态选择面然后自动建孔”这样的交互CAA是正路VBA的交互能力非常弱。举个例子有次项目需要在CATIA里根据Excel表格里的坐标批量创建基准点。这个需求VBA完全能处理读Excel、循环调用Point对象创建、保存整个过程不需要用户点选任何几何。但后来需求升级成“在装配里让用户手动选择安装面然后自动布置一周螺栓”VBA就力不从心了因为选择过滤器、高亮预览这些交互机制只有CAA的Command框架才完整提供。所以在你安装任何开发工具之前先写清楚这三件事输入什么、输出什么、用户需要参与多少。这决定了你接下来是打开宏录制还是去配置RADE环境。3. 环境搭建与第一个能跑的宏VBA 入门最快3.1 开启CATIA宏录制与VB编辑器先把最基础的环境弄好。CATIA V5的任何版本V5R20、V5R21、V5-6R2022都适用自带VBA开发环境不需要额外安装。打开“工具”“宏”“录制”开始录制后手动在模型树里创建一个圆柱停止录制并保存为CATScript文件。这时候打开“工具”“宏”“宏库”把自己录制的CATScript导入再点“编辑”就能看到宏的源码。很多新手以为这叫二次开发其实只是“签名”你要做的是把这些代码改造成真正可复用的东西。录制代码最大的问题是充满了用户界面层的方法调用比如InputBox、Selection.SelectElement这类交互方法在无人值守的批处理脚本里会卡住。我一般只把录制代码当作对象名称和属性路径的参考不会直接拿来用。写宏不需要额外安装任何包CATIA自带的“Visual Basic”选项卡里就能新建模块。这里注意一个细节宏库类型要选“VBA项目”不要选“宏库”后者存的是CATScript脚本延迟绑定调试不方便。选VBA项目后你可以在编辑器中直接指定引用CATIA的Automation类型库得到自动补全和对象浏览器。3.2 第一个参数化建模宏创建圆柱打开VB编辑器后新建一个模块粘贴下面这段代码。在宏库里选中它并运行就会在新建的Part中生成一个参数化的圆柱。Sub CreateCylinder() Dim oApp As CATIA.Application Set oApp GetObject(, CATIA.Application) Dim oDocs As Documents Set oDocs oApp.Documents Dim oDoc As Document Set oDoc oDocs.Add(Part) Dim oPart As Part Set oPart oDoc.Part Dim oBodies As Bodies Set oBodies oPart.Bodies Dim oBody As Body Set oBody oBodies.Item(1) 创建草图并定义圆 Dim oSketchs As Sketches Set oSketchs oBody.Sketches Dim oOrigin As HybridShapePointCenter Dim oPlane As Reference Set oPlane oPart.CreateReferenceFromObject(oPart.OriginElements.PlaneXY) Dim oSketch As Sketch Set oSketch oSketchs.Add(oPlane) Dim oFactory2D As Factory2D Set oFactory2D oSketch.OpenEdition Dim oCircle2D As Circle2D Set oCircle2D oFactory2D.CreateClosedCircle(0#, 0#, 10#) oSketch.CloseEdition 创建拉伸 Pad Dim oPad As Pad Set oPad oBodies.Item(1).Shapes.AddPad(oSketch, 20#) oPart.Update End Sub这段代码的逻辑很直白拿到顶层CATIA.Application后新建一个Part文档然后在模型树的第一个Body里新建一个草图在草图画圆再用这个圆做拉伸。CreateClosedCircle的参数是圆心x、圆心y、半径我这里写的是半径10毫米的圆。AddPad的第二个参数是拉伸高度20毫米单位都是毫米。这里最容易踩的坑是GetObject(, CATIA.Application)这行。如果CATIA还没启动这个调用会报错“没有注册类”。稳妥的做法是先判断进程或者干脆提前手动打开CATIA再运行宏。批处理脚本里可以先CreateObject(CATIA.Application)启动它但这样拿到的对象可能没有完全初始化后续调用Part文档有时候会闪退。我的习惯是开发调试时手动开CATIA生产脚本里启动后加Wait和Update。3.3 宏里的对象模型怎么读从录制代码到手写代码VBA代码里出现的Part、Body、Sketch、Pad这些名字对应的是CATIA对象模型树。对象模型的根是Application下面有Documents每个Document里有Part或者Product。Part下面最核心的是Bodies集合每个Body包含Sketches和Shapes。新建一个Pad要用Shapes.AddPad而新建一个Pocket挖槽用的是Shapes.AddPocketAPI命名几乎是操作名称的直译。录制代码通常会写成Set oSketch oPart.Sketches.Add(...)之类的简略形式缺少中间类型声明。手写代码时最好把每一级都声明成明确类型比如Dim oSketch As Sketch这样编辑器的自动补全才有效。另一个技巧是打开“工具”“宏”“Visual Basic编辑器”后在菜单“视图”“对象浏览器”里找到CATIA类型库逐个查方法的参数。用熟了你会发现CATIA的Automation接口非常稳定V5R20到V5-6R2022的多数对象和属性都能通用。写宏有一个原则不要把交互录制的代码原封不动搬出来。录制代码里大量出现Selection、MainWindow这些对象只在用户界面存在。你手动创建草图之前先执行一遍录制代码再对比我上面贴的最小代码就能看到差异。真正的参数化宏应该是读参数、创建引用、更新模型不要依赖任何选择状态。4. CAA 二次开发从安装 RADE 到编译第一个程序4.1 CAA 的定位真正贴近CATIA内核的开发CAA是CATIA二次开发里投入最大也最能拉开差距的路线。它不是一套函数库而是一套完整的组件框架CATIA自带的很多命令本身就是用CAA写的所以你用CAA做的功能启动后看起来就跟原生命令一样有图标、有对话框、有上下文菜单。这是VBA做不到的效果。CAA开发需要安装RADE模块它是随CATIA安装介质一起提供的不是单独下载的插件。常见安装方式是在CATIA安装界面里勾选“CAA”相关组件或者从安装路径下的\B20\CAA\目录里找执行文件。我用过V5R21的RADE它要求Visual Studio 2010而V5-6R2022的RADE要求VS 2019。安装完成后会多一个“CATIA V5 CAA API”的文档入口这是你以后查函数用的唯一权威来源。启动CAA开发环境的方式不是双击某个exe而是修改环境文件。在CATIA安装目录下找到\Env\CATIA.PReset之类的文件在里面加入IFNODE、CSSetting这些配置然后用命令行调用Scripts\StartCAD.bat启动一个带开发环境的进程。有些教程让你直接改系统环境变量效果一样但改错了会导致CATIA起不来建议先备份原环境文件。4.2 环境变量、Workspace 和 Framework 的关系CAA代码碎得让人崩溃因为你写的不是一个完整的程序而是一堆模块Module这些模块放在Framework里Framework又属于一个Workspace。编译时你需要指定用的是哪个CATIA版本、哪个Workspace里的哪个Framework。这种结构的好处是代码可以跨项目复用坏处是新手经常找不到自己编译出来的东西去哪了。我一般是这样规划目录的创建一个C:\CAAWorkspace下面建一个MyFramework里面放ImportedInterfaces和NewImplementation两个目录。前者声明这个Framework用了哪些CATIA组件后者放我们自己的C类。然后在RADE的“Tools”“Install Command”里配置C:\CAAWorkspace为当前Workspace再配置CATIA的安装路径。编译时用mk /f MyFramework.mk命令不要直接在Visual Studio里点编译。mk是Dassault的构建工具它知道怎么处理CATIA特有的mkmk和idl文件。第一次编译时系统会让你回答几个问题比如是否生成CNext目录、是否使用共享库模式全部选默认。构建成功后可执行文件会出现在Run\NT_x86\code\bin下这个路径里的exe才是你将来要和CATIA一起启动的入口。4.3 编译并运行一个最小命令这里给一个能在CATIA工具菜单里注册出“Hello”命令的最小C实现。先新建一个Module叫BasicCmd在实现文件BasicCmd.cpp里写下面的代码#include CATCommand.h #include CATIndomable.h #include CATApplicationFrame.h #include CATFrmEditor.h class BasicCmd : public CATCommand { public: BasicCmd(); virtual ~BasicCmd(); virtual void Activate(CATCommand cmd, CATNotification evt); }; BasicCmd::BasicCmd(): CATCommand(NULL, (CATCommand*)NULL) { CATFrmEditor* pEditor CATFrmEditor::GetCurrentEditor(); if (pEditor ! NULL) SetEditor(pEditor); } void BasicCmd::Activate(CATCommand cmd, CATNotification evt) { MessageBox(NULL, LHello from CAA, LCATIA CAA, MB_OK); }在这个Module的同级还需要一个BasicCmd.m文件声明这个Module的源文件列表和依赖的CAA框架。写完框架后用mk编译然后需要写一个.CATRsc资源文件或者通过“环境编辑器”将命令加入Tools菜单。最常见的做法是用CATCommandHeader宏和AddMenuItem注册过程比较长我建议最开始先不要直接注册菜单而是用CATIA的开发模式下自带的命令执行器在CATIA里按CtrlShiftM? 不同版本位置不同一般是在“工具”“宏”里的“CAA交互式命令调试”手动输入命令的类名来触发。这样能最快验证你的DLL和框架有没有被正确加载。5. CATIA二次开发避坑与常见问题排查5.1 录制的宏在同事电脑上跑不起来现象你在自己电脑上录制并保存的宏发给同事后一运行就在GetObject(, CATIA.Application)或Documents.Add(Part)报错。原因最常见的是CATIA版本不一致。V5R20录制的宏里如果用了某个只在V5R21之后出现的对象旧版本自然不识别。其次是宏库类型如果你存的是VBA项目宏同事导入时如果没有勾选VBA兼容模式宏里的类型声明会变成未知对象。解决先确认双方CATIA主版本和Build号一致至少在同一个SP补丁级别。然后导出宏时用.CATScript格式而不是.bas.CATScript是纯文本任何版本都能导入。在宏代码里的关键对象调用前后加上On Error Resume Next机制和日志输出至少能定位到是创建对象失败还是访问属性失败。5.2 尺寸参数更新失效同名特征与命名规范现象通过VBA修改一个圆柱的高度后重新Update模型没有变化或者弹出一个“约束不一致”的警告。原因CATIA内部通过特征名和参数名来标识对象。你的宏里如果用body.Shapes.Item(Pad.2)这种硬编码名称一旦用户手动改了特征名称或删除了之前某个特征Item索引就失效了。更隐蔽的是参数失效比如你用Parameters.Item(PartBody\Pad.1\FirstLimit)设置长度这个字符串路径里的斜杠和中文名称在不同语言版本的CATIA里不一致。解决不要用显示名称而是在创建对象时就留好变量引用。比如Set oPad oBodies.Item(1).Shapes.AddPad(...)之后直接用oPad设置参数而不是重新查找。确实需要从模型树定位时用CreatesFrom或从Reference对象反查路径不要自己拼字符串。我在团队里强制规定凡是被脚本控制的特征命名一律用前缀AUT_加序号避免用户手动重命名。5.3 自动化脚本卡在“正在保存”对话框现象脚本运行到Document.SaveAs时弹出“是否保存确定覆盖原文件”的对话框程序就停在那里等人工点击无人值守时整个批处理挂死。原因CATIA的SaveAs操作默认会确认覆盖。Automation接口虽然有个OverWriteMode属性但很多版本里需要配合Document.ClearTemporaryOut之类的方法才能稳定抑制对话框。解决保存前先执行一行设置oDoc.ReadOnly False oDoc.SaveAs C:\Output\1.CATPart, TrueSaveAs的第二个参数在VBA接口里要求传True表示覆盖。如果还不行就把所有对话框相关的系统设置属性临时关掉例如在宏开始时设置CATIA.SystemConfiguration或使用Tools的BatchMode。最稳妥的方案是用CAA的CATDocumentServices::SaveAs方法它可以完全绕过交互式确认。5.4 CATIA版本差异导致API行为不一致现象同一段宏在V5R21上正常在V5-6R2022上创建出的草图方向反了或者AddPad的参数类型变了。原因CATIA的Automation接口对某些几何操作在底层行为上有细微调整。比如Factory2D.CreateClosedCircle在少数版本里默认的法线方向和草图坐标系有关如果边界几何相同但参考平面选的是Z-X平面拉伸方向就不同。解决开发时建立“版本对照表”把同一个功能在主力版本上跑一遍的结果截图存档。交付时明确标注支持的最低CATIA版本。我吃过一次亏用V5R21环境开发的批量打孔宏拿到V5-6R2022上孔的位置全部偏移了0.5毫米排查到最后是隐藏的Sketches.Add时选用的坐标系定义方式变了。后来我在创建草图和拉伸之前一律显式指定参考平面和方向不用默认值。5.5 授权与开发效率开发机要独立配置现象在装着完整CATIA授权、跑着大型装配设计的同事电脑上进行二次开发调试每隔几分钟CATIA就假死一次编译好的DLL偶尔加载不进去。原因CATIA启动时会对所有安装的扩展模块进行初始化。如果开发机上安装了大量建模、仿真、加工模块启动时间和内存占用会拖垮调试同时CAA编译环境需要的环境变量和常规CATIA启动脚本冲突时DLL会加载失败。解决准备一台独立的开发机只装CATIA基础模块和你需要的RADE。启动开发模式时使用单独的“环境”配置文件不要和生产环境混用。调试CAA时用命令行启动带开发环境变量的CATIA确认CATEnv和CNext环境变量路径正确。VBA调试则相反希望在完整环境里测因为VBA很依赖当前加载的文档类型和上下文。6. 进阶把宏封装成批处理工具的三个实用技巧6.1 使用参数输入表驱动批量处理把宏里的所有常量定义改成从Excel或TXT读取这是从“能跑”到“能用”的关键一步。你可以用一个Scripting.FileSystemObject读取UTF-8格式的配置表每一列对应一个模型参数每一行生成一个模型。Dim fso As Object Set fso CreateObject(Scripting.FileSystemObject) Dim ts As Object Set ts fso.OpenTextFile(C:\config\intput.txt, 1, False, -1) Do While ts.AtEndOfStream True Dim line As String line ts.ReadLine Dim parts() As String parts Split(line, ,) Call CreateCylinderByParams(CDbl(parts(0)), CDbl(parts(1))) Loop ts.Close这段代码故意用CreateObject(Scripting.FileSystemObject)而不在工程里引用是为了减少对具体CATIA版本编译环境的依赖。参数从文本读入后模型的创建逻辑全部放到CreateCylinderByParams子程序里这样批处理和交互式运行共用一套建模代码。6.2 异常捕获与日志让脚本能过夜跑批处理脚本最怕中途弹对话框或者报错后直接退出。你需要给每个模型的处理过程加上独立的日志和错误跟踪。我习惯在每个Sub开头写一句LogInfo Starting: modelName在Err处理分支里把错误号和描述写进日志文件。On Error GoTo ErrorHandler LogInfo Create part start ... 建模代码 ... LogInfo Create part success Exit Sub ErrorHandler: LogInfo Error: Err.Number Err.Description Resume Next注意Resume Next放在错误分支里是为了让脚本继续处理下一个模型而不是再次执行失败那步。如果真的需要重试可以把Resume改成跳到Retry标签。日志文件用追加模式打开别用覆盖模式不然跑到一半系统重启会丢失之前的所有记录。6.3 与外部系统交互读取Excel配置并生成三维模型最后这个技巧是给已经能熟练写VBA的人。用ADO方式读取Excel文件比FileSystemObject读文本的更稳定因为Excel里的类型和列名可以被你的模型直接利用。Dim conn As Object Set conn CreateObject(ADODB.Connection) conn.Open ProviderMicrosoft.ACE.OLEDB.12.0;Data SourceC:\config\model.xlsx;Extended PropertiesExcel 12.0;HDRYES;; Dim rs As Object Set rs conn.Execute(SELECT Name, Diameter, Height FROM Sheet1 WHERE EnabledYes) Do While Not rs.EOF Call CreateCylinderWithName(CStr(rs(Name)), CDbl(rs(Diameter)), CDbl(rs(Height))) rs.MoveNext Loop用ADO读取Excel的好处是没打开Excel也能读而且支持SQL筛选尤其适合从几百行参数里挑出需要生成的模型。注意的是微软的ACE OLEDB驱动在64位CATIA下需要安装对应的64位运行库否则会报“未找到提供程序”。我有一台机器就是32位Office和64位CATIA并存折腾半天才搞明白是驱动的位数问题。我现在的习惯是能用参数表驱动就用参数表能写日志就写日志能用变量引用特征就不用字符串查找。CATIA二次开发到后期拼的不是生成模型的能力而是让脚本在任何环境、任何版本、任何用户乱操作下都还能跑出稳定结果的能力。这些坑大多没有写进官方教程都是一个个晚上加班试出来的。希望这篇笔记里的路线和避坑经验能帮你少走一段弯路。本文还有配套的精品资源点击获取 CATIA二次开发实战：VBA与CAA选型、环境搭建与避坑指南
简介以CATIA二次开发为核心的专题技术文档面向需要在VC 6.0环境中基于CAA组件应用架构扩展CATIA功能的工程师及学习者。文档首先梳理了CATIA二次开发的两种主要方式利用宏与Automation API的脚本化定制以及借助CAA-RADE进行的组件级开发并对比了进程内与进程外通信机制的差异。随后以实例重点讲解界面二次开发流程包括自行创建独立Workbench、添加自定义菜单与工具条、生成CATIA风格对话框、通过Command实现交互响应并直接以代码构建三维模型。最后基于五坐标数控机床运动仿真系统的开发展示了上述方法在具体工程项目中的落地路径。资源为1个doc格式的完整文档压缩包约205KB目前已有6405人浏览学习文档知识密度较高适合查阅关键步骤、借鉴程序框架和排查开发中的常见问题整体内容紧凑兼具方法论与范例价值。1. CATIA二次开发到底在做什么先想清楚你要哪一种开发我见过太多人一上来就搜“CATIA二次开发”然后被 CAA、RADE、VBA、知识工程这几个词绕晕。问清楚需求才知道有人只是想把重复的建圆柱、打孔操作自动化有人想给设计部门做个参数化模板还有人要在CATIA里跑一个需要几百次迭代的优化算法。这三类需求的开发路线完全不同投入成本从半天到半年不等。CATIA二次开发并不是一个单一的技术而是一套从宏录制到C原生API的分层体系。这篇文章按我的实操经验把选型、环境搭建、代码套路和坑一次讲透让你照着能做出来而不是停在收藏夹里。2. 选开发方式CAA、VBA、Java API 哪种适合你的场景2.1 三种主流方式的本质区别CATIA对外提供的开发接口分三层最外层是基于自动化对象Automation的VBA/VB Script中间是交互式宏录制最底层是CAAComponent Application Architecture的C API。另外还有一套Java API本质上是CAA的Java封装用得相对少。很多教程把“宏”和“二次开发”混为一谈这是第一个要纠正的认知。VBA方式工作在CATIA的进程内通过CATIA.Application这个顶层对象往下调模型、文档、参数对象。录制的宏就是VBA代码你可以在CATIA内置的Visual Basic编辑器中修改。它的优点是门槛极低不需要额外安装SDK缺点是很多底层几何操作没有暴露给Automation接口比如复杂的扫掠、曲面编辑、特征重排序经常做不了。CAA是真正的CATIA二次开发它用C访问CATIA的底层数据模型和命令交互机制。CATIA V5本身的很多功能就是用CAA架构写出来的所以理论上你能做的不限于建模还包括定制菜单、交互式命令、特征识别等。代价是开发环境搭建复杂需要安装专门的RADERapid Application Development Environment还需要特定版本的Visual Studio配合。我用过的组合是VS 2015对应CATIA V5-6R2017VS 2019对应V5-6R2021对不上版本连编译都会报一堆稀奇古怪的错误。Java API在CATIA V5后期版本里提供语法比CAA简单但能够访问的对象范围比CAA窄适合做数据提取和批处理做交互式命令很别扭。我的建议是如果你的周报里写的是“用CATIA画一些模型”VBA就够了如果写的是“开发CATIA功能模块”那只能选CAA。2.2 从维护成本和交付方式反推选型选型不能只看功能上限还要看交付后的维护成本。VBA脚本是文本文件.CATScript或.bas发给同事直接导入就能用改起来也方便。CAA程序需要编译成DLL然后通过环境管理器把注册好的命令加载进CATIA。DLL必须跟CATIA版本和Visual Studio运行时严格匹配CATIA打个小补丁都可能让DLL加载失败。我之前帮一个供应商做过轮胎模具参数化模块最初用CAA开发功能做得很完整结果对方换了台CATIA V5R21的电脑DLL加载不进去光排查加载过程就花了两天最后还是我远程改成VBA版本输出模型参数再重画才算解决问题。类似的教训让我形成了一个判断原则优先VBAVBA做不到的才考虑CAA。还有一个容易被忽略的选项是知识工程Knowledge Engineering配合设计表。如果需求是“改变几个数字重新生成模型”用PowerCopy、UDF或者Design Table有时候不写代码也能完成而且稳定性比任何宏都好。CATIA二次开发走到后面你会发现真正值钱的是用最少的代码让CATIA原生机制干活而不是把CATIA当成一个需要你用代码全程指挥的工具。2.3 快速判断你的需求属于哪一类我习惯用一个二维表来归类需求。维度一是操作对象是零件设计、装配设计还是工程图维度二是交互类型是“后台静默执行”还是“用户交互式操作”。如果是后台批量改参数、导出图纸、提取BOMVBA足够甚至很多不用Automation直接用CAA的Batch模式。如果要做类似于“用户点一个按钮弹出对话框在3D模型上动态选择面然后自动建孔”这样的交互CAA是正路VBA的交互能力非常弱。举个例子有次项目需要在CATIA里根据Excel表格里的坐标批量创建基准点。这个需求VBA完全能处理读Excel、循环调用Point对象创建、保存整个过程不需要用户点选任何几何。但后来需求升级成“在装配里让用户手动选择安装面然后自动布置一周螺栓”VBA就力不从心了因为选择过滤器、高亮预览这些交互机制只有CAA的Command框架才完整提供。所以在你安装任何开发工具之前先写清楚这三件事输入什么、输出什么、用户需要参与多少。这决定了你接下来是打开宏录制还是去配置RADE环境。3. 环境搭建与第一个能跑的宏VBA 入门最快3.1 开启CATIA宏录制与VB编辑器先把最基础的环境弄好。CATIA V5的任何版本V5R20、V5R21、V5-6R2022都适用自带VBA开发环境不需要额外安装。打开“工具”“宏”“录制”开始录制后手动在模型树里创建一个圆柱停止录制并保存为CATScript文件。这时候打开“工具”“宏”“宏库”把自己录制的CATScript导入再点“编辑”就能看到宏的源码。很多新手以为这叫二次开发其实只是“签名”你要做的是把这些代码改造成真正可复用的东西。录制代码最大的问题是充满了用户界面层的方法调用比如InputBox、Selection.SelectElement这类交互方法在无人值守的批处理脚本里会卡住。我一般只把录制代码当作对象名称和属性路径的参考不会直接拿来用。写宏不需要额外安装任何包CATIA自带的“Visual Basic”选项卡里就能新建模块。这里注意一个细节宏库类型要选“VBA项目”不要选“宏库”后者存的是CATScript脚本延迟绑定调试不方便。选VBA项目后你可以在编辑器中直接指定引用CATIA的Automation类型库得到自动补全和对象浏览器。3.2 第一个参数化建模宏创建圆柱打开VB编辑器后新建一个模块粘贴下面这段代码。在宏库里选中它并运行就会在新建的Part中生成一个参数化的圆柱。Sub CreateCylinder() Dim oApp As CATIA.Application Set oApp GetObject(, CATIA.Application) Dim oDocs As Documents Set oDocs oApp.Documents Dim oDoc As Document Set oDoc oDocs.Add(Part) Dim oPart As Part Set oPart oDoc.Part Dim oBodies As Bodies Set oBodies oPart.Bodies Dim oBody As Body Set oBody oBodies.Item(1) 创建草图并定义圆 Dim oSketchs As Sketches Set oSketchs oBody.Sketches Dim oOrigin As HybridShapePointCenter Dim oPlane As Reference Set oPlane oPart.CreateReferenceFromObject(oPart.OriginElements.PlaneXY) Dim oSketch As Sketch Set oSketch oSketchs.Add(oPlane) Dim oFactory2D As Factory2D Set oFactory2D oSketch.OpenEdition Dim oCircle2D As Circle2D Set oCircle2D oFactory2D.CreateClosedCircle(0#, 0#, 10#) oSketch.CloseEdition 创建拉伸 Pad Dim oPad As Pad Set oPad oBodies.Item(1).Shapes.AddPad(oSketch, 20#) oPart.Update End Sub这段代码的逻辑很直白拿到顶层CATIA.Application后新建一个Part文档然后在模型树的第一个Body里新建一个草图在草图画圆再用这个圆做拉伸。CreateClosedCircle的参数是圆心x、圆心y、半径我这里写的是半径10毫米的圆。AddPad的第二个参数是拉伸高度20毫米单位都是毫米。这里最容易踩的坑是GetObject(, CATIA.Application)这行。如果CATIA还没启动这个调用会报错“没有注册类”。稳妥的做法是先判断进程或者干脆提前手动打开CATIA再运行宏。批处理脚本里可以先CreateObject(CATIA.Application)启动它但这样拿到的对象可能没有完全初始化后续调用Part文档有时候会闪退。我的习惯是开发调试时手动开CATIA生产脚本里启动后加Wait和Update。3.3 宏里的对象模型怎么读从录制代码到手写代码VBA代码里出现的Part、Body、Sketch、Pad这些名字对应的是CATIA对象模型树。对象模型的根是Application下面有Documents每个Document里有Part或者Product。Part下面最核心的是Bodies集合每个Body包含Sketches和Shapes。新建一个Pad要用Shapes.AddPad而新建一个Pocket挖槽用的是Shapes.AddPocketAPI命名几乎是操作名称的直译。录制代码通常会写成Set oSketch oPart.Sketches.Add(...)之类的简略形式缺少中间类型声明。手写代码时最好把每一级都声明成明确类型比如Dim oSketch As Sketch这样编辑器的自动补全才有效。另一个技巧是打开“工具”“宏”“Visual Basic编辑器”后在菜单“视图”“对象浏览器”里找到CATIA类型库逐个查方法的参数。用熟了你会发现CATIA的Automation接口非常稳定V5R20到V5-6R2022的多数对象和属性都能通用。写宏有一个原则不要把交互录制的代码原封不动搬出来。录制代码里大量出现Selection、MainWindow这些对象只在用户界面存在。你手动创建草图之前先执行一遍录制代码再对比我上面贴的最小代码就能看到差异。真正的参数化宏应该是读参数、创建引用、更新模型不要依赖任何选择状态。4. CAA 二次开发从安装 RADE 到编译第一个程序4.1 CAA 的定位真正贴近CATIA内核的开发CAA是CATIA二次开发里投入最大也最能拉开差距的路线。它不是一套函数库而是一套完整的组件框架CATIA自带的很多命令本身就是用CAA写的所以你用CAA做的功能启动后看起来就跟原生命令一样有图标、有对话框、有上下文菜单。这是VBA做不到的效果。CAA开发需要安装RADE模块它是随CATIA安装介质一起提供的不是单独下载的插件。常见安装方式是在CATIA安装界面里勾选“CAA”相关组件或者从安装路径下的\B20\CAA\目录里找执行文件。我用过V5R21的RADE它要求Visual Studio 2010而V5-6R2022的RADE要求VS 2019。安装完成后会多一个“CATIA V5 CAA API”的文档入口这是你以后查函数用的唯一权威来源。启动CAA开发环境的方式不是双击某个exe而是修改环境文件。在CATIA安装目录下找到\Env\CATIA.PReset之类的文件在里面加入IFNODE、CSSetting这些配置然后用命令行调用Scripts\StartCAD.bat启动一个带开发环境的进程。有些教程让你直接改系统环境变量效果一样但改错了会导致CATIA起不来建议先备份原环境文件。4.2 环境变量、Workspace 和 Framework 的关系CAA代码碎得让人崩溃因为你写的不是一个完整的程序而是一堆模块Module这些模块放在Framework里Framework又属于一个Workspace。编译时你需要指定用的是哪个CATIA版本、哪个Workspace里的哪个Framework。这种结构的好处是代码可以跨项目复用坏处是新手经常找不到自己编译出来的东西去哪了。我一般是这样规划目录的创建一个C:\CAAWorkspace下面建一个MyFramework里面放ImportedInterfaces和NewImplementation两个目录。前者声明这个Framework用了哪些CATIA组件后者放我们自己的C类。然后在RADE的“Tools”“Install Command”里配置C:\CAAWorkspace为当前Workspace再配置CATIA的安装路径。编译时用mk /f MyFramework.mk命令不要直接在Visual Studio里点编译。mk是Dassault的构建工具它知道怎么处理CATIA特有的mkmk和idl文件。第一次编译时系统会让你回答几个问题比如是否生成CNext目录、是否使用共享库模式全部选默认。构建成功后可执行文件会出现在Run\NT_x86\code\bin下这个路径里的exe才是你将来要和CATIA一起启动的入口。4.3 编译并运行一个最小命令这里给一个能在CATIA工具菜单里注册出“Hello”命令的最小C实现。先新建一个Module叫BasicCmd在实现文件BasicCmd.cpp里写下面的代码#include CATCommand.h #include CATIndomable.h #include CATApplicationFrame.h #include CATFrmEditor.h class BasicCmd : public CATCommand { public: BasicCmd(); virtual ~BasicCmd(); virtual void Activate(CATCommand cmd, CATNotification evt); }; BasicCmd::BasicCmd(): CATCommand(NULL, (CATCommand*)NULL) { CATFrmEditor* pEditor CATFrmEditor::GetCurrentEditor(); if (pEditor ! NULL) SetEditor(pEditor); } void BasicCmd::Activate(CATCommand cmd, CATNotification evt) { MessageBox(NULL, LHello from CAA, LCATIA CAA, MB_OK); }在这个Module的同级还需要一个BasicCmd.m文件声明这个Module的源文件列表和依赖的CAA框架。写完框架后用mk编译然后需要写一个.CATRsc资源文件或者通过“环境编辑器”将命令加入Tools菜单。最常见的做法是用CATCommandHeader宏和AddMenuItem注册过程比较长我建议最开始先不要直接注册菜单而是用CATIA的开发模式下自带的命令执行器在CATIA里按CtrlShiftM? 不同版本位置不同一般是在“工具”“宏”里的“CAA交互式命令调试”手动输入命令的类名来触发。这样能最快验证你的DLL和框架有没有被正确加载。5. CATIA二次开发避坑与常见问题排查5.1 录制的宏在同事电脑上跑不起来现象你在自己电脑上录制并保存的宏发给同事后一运行就在GetObject(, CATIA.Application)或Documents.Add(Part)报错。原因最常见的是CATIA版本不一致。V5R20录制的宏里如果用了某个只在V5R21之后出现的对象旧版本自然不识别。其次是宏库类型如果你存的是VBA项目宏同事导入时如果没有勾选VBA兼容模式宏里的类型声明会变成未知对象。解决先确认双方CATIA主版本和Build号一致至少在同一个SP补丁级别。然后导出宏时用.CATScript格式而不是.bas.CATScript是纯文本任何版本都能导入。在宏代码里的关键对象调用前后加上On Error Resume Next机制和日志输出至少能定位到是创建对象失败还是访问属性失败。5.2 尺寸参数更新失效同名特征与命名规范现象通过VBA修改一个圆柱的高度后重新Update模型没有变化或者弹出一个“约束不一致”的警告。原因CATIA内部通过特征名和参数名来标识对象。你的宏里如果用body.Shapes.Item(Pad.2)这种硬编码名称一旦用户手动改了特征名称或删除了之前某个特征Item索引就失效了。更隐蔽的是参数失效比如你用Parameters.Item(PartBody\Pad.1\FirstLimit)设置长度这个字符串路径里的斜杠和中文名称在不同语言版本的CATIA里不一致。解决不要用显示名称而是在创建对象时就留好变量引用。比如Set oPad oBodies.Item(1).Shapes.AddPad(...)之后直接用oPad设置参数而不是重新查找。确实需要从模型树定位时用CreatesFrom或从Reference对象反查路径不要自己拼字符串。我在团队里强制规定凡是被脚本控制的特征命名一律用前缀AUT_加序号避免用户手动重命名。5.3 自动化脚本卡在“正在保存”对话框现象脚本运行到Document.SaveAs时弹出“是否保存确定覆盖原文件”的对话框程序就停在那里等人工点击无人值守时整个批处理挂死。原因CATIA的SaveAs操作默认会确认覆盖。Automation接口虽然有个OverWriteMode属性但很多版本里需要配合Document.ClearTemporaryOut之类的方法才能稳定抑制对话框。解决保存前先执行一行设置oDoc.ReadOnly False oDoc.SaveAs C:\Output\1.CATPart, TrueSaveAs的第二个参数在VBA接口里要求传True表示覆盖。如果还不行就把所有对话框相关的系统设置属性临时关掉例如在宏开始时设置CATIA.SystemConfiguration或使用Tools的BatchMode。最稳妥的方案是用CAA的CATDocumentServices::SaveAs方法它可以完全绕过交互式确认。5.4 CATIA版本差异导致API行为不一致现象同一段宏在V5R21上正常在V5-6R2022上创建出的草图方向反了或者AddPad的参数类型变了。原因CATIA的Automation接口对某些几何操作在底层行为上有细微调整。比如Factory2D.CreateClosedCircle在少数版本里默认的法线方向和草图坐标系有关如果边界几何相同但参考平面选的是Z-X平面拉伸方向就不同。解决开发时建立“版本对照表”把同一个功能在主力版本上跑一遍的结果截图存档。交付时明确标注支持的最低CATIA版本。我吃过一次亏用V5R21环境开发的批量打孔宏拿到V5-6R2022上孔的位置全部偏移了0.5毫米排查到最后是隐藏的Sketches.Add时选用的坐标系定义方式变了。后来我在创建草图和拉伸之前一律显式指定参考平面和方向不用默认值。5.5 授权与开发效率开发机要独立配置现象在装着完整CATIA授权、跑着大型装配设计的同事电脑上进行二次开发调试每隔几分钟CATIA就假死一次编译好的DLL偶尔加载不进去。原因CATIA启动时会对所有安装的扩展模块进行初始化。如果开发机上安装了大量建模、仿真、加工模块启动时间和内存占用会拖垮调试同时CAA编译环境需要的环境变量和常规CATIA启动脚本冲突时DLL会加载失败。解决准备一台独立的开发机只装CATIA基础模块和你需要的RADE。启动开发模式时使用单独的“环境”配置文件不要和生产环境混用。调试CAA时用命令行启动带开发环境变量的CATIA确认CATEnv和CNext环境变量路径正确。VBA调试则相反希望在完整环境里测因为VBA很依赖当前加载的文档类型和上下文。6. 进阶把宏封装成批处理工具的三个实用技巧6.1 使用参数输入表驱动批量处理把宏里的所有常量定义改成从Excel或TXT读取这是从“能跑”到“能用”的关键一步。你可以用一个Scripting.FileSystemObject读取UTF-8格式的配置表每一列对应一个模型参数每一行生成一个模型。Dim fso As Object Set fso CreateObject(Scripting.FileSystemObject) Dim ts As Object Set ts fso.OpenTextFile(C:\config\intput.txt, 1, False, -1) Do While ts.AtEndOfStream True Dim line As String line ts.ReadLine Dim parts() As String parts Split(line, ,) Call CreateCylinderByParams(CDbl(parts(0)), CDbl(parts(1))) Loop ts.Close这段代码故意用CreateObject(Scripting.FileSystemObject)而不在工程里引用是为了减少对具体CATIA版本编译环境的依赖。参数从文本读入后模型的创建逻辑全部放到CreateCylinderByParams子程序里这样批处理和交互式运行共用一套建模代码。6.2 异常捕获与日志让脚本能过夜跑批处理脚本最怕中途弹对话框或者报错后直接退出。你需要给每个模型的处理过程加上独立的日志和错误跟踪。我习惯在每个Sub开头写一句LogInfo Starting: modelName在Err处理分支里把错误号和描述写进日志文件。On Error GoTo ErrorHandler LogInfo Create part start ... 建模代码 ... LogInfo Create part success Exit Sub ErrorHandler: LogInfo Error: Err.Number Err.Description Resume Next注意Resume Next放在错误分支里是为了让脚本继续处理下一个模型而不是再次执行失败那步。如果真的需要重试可以把Resume改成跳到Retry标签。日志文件用追加模式打开别用覆盖模式不然跑到一半系统重启会丢失之前的所有记录。6.3 与外部系统交互读取Excel配置并生成三维模型最后这个技巧是给已经能熟练写VBA的人。用ADO方式读取Excel文件比FileSystemObject读文本的更稳定因为Excel里的类型和列名可以被你的模型直接利用。Dim conn As Object Set conn CreateObject(ADODB.Connection) conn.Open ProviderMicrosoft.ACE.OLEDB.12.0;Data SourceC:\config\model.xlsx;Extended PropertiesExcel 12.0;HDRYES;; Dim rs As Object Set rs conn.Execute(SELECT Name, Diameter, Height FROM Sheet1 WHERE EnabledYes) Do While Not rs.EOF Call CreateCylinderWithName(CStr(rs(Name)), CDbl(rs(Diameter)), CDbl(rs(Height))) rs.MoveNext Loop用ADO读取Excel的好处是没打开Excel也能读而且支持SQL筛选尤其适合从几百行参数里挑出需要生成的模型。注意的是微软的ACE OLEDB驱动在64位CATIA下需要安装对应的64位运行库否则会报“未找到提供程序”。我有一台机器就是32位Office和64位CATIA并存折腾半天才搞明白是驱动的位数问题。我现在的习惯是能用参数表驱动就用参数表能写日志就写日志能用变量引用特征就不用字符串查找。CATIA二次开发到后期拼的不是生成模型的能力而是让脚本在任何环境、任何版本、任何用户乱操作下都还能跑出稳定结果的能力。这些坑大多没有写进官方教程都是一个个晚上加班试出来的。希望这篇笔记里的路线和避坑经验能帮你少走一段弯路。本文还有配套的精品资源点击获取