简介：面向机械设计、数字化制造方向的工程师，这份文档系统介绍了CATIA二次开发的核心路径。内容以Windows XP + VC++6.0为环境，讲解基于Component Application Architecture（CAA）组件应用架构的CATIA界面二次开发，并与VBScript宏方式做了对比。文档详细梳理了进程内与进程外两种通信机制，以及CAA基于COM/OLE技术的组件化开发思路。作为完整实例，文中以五坐标数控机床运动仿真系统为对象，逐步演示了新建独立工作台、添加菜单与工具条、创建按钮图标、插入CATIA风格对话框、用代码生成三维模型并显示等流程，同时对应给出CAA RADE快速开发环境的搭建要点，为读者提供了从环境配置到界面定制的可操作参考。资源为1个doc文件，包体约205KB，属于技术文档型资料，已有6412人学习下载，适合需要快速掌握CAA开发框架和界面扩展步骤的CATIA中高级用户。
1. CATIA二次开发到底在解决谁的什么问题：从自动化建模到企业级工具链
CATIA二次开发，听起来像是程序员的事，但真正把它当日常工具用的，往往是被重复建模、批量改图、人工比对逼急了的机械和汽车工程师。把一小时的手工操作压到几分钟，把企业里的设计规范写进一条命令，这是这个方向最大的价值。接下来我会沿三条主流路线展开：宏录制、VBA脚本、CAA原生扩展，给出各自的适用边界和能直接上手的起步动作。适合那些已经在用CATIA做设计、想靠代码提效，却被API文档劝退的从业者，也适合需要评估二次开发投入产出比的技术管理者。
2. 先立框架：三大开发路线怎么选，以及各自的第一条命令
选错路线，后面全是血泪经验。宏录制适合十分钟内验证需求；VBA脚本适合个人和部门级批处理；CAA适合要做成企业标准功能的团队。先看对比表，再逐个讲。
| 路线 | 难度 | 交付形态 | 适用场景 | 维护成本 |
|---|---|---|---|---|
| 宏录制 | 最低 | VBS/VBA脚本 | 快速验证、单次操作 | 最低 |
| VBA脚本 | 中等 | 脚本，可配界面 | 批量处理、部门工具 | 中 |
| CAA | 高 | 编译为dll插件 | 企业级功能、工作台集成 | 高 |
2.1 宏录制：最容易被低估的起点
宏录制不是玩具，它输出的代码就是CATIA操作的对象模型查询结果，比翻API文档直观得多。我一般把它当接口字典用：建一个圆柱，录制，停止，打开宏库看代码，就大概知道Pad和Sketch在哪个对象下面。
操作步骤：工具 → 宏 → 录制，操作完成后停止，选择保存到宏库。录出的代码类似这样：
Dim documents1 As Documents Set documents1 = CATIA.Documents Dim partDocument1 As PartDocument Set partDocument1 = documents1.Add("Part")这段代码的最大问题是绑定了你当时的操作环境：文档名固定、坐标固定、命令按钮路径固定，跑第二次就可能报找不到Part1（副本）。所以宏录制的产出要做三处修正：把固定文档引用改成新建文档、把Selection选择改成按集合索引取对象、把写在代码里的数值提到脚本头部变量。三处改完，你已经算入门二次开发了。
录制的代码能跑，是因为CATIA把每一步GUI操作翻译成了COM调用，对应的是产品对象模型，不是鼠标轨迹。宏库文件存储位置不重要，你只需要把代码复制到VBA工程里手动改参，原来录制的分支判断和弹窗纠错逻辑大可以直接删掉。
2.2 VBA脚本：批量任务的性价比之王
VBA是CATIA自带脚本环境，不需要单独编译，脚本直接插入零件文档，一次可以处理整个文件夹的模型。批量属性写入、批量出图、批量几何检查这类和人机交互无关的活，VBA是首选。
连接CATIA的代码是所有脚本的第一步：
Dim catiaApp As Object On Error Resume Next Set catiaApp = GetObject("", "CATIA.Application") On Error GoTo 0 If catiaApp Is Nothing Then Set catiaApp = CreateObject("CATIA.Application") catiaApp.Visible = True End IfGetObject拿的是已经打开的CATIA实例，CreateObject是新建一个进程。跑批脚本我更喜欢CreateObject，因为可以从头控制文档开关状态，避免残留引用让内存涨上天。Visible=True只在调试时需要，正式批量跑可以关掉，速度快很多，但出错时不好定位，所以我的习惯是调试阶段保留界面，稳定后再关。
2.3 CAA与RADE：把功能做成CATIA原生命令的重型路线
CAA是CATIA提供的组件应用架构，支持C++和Java，开发环境是RADE。它编译出来的是dll插件，加载进CATIA后和自带命令一样，出现在工作台里、支持Undo、支持多文档事务。代价是学习曲线陡峭，环境配置繁琐，编译一次的时间够脚本调试十次。
我一般这样做判断：如果这个工具要被五十个人用三年，并且要跟PLM系统、企业模板集成，CAA几乎是唯一可靠选择；如果只是自己点按钮太烦，VBA已经够了。CAA环境搭建需要配RADE插件、配编译工具链、建Workspace、处理启动配置，这些准备工作做完才能写第一个命令。第4章会把命令骨架拉出来，这里先记住CAA的对象关系和VBA看到的是同一套底层模型，把VBA先跑通，对后面理解CAA帮助很大。
3. 用VBA在CATIA里跑通第一个自动建模用例：参数化圆柱底座的完整脚本
3.1 从录制到调通：把宏仓库里的代码搬进VBA工程
录制的代码搬进VBA工程后通常会报两种错：找不到对象，或者对象不适用。原因很简单，录制代码里掺杂了大量GUI环境特有的临时引用。我一般会把所有Documents.Item("Part1")改成添加新文档的代码，保证每次运行从零开始。
常见修正点：录制代码喜欢用Selection对象，例如SelectElement、SelectPlane，这是为了模拟鼠标点击的稳定性。但脚本自动化里这么写会触发弹窗，弹窗一卡整条脚本全停。正确做法是把Selection相关行删掉，直接用集合的Item方法或ByName去引用对象。Selection适合交互式命令，自动化要绕开它，这个原则在后面的避坑章节还会再提。
3.2 核心操作链：创建Part、Sketch、Pad与参数驱动的写法
下面这段脚本创建圆柱底座，外径和高放在头部，方便下一步包成输入框：
' 圆柱底座参数，放在头部方便改成输入框 Dim D As Double Dim H As Double D = 50 ' 外径 H = 10 ' 高度 Sub CreateBase() Dim catiaApp As Object On Error Resume Next Set catiaApp = GetObject("", "CATIA.Application") On Error GoTo 0 If catiaApp Is Nothing Then Set catiaApp = CreateObject("CATIA.Application") catiaApp.Visible = True End If catiaApp.Visible = True Dim partDoc As Object Set partDoc = catiaApp.Documents.Add("Part") Dim part As Object Set part = partDoc.Part Dim body As Object Set body = part.Bodies.Item("PartBody") ' 在XY平面建立草图 Dim sketches As Object Set sketches = body.Sketches Dim sketch As Object Set sketch = sketches.Add(part.OriginElements.PlaneXY) part.InWorkObject = sketch ' 在草图里画圆 Dim factory2D As Object Set factory2D = sketch.Factory2D Call factory2D.CreateClosedCircle(0, 0, D / 2) part.Update ' Pad拉伸 Dim shapeFactory As Object Set shapeFactory = body.ShapeFactory Dim pad As Object Set pad = shapeFactory.Pads.Add() pad.StartLimit.Depth.Value = 0 pad.EndLimit.Depth.Value = H part.Update MsgBox "圆柱底座创建完成，外径" & D & "，高度" & H End Sub代码里要特别注意：CreateClosedCircle的三个参数依次是圆心X、圆心Y、半径，单位是毫米，所以传D/2而不是D。Pads.Add()返回一个Pad特征，StartLimit和EndLimit定义拉伸的两个边界，StartLimit=0表示从草图平面开始，EndLimit=H表示沿法向推H毫米。每次画完草图必须part.Update，否则对象模型里没有实际几何，Pad找不到轮廓。参数和几何对象之间的关系就是修改头部D和H，重新运行脚本，新圆柱会按新参数生成。
3.3 参数化改造与运行结果核查
跑完后去CATIA里看特征树：PartBody下应该只有一个Sketch.1和一个Pad.1，草图里的圆必须是完整闭合曲线。改D、H数值再运行一次，CATIA会新建一组特征，而不是更新旧特征，这是脚本自动化和人工操作最大的不同。想真正参数化驱动，需要用Part.Relations和Formula对象把D、H做成用户参数，这一步涉及参数表与几何特征的关联，属于进阶方向。
核查单位是个大坑。CATIA界面默认毫米，但脚本API内部某些操作把值当米处理，同样传10，不同环境可能得到10毫米也可能得到10米。我的习惯是运行前先检查当前文档的单位，或者在界面上固定毫米制，再用宏录制对比一遍数值。别凭感觉填，尤其从别人机器上拷来的脚本，单位不对能让你怀疑人生。
4. 走向CAA：构建原生命令的基础框架与对象模型
4.1 CATIA的COM对象模型：从Application到Feature
CAA绕不开对象模型。Application在最顶层，下面挂Documents集合，PartDocument和ProductDocument表示不同类型的文档。往下一层是Part，Part下是Bodies，Body里又有ShapeFactory、Sketches等。这套层级理解了，VBA和CAA写起来都会顺手很多。
常见误解是认为CAA是另一种更强大的脚本语言，其实CAA是CATIA把COM对象模型暴露给C++开发者，让你实现脚本里做不到的回调、命令上下文和多文档协作。用CAA写的功能最终编译成dll，加载后像CATIA自带命令一样参与Undo/Redo和特征重建，这是脚本永远做不到的边界。
4.2 搭一套CAA环境：RADE、编译链与Workspace
CAA开发环境一般是CATIA自带的RADE插件挂在Visual Studio上。准备工作有三件：安装对应版本的RADE、确认许可证包含CAA模块、建一个Workspace存放源码和中间文件。环境配置的坑主要在版本严格匹配，CATIA版本和RADE差一个发行版就编不过。
具体步骤：
- 在VS里新建Workspace。
- 往Workspace添加Framework和Module。
- 在Module的src目录写命令类，继承CATCommand。
- 编译生成dll。
- 用启动参数让CATIA加载这个dll。
启动参数每个环境不一样，核心是保证环境变量指向Workspace的输出目录。第一次配置不要贪多，先做一个什么都不干但能被CATIA加载的空命令，确认加载链路通，再往里面加业务。
4.3 最小可用的CAA命令模块：命令、交互与资源文件
命令类骨架用C++写，我给出精简版：
// CmdCreateBase.h #pragma once #include "CATCommand.h" #include "CATCommandHeader.h" CATDeclareCommand(CmdCreateBase, CATCommand); class CmdCreateBase : public CATCommand { public: CmdCreateBase(); virtual ~CmdCreateBase(); protected: virtual CATStatusChangeRC Activate(CATCommand *iCmd, CATNotification *iNotif); virtual CATStatusChangeRC Desactivate(CATCommand *iCmd, CATNotification *iNotif); };// CmdCreateBase.cpp #include "CmdCreateBase.h" #include "CATCreateExternalObject.h" CATImplementCommand(CmdCreateBase, CATCommand, "CmdCreateBase"); CmdCreateBase::CmdCreateBase() : CATCommand("CmdCreateBase") { } CmdCreateBase::~CmdCreateBase() { } CATStatusChangeRC CmdCreateBase::Activate(CATCommand *iCmd, CATNotification *iNotif) { // 在这里通过CATISpecObjectFactory等接口创建Part和Pad return CATStatusChangeRCCompleted; } CATStatusChangeRC CmdCreateBase::Desactivate(CATCommand *iCmd, CATNotification *iNotif) { return CATStatusChangeRCCompleted; }CATDeclareCommand声明命令的消息映射，CATImplementCommand实现映射并注册命令字符串。Activate是命令被点击后进入的入口，Desactivate对应命令退出。实际创建特征的代码要经由CATISpecObjectFactory接口获取工厂，不同小版本略有差异，所以建议先做一个空命令跑通生命周期，再逐步加业务代码。这个先跑通骨架的习惯，能省掉大量调试时间。
5. CATIA二次开发避坑指南：五个真实踩坑记录
这些坑不是文档里写的，是我和A同学在项目里跑坏过模型后一条条记下来的。每条按现象、原因、解决三段写。
5.1 录制时一切正常，跑批时偶尔报错
现象：录制的宏单跑一次成功，循环跑一百个文件时第37个崩掉，报“对象未引用”或“操作不支持”。
原因：批处理时上一个文档没关闭，Part对象还在内存但文档已经失效；或者循环变量和某个全局命名冲突，等于中途换了个对象在操作。
解决：每次迭代先关文档再开新文档，关之前把要读写的对象引用全部置空；循环体内加On Error Resume Next配合状态判断，出现错误记录文件路径后继续跑下一个，而不是让整批任务停在半路。
5.2 草图尺寸和预期差一倍
现象：脚本里画了直径50的圆，打开模型发现半径50，整圆变成了半圆。
原因：CreateClosedCircle的第三位参数接收的是半径不是直径，我把直径当半径传了进去，接口语义理解错了。这个坑反复在项目里出现，和选型文档描述不清晰有关系。
解决：用宏录制一个手工画圆，把录制数值和传入数值做对比，确认当前版本API是直径还是半径，然后在代码注释里锁定这个结论，防止后面的人再犯。
5.3 单位之痛：毫米与米混用导致尺寸翻1000倍
现象：换了一台机器跑同一套脚本，圆柱从10毫米变成10米，整个模型直接乱掉。
原因：两台机器的CAD环境单位设置不同，脚本里Depth.Value直接填10，某些API在单位制改变后按米解释。这个属于环境相关，检查界面单位看不出问题，要查文档内部设置。
解决：脚本开头检查单位，通过UnitsService取当前配置，不是毫米就做换算或者直接改成毫米制。跑批前做一轮单位巡检，比事后补救模型省事太多。
5.4 用Selection做对象选择导致卡弹窗
现象：脚本跑到一半弹出对象选择器，整个自动化流程停在那里等人点，批量任务直接挂起。
原因：代码里残留了Selection.SelectElement调用，这是给交互命令用的，不是给自动化脚本用的。复制代码时没删干净，场景一错，脚本就从自动模式变成手动模式。
解决：删除所有交互选择调用，对象获取一律改成ByName或ByIndex匹配。写任何脚本前想清楚当前是跑批还是交互，两种情况下的代码结构完全不同。
5.5 升级版本后宏全部失效
现象：某台机器从V5旧发行版升到新发行版，脚本报找不到对象或接口错误。
原因：CATIA不同发行版对COM对象模型接口有微调，个别方法被废弃或改名，宏还指向旧接口。
解决：生产环境固定CATIA版本，脚本和版本一起锁版本。关键自动化逻辑建议用CAA封装，CAA二进制跟随版本发布，不在用户机器上依赖脚本解析。备用的后悔药是保留一台旧版本虚拟机做宏库迁移验证，升级前先在新环境跑一遍脚本集。
6. 从能跑到好用：把脚本封装成带输入面板的参数化小工具
6.1 用UserForm做参数输入的三个要素
把第3章的D和H接到一个UserForm上进行输入，核心要做好三件事：数值校验、单位标注、回车触发建模。数值校验是最基本的防线，输入的不是正数就坚决不往下走：
If IsNumeric(txtD.Text) And Val(txtD.Text) > 0 Then D = Val(txtD.Text) Else MsgBox "外径必须为正数", vbExclamation Exit Sub End If单位标注直接在标签里写mm，输入框旁边注明范围，避免用户填出不合常理的尺寸。回车触发建模可以在UserForm的KeyDown事件里判断按键码，让操作者不用摸鼠标就能跑完一轮参数调整。
6.2 错误日志与撤销保护
CATIA脚本操作没有原生Undo，这是我最大的教训。以前A同学直接跑脚本把一版模型尺寸改错，Ctrl+Z救不回来，最后只能从备份里翻。现在我习惯在脚本开头先提示保存副本，或者在写库操作前另存一份备份文件。日志也很关键，每处理一个文件往文本里写一行“时间、文件名、操作结果”，批量跑挂了能知道在第几个文件、为什么挂，不用对着黑匣子猜。
这几条习惯不是一开始就有的，都是跑完后蹲在现场一条条理出来的。希望你接手CATIA二次开发时，能少走一半这种弯路，希望帮到你。
本文还有配套的精品资源，点击获取
