简介：面向 CATIA 二次开发初学者与刚进入数字化制造方向的研究生，这份文档完整记录了 CAA、RADE 与 Visual Studio 2005 的安装及环境配置流程，帮助读者跨过专业软件部署这一入门门槛。资源包共 1 个 doc 文件，约 4.8MB，以图文混排方式组织内容，按 VS2005、CATIA V5R19、CAA、RADE 的安装顺序分章展开，并附有开发环境搭建的后续说明。教程对关键环节给出了具体提示，例如 CATIA 需装在盘符根目录、CAA 与 RADE 选择完全安装、破解文件与 JS0GROUP.dll 的替换位置、CATVBTLicenser 的注册操作等，配合截图便于对照排查。目前已有 5369 人学习，适合需要从零搭建 CAA 开发环境、减少反复试错成本的读者参考。
1. 装 CAA 之前，先把 VS2005 和 CATIA V5R19 的版本对齐
有个做数字化制造的同行，在实验室新配的机器上折腾 CATIA 二次开发，CATIA 装好了、CAA 也装完了，结果 VS2005 里死活打不开工作空间，报错信息翻来覆去就那几行，查了两天才发现是 CATIA 装在了带空格的路径下，CAA 的编译脚本解析路径时直接断在空格处。这类翻车在 CAA+RADE+VS 这套环境里太常见了，因为它不是装一个软件，而是四个东西按严格顺序咬合：VS2005 提供编译器和 IDE，CATIA V5R19 提供运行时和头文件，CAA 补上开发框架，RADE 负责把源码编译成 CATIA 能加载的模块。任何一环的路径、位数、版本对不上，后面全是玄学报错。这篇笔记面向刚接触 CATIA 二次开发、准备从零搭一套能编译能调试环境的人，把安装顺序、目录约定、注册步骤和验证方法一次讲清，照着走能少踩几个我踩过的坑。
2. 装前定盘：VS2005、CATIA V5R19、CAA、RADE 的版本与目录约定
这套环境最要命的一点是“版本锁死”。CAA 和 RADE 的版本必须跟 CATIA 主版本严格对应，V5R19 的 CAA 装到 V5R20 上，安装程序可能不拦你，但编译链接阶段会报一堆找不到符号的错误。所以动手之前先把四样东西的版本和位数确认清楚，比装到一半再返工省事得多。
2.1 四件套的版本对应关系
原料里明确的是 CATIA V5R19（SP0，32 位），配套 CAA 和 RADE 也必须是 V5R19 对应的发行版，VS2005 则是当年 CAA 官方支持的编译器版本。这里没有“装新不装旧”的余地，VS2008 之后的编译器 CAA 的 mkmk 构建系统不认，硬上会卡在编译参数不兼容上。我一般会先把下面这张对照表填好再动手：
| 组件 | 版本要求 | 位数 | 作用 |
|---|---|---|---|
| Visual Studio | 2005（含 MSDN） | 32 位 | 提供 C++ 编译器与 IDE |
| CATIA | V5R19 SP0 | 32 位 | 运行时宿主与头文件来源 |
| CAA | V5R19 对应发行版 | 32 位 | 二次开发框架与 API |
| RADE | V5R19 对应发行版 | 32 位 | 编译构建与快速开发环境 |
位数这一列别忽略。32 位的 CATIA 配 64 位的 RADE，安装能过，但 CATVBTLicenser 注册那一步会静默失败，后面 VS 里打开工作空间直接提示找不到工具级别。整套环境统一 32 位是最稳的组合。
2.2 目录规划：为什么都要求装在盘符根目录
原料里反复强调“安装目录为本地盘符的根目录”，这不是洁癖。CAA 的构建脚本里大量使用固定层级的相对路径去定位intel_a\code\bin这类目录，路径里一旦出现空格或中文，脚本解析就会断。所以我的习惯是提前把目录规划好，装的时候直接照填：
D:\catia_v5r19 CATIA 主目录（CAA 也装进这里） D:\RADE RADE 主目录，与 CATIA 平级 D:\CAAWorkspaceR19 工作空间，自己新建三个目录都在根下、平级、纯英文无空格。工作空间单独放，不要塞进 CATIA 目录里，后面复制CAASystem.edu和切换工程时不容易乱。装之前顺手把 DAEMON Tools Lite 也装上，CATIA 和 CAA 的安装介质都是 iso，需要虚拟光驱挂载。
提示：装之前确认 D 盘剩余空间足够，CATIA 完全安装加上 CAA 的两张盘，占用不小，中途空间不足导致安装中断，清理起来比重装还麻烦。
3. 按顺序装：VS2005、CATIA V5R19、CAA、RADE 的落地步骤
顺序不能乱：先 VS2005，再 CATIA，然后 CAA，最后 RADE。原因是 CAA 要装进 CATIA 目录、依赖 CATIA 已就位，RADE 注册时又要从 CATIA 的 bin 目录取 DLL。跳步装的结果通常是某个注册环节找不到依赖文件。
3.1 VS2005 安装：组件勾选与 MSDN
VS2005 安装本身不复杂，关键是组件别漏。安装向导里 VB、.NET、C#、C++ 这几项里，.NET、C#、C++ 是必须的，CAA 的示例工程和构建脚本会用到 C++ 编译器，部分工具链依赖 .NET。MSDN 帮助文档也建议一起装，后面查 CAA API 的时候离线文档比在线搜靠谱。
安装路径同样避开空格和中文，默认路径即可。装完先别急着开 CATIA，确认 VS2005 能正常启动、新建一个空的 C++ 控制台工程能编译通过，说明编译器链路是通的，再往下走。
3.2 CATIA V5R19 安装：根目录、完全安装与破解文件位置
用 DAEMON Tools Lite 挂载Catia.v5.r19.iso，运行安装程序。几个关键选择按下面来：
- 安装目录填
D:\catia_v5r19，目录不存在时选新建； - 环境目录用默认，提示不存在时选新建；
- 安装类型选“完全安装”，不要自定义裁剪；
- 联机文档那一步选不安装，省时间也省空间。
装完之后 CATIA 还不能启动，需要先处理破解文件。把catia_v5r19sp0_x32_crk.exe复制到D:\catia_v5r19\intel_a\code\bin下执行，点 Start 完成。这一步的本质是替换授权校验相关的二进制，位置必须精确到intel_a\code\bin，放错目录执行了也没效果。
# 破解文件必须落在 CATIA 的 bin 目录下再执行 copy catia_v5r19sp0_x32_crk.exe D:\catia_v5r19\intel_a\code\bin\ # 进入目录后双击执行，点 Start执行完试着启动一次 CATIA，能进主界面说明宿主环境没问题。如果启动报授权错误，回头检查破解文件是不是复制到了正确的 bin 目录、是否以管理员身份执行。
3.3 CAA 安装：装进 CATIA 目录与第二张盘切换
CAA 的安装目录要选 CATIA 的安装目录，也就是D:\catia_v5r19，不要另起炉灶。安装类型选完全安装。过程中会提示插入第二张盘，这时把 CAA 的第二张 iso 挂到虚拟光驱，点确定继续，安装程序会自己从新挂载的盘符读文件。
装完 CAA 之后还有一步容易漏：把include.rar解压到D:\catia_v5r19。这个包补的是头文件，不解压的话后面编译示例工程会报找不到头文件。解压后确认D:\catia_v5r19下多出对应的 include 目录结构。
3.4 RADE 安装与注册：替换文件、拷 DLL、跑 Licenser
RADE 装在D:\RADE，与 CATIA 平级，同样选完全安装，环境目录用默认、不存在就新建。装完之后的注册是整套环境里最容易出错的一步，按顺序做：
# 1. 解压 RADE 破解文件，替换 bin 目录下的同名文件 # LaunchCommandControl.exe / mkmkM.exe / mkstepM.exe / ReleaseServer.exe copy LaunchCommandControl.exe D:\RADE\intel_a\code\bin\ copy mkmkM.exe D:\RADE\intel_a\code\bin\ copy mkstepM.exe D:\RADE\intel_a\code\bin\ copy ReleaseServer.exe D:\RADE\intel_a\code\bin\ # 2. 从 CATIA 的 bin 目录拷 JS0GROUP.dll 到 RADE 的 bin 目录并替换 copy D:\catia_v5r19\intel_a\code\bin\JS0GROUP.dll D:\RADE\intel_a\code\bin\替换完运行D:\RADE\intel_a\code\bin\CATVBTLicenser.exe，界面里把右侧所有选项勾上，点 Apply。正确的话会弹出成功提示。如果 Apply 之后没反应或者报错，八成是上一步的JS0GROUP.dll没替换成功，或者 RADE 装成了 64 位而 CATIA 是 32 位，DLL 位数不匹配加载失败。
注意：替换文件前先把原文件备份一份，注册失败想回退时不用重装 RADE。
4. 搭开发环境：CATVBTSetup、工作空间与 VS2005 工程打开
软件装齐只是半成品，真正让 VS2005 能认 CAA 工程的是接下来这几步配置。这一步做对了，后面新建工程、编译、调试才顺。
4.1 CATVBTSetup 的两个路径
运行D:\RADE\intel_a\code\bin\CATVBTSetup.exe，忽略启动时的提示。两个路径要填准：
- Target 下的 Installation Directory 选 CATIA 安装目录
D:\catia_v5r19； - Documentation 下的 Documentation installation Path 设为
D:\catia_v5r19\CAADoc\Doc。
填完点 OK，出现验证消息再点 OK。这两个路径的作用是告诉 RADE 去哪里找 CATIA 的运行时和文档，填错会导致 VS 里打开工作空间后工具级别识别不出来。
4.2 建工作空间并复制 CAASystem.edu
在 CATIA 安装目录下新建CAAWorkspaceR19，然后把CAADoc下的CAASystem.edu整个文件夹复制进去。这个 edu 目录是 CAA 自带的教学工程，用它来验证环境是否配通最直接。
D:\catia_v5r19\CAAWorkspaceR19\ └── CAASystem.edu\ <- 从 D:\catia_v5r19\CAADoc\ 复制过来4.3 VS2005 打开 CAA 工作空间与前置工作空间定位
打开 VS2005，文件菜单选 Open CAA V5 Workspace，With 后面选 MkmkWorkspace，Directory 选D:\catia_v5r19\CAAWorkspaceR19，Tool level 选V5R19_B19，点 OK。中途的警告和“工作空间里无工程”提示都点确定，展开树形结构后选CAASysCallBack.m打开。
接着在 CAAV5Workspace 菜单下点 Locate Prerequisite Workspaces，Mode 选 Access prerequisites from their origin location，Origin for prerequisite Frameworks 里点 Add，选 CATIA 的安装目录。这一步是把 CATIA 自带的框架注册为前置依赖，不做的话编译时会报找不到基础框架。
CAAV5Workspace -> Locate Prerequisite Workspaces Mode: Access prerequisites from their origin location Origin for prerequisite Frameworks: Add -> D:\catia_v5r19配置完成后，解决方案里应该能看到 CAASystem 相关的工程节点。到这一步，环境搭建的主体就完成了，剩下的是验证和排错。
5. 避坑排查：CAA+RADE 环境里最常见的五个翻车点
这套环境的报错大多不直白，现象和根因隔得远。下面五条是我和同行实际撞过的，按“现象 → 原因 → 解决”记下来，遇到时对照着查。
5.1 VS2005 打开工作空间报找不到工具级别
现象：Open CAA V5 Workspace 时 Tool level 下拉里没有V5R19_B19，或者选了之后报错。原因通常是 CATVBTSetup 里的 Installation Directory 没指向 CATIA 目录，RADE 不知道去哪读工具级别定义。解决：重跑 CATVBTSetup，把 Target 路径改成D:\catia_v5r19，确认后重启 VS2005 再打开。
5.2 CATVBTLicenser 点 Apply 无反应
现象：勾选所有选项点 Apply，没有成功提示，或者一闪而过。原因多为JS0GROUP.dll没从 CATIA 的 bin 目录正确替换到 RADE 的 bin 目录，或者两边位数不一致。解决：重新从D:\catia_v5r19\intel_a\code\bin复制JS0GROUP.dll覆盖到D:\RADE\intel_a\code\bin，确认两个目录都是 32 位版本后重跑 Licenser。
5.3 编译示例工程报找不到头文件
现象：打开 CAASysCallBack.m 后编译，报一堆 include 找不到。原因是include.rar没解压到 CATIA 目录，或者解压位置不对。解决：把include.rar解压到D:\catia_v5r19，确认解压后 include 目录与intel_a平级，再重新编译。
5.4 路径带空格导致构建脚本中断
现象：安装时图省事把 CATIA 装到了D:\Program Files\catia这类带空格的路径，编译时 mkmk 报路径解析错误。原因是构建脚本对空格处理不健壮。解决：卸载重装到D:\catia_v5r19这种根目录纯英文路径，RADE 和工作空间同理，别抱侥幸。
5.5 前置工作空间没定位导致链接失败
现象：编译能过，链接阶段报找不到框架符号。原因是 Locate Prerequisite Workspaces 没做，或者 Origin 路径加错了。解决：回到 CAAV5Workspace 菜单重新定位，Origin 里 Add 的必须是 CATIA 安装根目录D:\catia_v5r19，不是它的子目录。
6. 装完怎么验证：用 CAASystem 示例工程跑通一次编译
环境装没装好，不看安装程序有没有报错，看示例工程能不能编译通过。我验证这套环境的固定动作是拿CAASystem.edu走一遍完整构建，因为它覆盖了头文件引用、框架依赖、链接器配置这几条最容易出问题的链路。
具体做法：VS2005 里打开CAAWorkspaceR19工作空间，展开到CAASysCallBack.m，右键选择构建（或按构建快捷键），观察输出窗口。判断标准分三层：
| 验证层级 | 通过标准 | 不通过时先查 |
|---|---|---|
| 预处理 | 无 include 找不到 | include.rar 是否解压到 CATIA 目录 |
| 编译 | 无语法与类型错误 | Tool level 是否为 V5R19_B19 |
| 链接 | 无未解析外部符号 | 前置工作空间是否定位到 CATIA 根目录 |
三层都过，说明 VS2005 的编译器、CAA 的头文件、RADE 的构建脚本、CATIA 的框架依赖全部咬合上了。这时候再启动 CATIA，确认能正常进入，整个环境就算真正跑通。如果链接层报错，重点回看第 5.5 条，前置工作空间的 Origin 路径错一级就会链接失败，这个坑我见过不止一次。
还有个小技巧：构建成功后别急着关 VS2005，把输出窗口的完整日志留一份。以后换机器重装时，拿这份日志对照，哪一步的警告多了、少了，一眼能看出来环境是不是装歪了。日志里如果出现路径相关的 warning，哪怕构建过了也值得看一眼，往往是路径规划埋的雷。
从那以后我每次重装这套环境，都强制自己先跑一遍 CAASystem 的构建再动别的工程，构建日志不干净就不往下走。这套环境的坑大多藏在路径和注册环节，早验证早暴露，比写到一半再回头查省太多时间。希望帮到你。
本文还有配套的精品资源，点击获取
的行为与内存分配机制)
