简介这是一份针对CATIA二次开发入门与进阶的培训文档重点讲解如何通过CAA与VS环境创建凸台功能面向需要定制CATIA工作台、扩展零件设计能力的机械设计及二次开发工程师。文档按完整开发流程组织内容涵盖工作台创建、CAA模块加载、配置IdentityCard.h与Makefile、编写工具条和对话框、关联按钮事件并实现参数化凸台生成结构清晰、步骤明确适合边看边练。资源包仅含1个PDF文件大小约1.05MB便于下载和离线阅读篇幅紧凑但覆盖了从工程搭建到代码实现、资源文件添加的关键环节已有91人学习使用。通过该文档开发者可以快速掌握CATIA二次开发的基本套路理解工作台与模块的关联机制并在实际项目中按需扩展更多自定义特征。 做过CATIA二次开发的人应该都有一种感觉市面上讲环境配置、宏录制的资料不少但真正能一步步把“零件建模常用命令”从界面操作翻译成代码的教程少之又少。刚接触CAA的时候我在网上翻了很久发现讲得最透彻的往往不是官方文档而是某份被反复传阅的培训PDF——其中“凸台的创建”几乎是所有人必刷的第一道坎。原因很简单凸台是CATIA零件设计里最基础、也是后续所有拉伸、开孔、扫掠类特征的地基。这篇文章就是把这份培训重点重新梳理一遍用两条路线来讲解一条是正经的CAA C开发适合要做企业级插件、深度集成功能的人另一条是VBA自动化脚本适合不想碰编译环境、只想快速批量建模的工程师。无论你走哪条路凸台这个功能的完整链路——从进入草绘、绘制轮廓到退出草绘、设置深度方向——都值得彻底吃透。1. 为什么凸台创建是CATIA二次开发的“第一道坎”1.1 两条开发路线的本质差异CATIA二次开发这个领域从工具链上分得很清楚CAAComponent Application Architecture和VBA Automation。CAA是基于C的组件级开发直接打到CATIA内核的CNext底层接口上。能力最强能干的事情也最多——新建交互命令、自定义工作台、在树结构里挂业务对象、和PLM集成。代价是门槛陡峭要先装RADERapid Application Development Environment配Visual Studio还要理解一堆COM、接口引用、生命周期管理的概念。很多老工程师看到CAA的报错就直接劝退。VBA则简单得多基于CATIA自带的Automation API。它在CATIA进程内运行通过Application对象往下走命令都是“Document.Part.ShapeFactory.AddNewPad”这种层次化调用跟录制宏的套路几乎一样。上手极快适合把重复劳动自动化。缺点也很明显跑不了交互命令做不了独立EXE遇到复杂精确实体运算时API覆盖有限。我的建议是你在企业里做长期工具开发走CAA你今天就想省点事把十个零件批量加上凸台VBA完全够用。两条路的“凸台创建”逻辑本质相同都是“草图轮廓拉伸参数”所以这篇文章的中间部分我会先用CAA拆原理再用VBA给一套能直接用的脚本。1.2 凸台特征的内在结构它到底由什么组成凸台在CATIA结构树里看起来就一个节点但它的内部组织比界面显示要丰富得多一个草绘Sketch这个草绘必须完全封闭可以是圆、矩形、样条线围成的任意闭合区域甚至可以带内部挖空环这决定了截面的形状一个拉伸方向Direction默认是草绘所在平面的法向也可以指定任意直线作为方向一个深度值Height控制拉伸长度可选的拔模角度Draft、薄壁厚度Thickness用于构建复杂的钣金或注塑特征。把这几个要素记牢后续所有拉伸类特征开槽、加强筋、实体混合都是它的变体。CATIA界面里的“凸台”命令参数面板本质上就是在编辑这组数据的映射关系。二次开发做的也是同一件事先拿到一个可用于草绘的参考平面画好轮廓然后把轮廓、方向、深度值打包交给内核。这里有个新手常犯的认知误区以为CATIA里“草图”和“凸台”是两个独立的对象。其实凸台特征内部持有一个名为Sketch的子对象这个对象既可独立存在你在草图工作台看到的就是它也可以被特征消费“消费”时它被附加到父特征的几何集下。所以创建代码的顺序必须是先创建草绘并画出轮廓再在草绘基础上创建Pad而不是先NewPad再给平面。2. 动手前的环境准备版本配对和授权检查最磨人2.1 CAA RADE与CATIA、Visual Studio的版本对应“为什么我按教程装了CAA还是编译不过”——这是我见过最多的问题而且九成是版本不匹配。CAA RADE每个版本都有对应的CATIA版本RADE本质上是一套基于Visual Studio的插件它通过“Environment”配置告诉编译器“你要链接哪个版本的CATIA对象库”。例如CATIA版本对应CAA RADEVisual Studio版本V5-6R2016CAA R2016VS2013 / VS2015V5-6R2019CAA R2019VS2015 / VS2017V5-6R2021CAA R2021VS2017 / VS2019V5-6R2023CAA R2023VS2019 / VS2022装的时候按“CATIA本体 → CAA RADE → 配置Environment”的顺序来。RADE装完会在系统里写入“CATEnv”环境变量Visual Studio里新建项目时会多出一个“CAA C Project”模板如果没看到模板多半就是RADE没有正确检测到VS版本或者VS装在了RADE之后导致插件未被注册。2.2 不想碰编译环境的人怎么绕过环境问题不学CAA的人有很多但这不意味着你学不了二次开发。CATIA的Automation API是随软件自带的打开“工具→宏→Visual Basic 编辑器”就能直接用。这里有一个非常实用的技巧不管你是CAA还是VBA先把CATIA自带的“宏录制”功能录一遍凸台创建过程。在录制状态下手动新建零件、进入草绘、画矩形、退出并拉伸录出来的脚本就是最标准的需求分析说明书。里面调用链的顺序、参数名就是API文档里写的东西。拿到录制代码后再改参数、加循环做成批量处理脚本。这是一种“反向学习法”——不先学API而是先看系统怎么调API。对新手来说比翻文档高效十倍。另外提醒一点不管走哪条路都要确保CATIA授权环境正常。这点来说公司买的正版或官方试用许可都行。我曾经见过同事折腾了一下午的报错最后发现是授权文件没加载根本不是代码问题。3. 凸台创建的核心数据流“草绘-引用-拉伸”三步3.1 拿到工厂接口所有特征都从CATIPrtFactory开始在CAA里一切特征创建的入口都是一个叫“CATIPrtFactory”的接口。它相当于零件设计工作台的“行政大厅”你要Create Pad、Create Hole、Create Pocket都从这里走。怎么拿到它先获取当前零件文档的工厂接口CATDocument* pDoc CATFrmLayout::GetCurrentDocument()-GetDocument(); CATIPrtFactory* pFactory NULL; // 通过文档的接口查询工厂 // 最终拿到 pFactory工厂拿到之后第一步往往不是直接创建凸台而是先创建草绘。创建草绘需要两个东西一个支持面Reference Plane比如XY平面、平面偏置或现有实体的一个平整面一个坐标轴方向Axis草绘的坐标系要靠它定位。用CATIPrtFactory创建草绘的核心逻辑是CATICkePrtFactory* pCkeFactory NULL; CATMathDirection normalAxis(0, 0, 1); // 法向轴 CATMathPoint origin(0, 0, 0); // 原点位置 CATI2DGeoFactory* p2DGeoFactory NULL; // 二维几何工厂 pCkeFactory-CreateSketch(referencePlane, normalAxis, pSketch); pSketch-Get2DGeoFactory(p2DGeoFactory); // 拿到草绘里的2D绘制工具生活化一点理解CreateSketch相当于在3D空间里支起一块虚拟的白板白板的原点和法向方向由你指定之后你就站在白板上用2D几何工厂画线、画圆、画矩形。3.2 草绘中的二维几何绘制进入草绘后你手里有了一张二维图纸和一个p2DGeoFactory。这时画轮廓的套路和你在草图工作台一模一样画一条直线CreateLine画一个圆CreateCircle画带约束的矩形CreateRect以CAA里画一个最简单的矩形凸台截面为例几何工厂的调用大致如下CATICkeRep_p spRect p2DGeoFactory-CreateRect(shapeFactory, xOrigin, yOrigin, xWidth, yHeight, startPoint, endPoint);注意这里的坐标系是草绘的局部二维坐标x、y对应的是当前“白板”的横轴纵轴跟CATIA结构树里的全局坐标没有直接关系。很多新手在这里踩坑以为用了全局坐标结果草图跑到天上去拉伸出来一个歪斜的实体。画完轮廓后要调用pSketch的Update或CloseEdition来关闭草绘。这个动作等同于你在界面里点“退出草图工作台”。少这一步后面创建凸台的接口根本不知道你的截面长什么样。3.3 从二维轮廓到三维凸台轮廓画完接下来的CreatePad就是纯粹的参数打包CATIPad* pPad NULL; pFactory-CreatePad(pSketch, 0.0 /*第一方向拉伸*/, pPad); if (pPad ! NULL) { pPad-SetHeight(20.0); // 拉伸深度 pPad-SetDraftAngle(0.0); // 拔模角 pPad-SetThickness(0.0); // 薄壁厚度 pPart-Update(); // 更新零件 }CreatePad的第一个参数是刚才画好的草绘第二个参数是拉伸模式标记0表示向第一方向拉伸1表示第一方向和第二方向对称拉伸2表示仅向第二方向3表示镜像等等——这些枚举值在CAA的头文件里都有定义但容易混淆。另一个容易忽略的点是SetHeight的单位CATIA默认是毫米但如果你在工程环境里改过单位配置传进去的数字就会被理解为“当前图纸单位下的值”这会导致批量建模时尺寸差1000倍。此时零件还不一定刷新显示必须调用Part的Update来让特征真正生成。这个Update就是把草绘轮廓和拉伸参数“烧结”成实体特征的关键步骤。漏掉Update的典型表现是结构树里出现了Pad节点但图形区没有实体点开的特征几何完全为空。4. 一份可直接抄作业的CAA代码含逐段解释下面这份代码我整理自一个实际可用的测试工程注释部分我做了补充说明。它的功能是新建零件 → 在XY平面创建矩形草绘 → 拉伸成长方体凸台。4.1 创建零件与初始草绘#include CATDocument.h #include CATIPrtFactory.h // 特征工厂 #include CATICkePrtFactory.h // 引用工厂 #include CATICkePlane.h #include CATISketch.h #include CATI2DGeoFactory.h #include CATIMechanicalPart.h #include CATIPart.h CATDocument* pDoc ...; // 获取或者新建CATPart文档 CATIPrtFactory_var spPrtFactory pDoc-GetPart()-GetIPrtFactory(); // 取得XY平面作为草绘支持面 CATICkePrtFactory_var spCkeFactory spPrtFactory-GetReferenceFactory(); CATICkePlane_var spXYPlane spCkeFactory-CreateReferencePlane( pDoc-GetPart(), CATIProduct::XY); // 创建草绘法向取Z方向即垂直于XY平面 CATISketch_var spSketch NULL; spPrtFactory-CreateSketch(spXYPlane, spSketch); spSketch-SetName(FirstSketch); // 打开草绘编辑准备画截面 CATI2DGeoFactory_var sp2DFactory spSketch-Get2DGeoFactory(); spSketch-OpenEdition();这里有三个容易出现编译错误的地方。第一个是CATIPrtFactory_var这种“var类型”它和C标准指针不一样是CAA自己封装的引用计数智能指针不能随便转成裸指针。第二个是CreateSketch的重载形式有好几个在新版本接口里要求传CATMathDirection和CATMathPoint来定义草绘坐标系不传则默认用支持面的坐标系。第三个是OpenEdition和CloseEdition是成对出现的最后一个括号漏掉就会导致后续接口拿不到草绘内容运行时会直接崩。4.2 关闭草绘与凸台参数设置// 画一个以原点为左下角、矩形宽100高60的封闭截面 CATMathPoint nullPt(0, 0); double axisAngle 0; CATICkeRep_var spRect sp2DFactory-CreateRect( spSketch-OpenBody(), 0, 0, // 起点x, y 100, 60, // 宽度, 高度 NULL, NULL); spSketch-CloseEdition(); spSketch-Update(); // 创建凸台特征 CATIPad_var spPad NULL; spPrtFactory-CreatePad(spSketch, 0.0, spPad); if (NULL_var ! spPad) { spPad-SetHeight(30.0); spPad-SetDraftAngle(0.0); spPad-SetThickness(0.0); spPad-SetThicknessDirection(CATPadThicknessOrientation::Inside); spPad-Update(); spPrtFactory-GetPart()-Update(); }注意CreateRect里的spSketch-OpenBody()这个参数。CATIA的草绘内部有“几何体”的概念你可以把草绘里的几何对象理解成放在一个未关闭的“草图工作台容器”里。OpenBody返回这个容器的根对象2D几何工厂创建的所有图元都会挂在它下面。很多人漏传这个参数看到的报错是“Invalid bottom operator”其实就是找不到图元的父容器。编译生成之后在CATIA里运行这个命令你会看到结构树多了一个PartBody下的凸台特征下面挂着一个名字叫FirstSketch的草图图形区多了一个100×60×30的矩形实体。这个结果和手动操作CATIA建的凸台没有任何区别因为CAA本来就是在调用CATIA内核同一个建模引擎。4.3 编译运行的效果与验证我建议你在跑通代码后立刻做一个验证动作双击凸台节点进入“编辑参数”界面然后点击草图节点试着再改一下矩形的尺寸。你会看到代码建的凸台和界面建的凸台在交互性和参数关联性上完全一致。这里就引出一个CAA最重要的观念你用代码做的不是“模拟”用户操作而是直接调用CATIA核心建模引擎——所以代码生成的模型天然具备全过程的可编辑性这也正是CATIA二次开发相比CAD模型文件交换比如STEP/IGES不可替代的地方。5. 不想碰C用VBA宏也能创建凸台5.1 宏录制与Automation API的异同如果你的目标是“快速做几个自动化工具”完全没有必要被CAA的开发环境吓住。CATIA自带的VBA环境基于Automation API接口命名和CAA有不少相似之处但更直白CAA里的CATIPrtFactory对应VBA里的ShapeFactoryCAA里的CreateSketch对应VBA里的Sketches.AddCAA里的CATI2DGeoFactory CreateRect对应VBA里的Sketch.Factory2D.CreateRectangle。下面是一段可以直接粘贴到“工具→宏→Visual Basic 编辑器”里运行的脚本。作用是在当前零件文档里的XY平面创建一个矩形草图然后拉伸出一个凸台。Sub CreatePadFromVBA() Dim partDoc As PartDocument Set partDoc CATIA.ActiveDocument Dim part As Part Set part partDoc.Part Dim hs As HybridShapeFactory Dim sfs As ShapeFactory Set hs part.HybridShapeFactory Set sfs part.ShapeFactory 获取XY平面 Dim planes As Planes Set planes part.Bodies.Item(1).Sketches Dim xyPlane As Plane 通过坐标参考构建平面这里用系统内置XY平面 Dim refPlane As Reference Set refPlane part.CreateReferenceFromObject(part.OriginElements.PlaneXY) 创建草图 Dim sketch As Sketch Set sketch part.Bodies.Item(1).Sketches.Add(refPlane) sketch.Name VBAPadSketch 画矩形二维坐标0,0到100,60 Dim factory2D As Factory2D Set factory2D sketch.Factory2D Dim line1 As Line2D Set line1 factory2D.CreateLine(0, 0, 100, 0) Dim line2 As Line2D Set line2 factory2D.CreateLine(100, 0, 100, 60) Dim line3 As Line2D Set line3 factory2D.CreateLine(100, 60, 0, 60) Dim line4 As Line2D Set line4 factory2D.CreateLine(0, 60, 0, 0) sketch.CloseEdition part.Update 创建凸台 Dim pad As Pad Set pad sfs.AddNewPadFromRef(sketch, 30) pad.Name VBAPad part.Update MsgBox 凸台创建成功 End Sub这段脚本的坑在哪里就是AddNewPadFromRef这个函数它的第一个参数是Reference对象不是Sketch对象本身。很多VBA新手直接传Sketch对象进去编译到一半就报“类型不匹配”这是因为Automation API设计模式里明确要求“引用几何”必须通过CreateReferenceFromObject来包装。这也是我在CAA部分强调过的“引用”思维——二次开发里几乎所有特征生成的参数都要求传“引用”而不是传“对象副本”。5.2 用VBA批量创建凸台的完整思路跑通单个凸台之后批量化的思路就水到渠成了遍历一组Excel里维护的尺寸参数长、宽、高每次循环创建一张新零件文档或者复制模板文档改淡草绘尺寸值再更新零件。这里透露一个实用经验批量建模时最好不要每次新建文档、每次画草图性能太差。更好的做法是准备一个CATPart模板文件模板里已经有一个凸台特征。用脚本打开模板通过part.Update之后修改参数的Value引用然后另存为新零件。这样凡是形状相同的零件你只需要改尺寸参数能比全模型重画快十倍以上。这个技巧把“创建凸台”从单个特征升级到了“批量参数化生成零件”的维度VBA虽然不能像CAA那样做独立插件但在企业里的“快速设计工具”层面足够了。6. 我踩过的坑和一些能让你少加班的建议6.1 方向、坐标和厚度这三个参数的坑凸台的三个核心参数里最容易栽跟头的不是深度值而是方向。在CAA的CreatePad里第二个参数表示拉伸模式它有一个选填参数CATMathDirection。不传时默认用草绘法向拉伸。但你如果传了一个法向相反的向量比如传(0,0,-1)凸台就会往反方向长而且不会报任何错误直到你检查成品模型时才发现方向反了。我的建议是涉及方向的场合先明确单位向量尤其在从外部数据比如Excel里存的坐标系向量读取时别忘做归一化不然向量长度不等于1会导致凸台拉伸方向和预期偏差。坐标系的坑则在草绘里。前面说过草绘内部是二维局部坐标系。当你用CreateRect画图时起点坐标必须是在“当前草绘坐标系”下的值而不是零件绝对坐标。不少人从三维坐标直接拿数字进去填出来的草图位置让人摸不着头脑。解决办法是在画图前先打印spSketch的坐标轴方向或者直接在界面上双击草图看一眼它的原点这一步在调试初期省下的时间非常可观。厚度参数更隐蔽。凸台的SetThickness是给“薄壁凸台”用的一旦设置了非零厚度凸台会自动从“实心实体”变成“薄壳”。很多新手在做一个带腔体的零件时误把内腔尺寸当成厚度填进SetThickness结果生成一个空心壳而非预期的实体块结构树里却完全看不出问题。如果你的业务不需要薄壁件就老老实实传0。6.2 引用、生命周期与几何集CAA和VBA最不一样的地方是对“内存/引用”的管理。CAA里所有接口都继承自CATBaseUnknown创建出来的对象都要Release。初学者最容易犯的错循环创建几百个凸台每次都不Release中间引用最后CATIA直接卡死——这不是建模性能问题是内存泄漏。更隐蔽的是“引用失效”问题。在CAA里你通过CreateReferenceFromObject拿到一个Reference但这个Reference在源几何被修改或删除后并不会自动失效。比如你先引用草绘创建了凸台然后又修改草绘尺寸最后再用这个旧Reference做其他操作结果可能指向一个已经重构过的几何报错信息却是“对象不存在”。至于几何集Geometrical Set则是资深开发者才会提到的概念。凸台默认创建在PartBody几何体下但在做复杂零件时为了让结构树可读你会想把辅助草图、基准平面放到不同的几何集里。CAA有专门的接口管理几何集创建和挂载VBA里只能通过Bodies集合的名称来操作。这部分属于进阶内容等你把基础凸台跑通后再研究即可第一阶段不用强求。6.3 从凸台出发的下一步学习路线凸台是起点不是终点。我的建议是跑通本文的代码之后按这个顺序往下推进学会创建凹槽Pocket它和凸台的API几乎互为镜像——一个是加材料一个是减材料——理解这对孪生兄弟能让你的思维从“画一个模型”升级为“理解布尔运算对实体体素的增减”学会创建参考几何比如偏移平面、轴线、交线这些是高压曲率建模的辅助基础学会用草绘约束替代硬编码坐标值让轮廓具备参数驱动能力再往后就可以尝试扫掠Rib/Slot和多截面实体Loft形成完整的特征建模视图。如果你是从VBA入门前期完全可以跳过第3步直接用Excel VBA的套路做参数化模板但一旦涉及复杂装配协同或企业级系统集成CAA还是绕不开的终点。两条路不冲突先用VBA做出成绩、看到二次开发的价值再决定要不要投入CAA的深水区是很多从业者走过的务实路径。最后说点个人体会每次我教新同事做CATIA二次开发都会先让他把凸台用三种方式各建一遍——界面操作一遍、宏录制一遍、手写CAA代码一遍。这三遍走完他对“CATIA内部数据模型”的认识基本就立住了。这个看似枯燥的重复过程比任何空泛的理论讲解都有效。希望这篇文章也能让你少走点弯路。本文还有配套的精品资源点击获取