CATIA二次开发入门：用Automation创建凸台的完整指南

简介：CATIA二次开发培训文档《凸台的创建》是一份面向机械设计与CAD开发人员的实务讲义，系统讲解如何在CATIA中通过CAA/RADE扩展机制开发一个能创建凸台的新功能。资源包共1个PDF文件，大小约1.05MB，内容紧凑，特别适合在开发前通读，快速建立整体认知。文档前半部分从工作台创建入手，依次说明新工程建立、CAA模块加载、过渡模块构建和工作台生成，并详细介绍了工程配置中IdentityCard.h与Makefile文件的修改方法；后半部分则进入代码实现，覆盖工具条创建、对话框设计、控件初始化与回调函数编写，还补充了资源文件添加和图标加载等操作细节。已有91人学习，适合需要快速上手CATIA二次开发的初学者，也适合想扩展零件设计环境、实现特定建模功能的工程师。通过这份实例，读者可以清晰理解从环境搭建到功能落地的完整流程，有效减少自行摸索的时间。

1. 从“能打开CATIA”到“能控制CATIA”：为什么先拿凸台练手

很多刚接触CATIA二次开发的朋友，第一个困惑往往是“我该从哪个功能开始写”。拉伸、旋转、扫掠、放样……工具条上几十个命令，看着哪个都像突破口，但真要下手又不知道从哪里切入。我的建议一直很明确：先做凸台（Pad），然后把它彻底吃透。

为什么是凸台？因为凸台是CATIA零件设计里最基础、也最完整的建模动作——它需要你处理草图（Sketch）、参考面（Reference）、拉伸方向（Direction）、拉伸深度（Depth）这四个核心要素，而这四样东西几乎覆盖了所有参数化建模命令的共同底层逻辑。旋转体要参考轴线，扫掠要参考脊线，放样要参考多条截面，但它们的核心骨架仍然是“在某个参考面上画草图、沿某个方向生成实体”的同一个套路。

换句话说，把凸台的代码写通了，后面做旋转体、开孔、倒角、阵列，都是在这个骨架上做加法。反过来，如果你一上来就挑战扫掠或放样，光是理解“脊线耦合”“截面耦合”这些概念就足够消耗掉大半天的耐心，容易劝退。所以我带人入门，永远从凸台开始。

这篇文章的内容，来自我整理的一份内部培训文档。当时团队里几位机械工程师需要把重复性的凸台建模工作自动化，我就把CATIA二次开发里凸台创建的完整链路——从环境配置、工程模板、代码实现到报错排查——逐步写清楚，后来沉淀成了培训素材。今天把它拆开讲一遍，给同样需要做CAD自动化的朋友一条可以直接抄的近路。

2. 开发方式怎么选：CAA和Automation不是一道选择题

真正动手之前，先解决一个方向性问题：用哪套二次开发接口。CATIA二次开发主流方案有两条路：CAA（Component Application Architecture）和Automation（自动化接口）。很多培训文档喜欢两者混着讲，结果读者越看越乱。我建议按用途一刀切：做深度定制、性能敏感的，选CAA；做流程自动化、批量处理的，选Automation。

2.1 CAA：重量级方案，适合“造工具”

CAA基于C++和COM组件技术，直接嵌进CATIA的核心架构里，能访问最底层的几何内核，比如B-Rep（边界表示）数据、拓扑关系、精确几何计算。它的优势是控制精度极高、运行效率好，适合做真正意义的功能插件，比如自定义一个带交互界面的特征命令，或者实现CATIA原生命令没有的复杂算法。

但CAA的门槛也确实高。开发环境需要安装RADE（Rapid Application Development Environment），版本必须和CATIA主程序严格对应，编译链路长，调试复杂。我见过不少新人卡在环境配置上，RADE装了一整天，最后连一个“Hello Pad”都没跑出来。

2.2 Automation：轻量方案，适合“走流程”

Automation走的是COM自动化接口，可以用VBA、VB.NET、C#、Python等语言调用CATIA的API。它不需要安装额外的开发环境（用Excel的VBA编辑器或者Visual Studio Community就能写），也不需要跟C++编译器死磕，上手成本低很多。它的定位不是“开发新功能”，而是“把现有功能用代码串联起来”——比如遍历一批零件文件，每个文件里创建凸台、设置深度、保存文件，这类事情用Automation来做，开发效率是CAA的十几倍。

我培训团队里的人，如果目标是提升日常效率、做参数化模板，统一推荐Automation。CAA的内容可以作为进阶选修。

2.3 选型建议：用场景决定方案

如果你看了这个对比还不确定，我直接给你一个判断标准：这个工具是自己团队用，还是要卖给别人用？自己用，选Automation，省下的开发时间都是利润；对外发布、需要无缝嵌入CATIA界面，选CAA。本文以Automation为主，毕竟“创建凸台”这类操作，用Automation已经能够完整覆盖，而且代码足够短，适合边看边试。

3. 凸台创建的核心逻辑：一次讲清四个关键参数

在写第一行代码之前，必须先把CATIA的“建模乘法”逻辑弄明白。CATIA的自动化建模，不像你在界面上手动操作那样“所见即所得”，它更像搭积木：你要一层一层往对象树里挂节点。凸台的本质，是把一个二维轮廓（草图）沿着某个方向拉伸成三维实体。这个动作拆解到代码层面，涉及四个关键参数，缺一个都会报错或得到意外结果。

3.1 参考平面：一切草图的“地板”

在CATIA里画草图，必须先有平面——就像你要在地板上画线，得有块地板才行。这个平面通常取坐标平面（XY、YZ、ZX），也可以选已有实体的平面表面。代码里通过Shapes.AddNewPad()创建凸台之前，必须先用Sketches.Add(reference)把参考面指定给草图。

' 获取零件文档和部件对象 Dim oPartDocument As PartDocument Set oPartDocument = CATIA.ActiveDocument Dim oPart As Part Set oPart = oPartDocument.Part ' 获取原点坐标系的三个基准平面 Dim oPlaneXY As Plane Set oPlaneXY = oPart.OriginElements.PlaneXY

我见过很多新手在这里踩坑：有的是忘了取PlaneXY，直接空引用往下走；有的是取成了OriginElements.AxisXY（那是轴线，不是平面），结果草图创建失败或者画在了意外的位置上。这两个对象在名字上很接近，但在COM对象模型里是完全不同的东西，看文档时一定睁大眼睛。

3.2 草图：绘制平面的二维轮廓

草图是凸台的灵魂。创建完Factory2D之后，你就可以在这个二维坐标系里绘制轮廓。CATIA的草图API坐标系和你在界面上看到的坐标系完全一致：原点在屏幕中心，X轴向右，Y轴向上。

绘制轮廓有两种思路：一种是逐个调用Line2D、Circle2D、Arc2D等图元方法，适合几何形状固定的情况；另一种是先定义一组点坐标数组，再用CreateLineFromPoints或闭合样条创建轮廓，适合参数化生成的形状。对于培训入门，我建议先用最简单的矩形轮廓跑通全流程，再逐步换成真实产品的截面。

Dim oSketches As Sketches Set oSketches = oPart.Sketches Dim oSketch As Sketch Set oSketch = oSketches.Add(oPlaneXY) ' 进入草图编辑模式 oPart.InWorkObject = oSketch oFactory2D = oSketch.OpenEdition() ' 画四个顶点和一个闭合矩形 oFactory2D.CreateLine(0#, 0#, 50#, 0#) oFactory2D.CreateLine(50#, 0#, 50#, 30#) oFactory2D.CreateLine(50#, 30#, 0#, 30#) oFactory2D.CreateLine(0#, 30#, 0#, 0#)

注意，最后一步一定要用CloseEdition()关闭草图编辑。忘了这步，后面拿到的草图对象不完整，拉伸时会直接报“无效几何”之类的错误，而且这个错误不太好排查，因为报错指向的是凸台特征，而不是草图本身。

3.3 拉伸方向与深度：从二维到三维的“生长方式”

草图完成后，真正的“凸台创建”就开始了。CATIA里这步通过Shapes.AddNewPadFromRef完成——注意这个方法和AddNewPad的区别：AddNewPadFromRef允许你指定一个已有草图作为轮廓，而AddNewPad会在内部自动新建草图。我更推荐前者，因为草图对象你是自己可控的，后续要修改尺寸也方便。

Dim oShapes As Shapes Set oShapes = oPart.Shapes Dim oPad As Pad Set oPad = oShapes.AddNewPadFromRef(oSketch, 20.0)

这段代码的另一层含义是：拉伸方向默认取草图所在平面的法向。如果你需要沿特定方向拉伸（比如斜向凸台），就得在AddNewPadFromRef的完整签名里指定方向向量。对于绝大多数零件设计场景，默认法向已经够了，斜向拉伸属于少见需求，这里先不展开。

深度单位是毫米（mm），直接传数字就行。CATIA不会因为你传了个浮点数就误解单位，只要你的文档设置是毫米，20.0就是20毫米。

3.4 更新机制：记得“提交订单”

CATIA的自动化里，最容易被忽略却最关键的一步是Update()。很多初学者代码写完，没有报错，打开CATIA一看，什么都没有，回头查半天代码也不知道问题在哪——其实就是忘了更新。CATIA的模型树是延迟更新的，你添加的特征只是挂到了对象树里，要从“排队状态”变成“真实实体”，必须显式调用更新。

oPart.Update()

这句代码的类比是：你在餐厅点完菜，订单已经交给后厨了，但如果后厨不开火，菜永远不会上桌。Update()就是开火的动作。每次添加完特征、修改完参数，都建议立刻调用一次Update()，把当前状态固化下来，避免后面操作依赖了未更新的中间态。

4. 实操全流程：从新建零件到凸台落地的完整代码

理论讲完，我们实打实走一遍。下面这套步骤，是我培训文档里的标准流程，每一个环节都经过实际验证。你照着敲，应该能在十分钟内跑通第一个自动化凸台。

4.1 完整代码模板（VBA版）

我用VBA写这套示例，因为Excel/WPS里头就能直接开VBA编辑器，不用额外配置开发环境。先新建一个宏，然后整段粘贴运行即可。

Sub CreatePadDemo() ' 1. 获取当前激活的零件文档 Dim oPartDocument As PartDocument Set oPartDocument = CATIA.ActiveDocument ' 2. 获取零件对象与原点平面 Dim oPart As Part Set oPart = oPartDocument.Part Dim oPlaneXY As Plane Set oPlaneXY = oPart.OriginElements.PlaneXY ' 3. 在XY平面上创建草图 Dim oSketches As Sketches Set oSketches = oPart.Sketches Dim oSketch As Sketch Set oSketch = oSketches.Add(oPlaneXY) oPart.InWorkObject = oSketch Dim oFactory2D As Factory2D Set oFactory2D = oSketch.OpenEdition() ' 4. 绘制50mm x 30mm的矩形轮廓 oFactory2D.CreateLine 0#, 0#, 50#, 0# oFactory2D.CreateLine 50#, 0#, 50#, 30# oFactory2D.CreateLine 50#, 30#, 0#, 30# oFactory2D.CreateLine 0#, 30#, 0#, 0# oSketch.CloseEdition() ' 5. 用草图创建凸台，拉伸深度20mm Dim oShapes As Shapes Set oShapes = oPart.Shapes Dim oPad As Pad Set oPad = oShapes.AddNewPadFromRef(oSketch, 20.0) ' 6. 更新零件，让凸台真正生成 oPart.Update() MsgBox "凸台创建成功！", vbInformation, "完成" End Sub

运行前请确保CATIA里已经打开了一个新建的Part文件，并且鼠标点击过一下3D窗口（让CATIA的ActiveDocument聚焦到零件文档上）。如果当前激活的是装配文件或者工程图文档，CATIA.ActiveDocument拿到的类型不是PartDocument，第一行就会报类型不匹配。

4.2 参数的选型逻辑：为什么深度用20mm

有朋友可能会问：拉伸深度为什么是20？这其实没有任何魔法，只是某次演示时随手定的值。真正的核心在于：深度应该是可配置的。实际做自动化时，深度参数通常从Excel表格、数据库或者配置文件里读出来，而不是写死在代码里。

Dim dPadDepth As Double dPadDepth = 20.0 ' 实际项目中建议从参数表读取

我见过很多二次开发的代码，把一连串数字写死在程序里，客户要改产品型号时，得把源代码翻出来改三四个地方，极易出错。更合理的做法是：把尺寸参数顶到一个统一的配置入口，无论是Excel的命名单元格、自定义配置文件，还是CATIA的参数对象，都行。这属于二次开发的工程化习惯，越早建立越好。

4.3 完成后怎么检查结果

第一次跑通代码后，建议你做两件事来验证凸台是否“健康”。第一件事，打开CATIA左侧的模型树，展开零件几何体，确认多了一个Pad.1节点，节点下面还有一个Sketch.1节点。如果只看到Pad没有Sketch，说明草图没有正确关联上，多半是CloseEdition()前画图步骤不完整。

第二件事，双击Pad.1节点，在弹出的定义面板里查看拉伸深度、轮廓、参考面，与代码参数一一对应。这一步能把抽象代码和可视化结果对应起来，对记忆API非常有帮助。

塞一个我自己的习惯：验证完参数后，把Update()写进一个循环里执行两次，观察模型是否会报错。CATIA的更新机制是幂等的（同状态下重复更新不会出问题），如果重复更新报错，说明代码里有非规范操作，比如草图没有正确闭合。这种事排查起来很麻烦，提前测试一下更省心。

5. 实战中的坑，我帮你踩过了

这部分内容是我整理培训文档时特别标注的“经验区”。很多问题是网上资料不讲的，但实际跑代码时几乎必然会碰到。我按从高频到低频的顺序列一下。

5.1 “无可用许可证”问题：先确认不是开发环境的问题

最近在CATIA相关的社区里，很多人问“无可用许可证怎么办”。这个问题在二次开发场景里会呈现两种面貌。一种纯粹是软件授权问题，CATIA没有正常激活，特征是启动时就弹窗；另一种是代码环境问题，特征是启动正常，但调用CATIA.ActiveDocument时提示“服务器运行失败”或者“没有可用的许可证”，这时候要检查是不是多个CATIA进程冲突，或者VBA宏的权限设置不对。

如果你确定软件本身能正常打开建模，却在宏运行时报许可证相关错误，大概率不是许可证本身的问题。尝试把CATIA和VBA编辑器统统关掉重开一次，再以管理员身份运行，这个顺序能解决一半以上的奇怪报错。

5.2 当前文档不是Part怎么办

这是新手最常遇到的运行时报错。CATIA支持多种文档类型：Part（零件）、Product（产品）、Drawing（工程图）。宏里把CATIA.ActiveDocument直接赋给PartDocument变量时，VBA会做隐式类型转换，如果当前激活的不是零件文档，就会报“类型不匹配”。

解决思路有两个。第一，运行宏之前，在CATIA里新建一个Part并激活它。第二，在代码里加类型判断：

If TypeName(CATIA.ActiveDocument) = "PartDocument" Then ' 正常执行 Else MsgBox "请先在CATIA中打开或新建一个Part文件" End If

5.3 草图画出来是“破的”：几何闭合问题

凸台创建失败，核心报错往往是“几何无效”或“特征更新失败”，但根因在草图。CATIA和很多CAD内核一样，要求草图轮廓必须闭合、不能自相交、不能有开放的端点。代码里画四条线段，看起来是闭合成矩形的，但如果首尾端点坐标有微小偏差——比如手工计算时0.1和0.09的差异——轮廓就是“看起来闭合，实际上开口”的状态。

防止这个问题有一个很土但很有效的办法：画完所有线段后，用oFactory2D.Get2DCurveCount()检查图元数量，再用oFactory2D.Get2DCurve(1).StartPoint和EndPoint逐一核对端点坐标是否闭合。写个简单的校验函数，就几行代码，能省下大量调试时间。

5.4 更新慢：大批量建模的性能优化

如果你是批量处理几百个零件，每个零件都要创建凸台，你会很快发现Update()越到后面越慢。这是CATIA的“懒更新”特性在起作用——每次Update()都会重算所有特征，零件越复杂，单次更新越慢。

优化策略是分批更新、最后统一点击全部重建，或者把Part.Update()改成分步操作，只在关键节点更新。我在一个批量生成法兰盘的脚本里测试过：每创建完一个凸台就调用Update()，生成50个零件耗时约3分钟；改成全部特征添加完再一次性Update()，耗时缩短到1分钟以内。代价是中间状态“不可见”，一旦出bug不好定位。

5.5 翻车案例：把拉伸方向配错了

编码时还有个容易翻车的地方：AddNewPadFromRef的第二个参数，有些版本解析为“拉伸深度”，有些版本要求传入一个PadLimit对象。不同版本CATIA的API签名有细微差异，如果你在高版本里照抄低版本的代码，方向参数会解析错误，导致凸台朝反方向拉伸。

保险做法是翻转草图平面的法向，或者显式指定拉伸方向向量。更稳妥的做法是在代码里先读取一次oPad.FirstLimit.Dimension，确认当前版本确实把第二参数当深度处理了。如果不对，就改用oPad.FirstLimit.Dimension.Value = 20#这种方式手动设置。

6. 从凸台出发，下一步能做什么

跑通凸台之后，你已经掌握了CATIA二次开发的“动作语法”。但真正的效率提升，从来不靠单个命令，而靠命令的组合和参数化驱动。

6.1 参数化驱动：代码写在Excel里

我团队里最常用的一个模式是：把零件的关键参数——凸台深度、宽度、长度、倒角半径——全部放在Excel表里，VBA宏读取Excel内容，逐行更新CATIA模型。这样工程师不懂代码也能操作：改了Excel里的数字，点一下宏按钮，模型自动更新。这个模式本质上就是把CATIA的几何引擎变成Excel的“渲染器”，前端管数据，后端管建模。

实现思路也不复杂：先通过Parameters.Item("长度")在CATIA里建立用户参数，再把Excel单元格的值赋给这些参数，最后调用Update()。凸台的尺寸如果用的是参数驱动，而不是草图上硬画的固定数值，那么改参数值时草图和凸台会同步变化，非常方便。

6.2 批处理：凸台只是入口，循环才是精髓

把“创建单个凸台”套进For循环里，就是一套完整的批处理脚本。比如你有一张产品型号表，每行对应一个不同尺寸的法兰盘，循环体就是：读取一行→创建新Part→画草图→创建凸台→保存为指定文件名→关闭文档→读下一行。

但批处理有个隐藏陷阱：CATIA的内存管理。长时间跑循环，PartDocument对象如果不显式释放，内存会持续上涨，跑到一百多个文件后程序可能变慢甚至崩溃。代码里要注意在每次循环末尾把临时对象设为Nothing，并调用System.GC.Collect()触发一次垃圾回收。

6.3 后继学习路线建议

凸台做完之后，我推荐的下一步依次是：旋转体（AddNewShaftFromRef）、开孔（AddNewHole）、圆角（AddNewFillet）、阵列（AddNewRectPattern）。这几类命令和凸台的API结构高度相似——先建草图或选择已有特征、指定参数、更新。学完这些，你就具备了独立完成一个“小零件自动化”的能力。

再往后，如果你需要做装配体级别的自动化（比如自动摆放零件、生成约束），就可以开始研究ProductStructure的对象模型了。装配体自动化逻辑和零件特征自动化逻辑差别很大，但底子还是在零件阶段打下的这几板斧。

7. 写在最后：从“会操作”到“会写代码”，差的只是一个凸台

带过几批人之后，我发现一个规律：学会CATIA二次开发的关键不在于语言能力，也不在于CAD理论深度，而在于“在哪个节点突破第一道坎”。凸台就是最好的第一道坎——它足够简单，能让你的注意力集中在API的调用逻辑上，而不是被复杂几何绕晕；它又足够完整，让你一次接触全部核心要素，建立完整的对象模型认知。

我个人的体会是，当你第一次用代码“凭空”生成一个三维实体时，那种感觉和手动建模完全不同。手动建模像弹钢琴，你按下一个键出一个音；代码建模像指挥乐队，你写下一行谱子，几十个部件精准配合。这种掌控感的门槛很低——上面那段VBA代码，复制、粘贴、运行，十分钟就能体验到了。

最后分享一个实操中养成的小习惯：每次写完一段二次开发脚本，把它保存成带详细注释的模板，放到团队共享目录里。CATIA的API细节很多，单靠记忆很容易忘，而底下的标准答案永远比搜索引擎里的零散答案更对症。我这份培训文档就是这么一点点攒下来的，希望这篇拆解，也能帮你少走一些我走过的弯路。

本文还有配套的精品资源，点击获取