简介：这份文档面向 CATIA 二次开发初学者与刚进入数字化制造方向的研究生，聚焦 CAA、RADE 与 Visual Studio 2005 的环境搭建难题，帮助读者绕开专业软件安装与配置中反复踩坑的阶段。资源包内仅含 1 个 doc 文档，体积约 4.8MB，以图文混排方式记录完整配置流程，便于边看边对照操作。目前已有 5369 人学习，说明该入门环节的需求较为普遍。内容覆盖 VS2005 组件与 MSDN 安装、CATIA V5R19 借助虚拟光驱安装及破解、CAA 完全安装与第二张光盘切换、RADE 安装注册与许可配置，并延伸到开发环境搭建中的 Target 与 Documentation 设置。作者结合近三个月摸索经验，把每一步的界面截图与文字说明对应起来，对目录选择、破解文件替换、环境变量等易错点给出明确指引，适合作为入门阶段的手把手配置手册与排错参考。
1. 从一台装了三天的机器说起：CAA+RADE+VS 这套环境到底卡在哪
如果你在搜索框里敲过“CATIA 二次开发环境配置”，大概率已经经历过一次失败：VS 装好了，CATIA 也跑起来了，但打开工作空间那一刻，菜单是灰的，编译按钮点不动，或者干脆在Locate Prerequisite Workspaces里找不到 CATIA 的 framework。这套 CAA + RADE + VS 的组合，难点从来不在某一步安装，而在四者之间的目录约定、版本对齐和注册顺序。这份资料是一份完整的 CATIA 二次开发环境搭建实录，覆盖 VS2005、CATIA V5R19、CAA、RADE 的安装顺序、破解替换、注册机操作，以及 VS 里打开 CAA 工作空间、挂接 Prerequisite 的全流程。它适合刚接触 CAA 的在校研究者、做数字化制造方向的工程人员，以及需要维护老版本 CATIA 插件代码的从业者。下面按我实际复现的顺序拆开讲，重点放在每一步为什么这么做、参数怎么填、失败时看哪里。
2. 安装顺序与目录约定：为什么 CATIA 必须装在盘符根目录
2.1 四件套的依赖关系与安装次序
这套环境的安装不是随便排的，顺序错了后面全是返工。正确的次序是：VS2005 → CATIA V5R19 → CAA → RADE。原因在于 CAA 安装时要往 CATIA 的安装目录里写文件，RADE 安装时又要读取 CATIA 的intel_a\code\bin下的动态库，并且 RADE 的注册机依赖 CATIA 的JS0GROUP.dll。如果先装 RADE 再装 CATIA，RADE 找不到目标路径，注册那一步会直接失败。
VS2005 放最前面，是因为 CAA 的工程模板和mkmk构建系统在安装阶段会去探测 VS 的安装路径，虽然探测失败也能装完，但后面在 VS 里打开工作空间时会出现工具链缺失的报错。安装 VS2005 时有两个必选项：.NET、C#、C++ 三项要勾上，MSDN 帮助文档也要装。CAA 的 API 文档量很大，没有本地 MSDN，后面查函数签名会非常痛苦。
CATIA 的安装目录有一个硬性约定：必须放在本地盘符的根目录下，比如D:\catia_v5r19。这不是习惯问题，而是 CAA 和 RADE 的构建脚本里对路径深度有假设，装到D:\Program Files\...这种带空格的深层目录，mkmk解析路径时容易断在空格上。同理，RADE 也要装在根目录，且与 CATIA 平级，比如D:\RADE。
2.2 CATIA 安装中的目录新建与破解替换
用虚拟光驱加载 CATIA 的 iso 后，安装向导走到目录选择那一步，如果目标文件夹不存在，向导会提示“目录不存在”，此时选“是”让它新建。环境目录保持默认即可，同样遇到不存在就新建。安装类型选“完全安装”，联机文档那一步选不安装，省时间也省空间。
安装完成后 CATIA 还不能启动，需要先做文件替换。把破解文件复制到 CATIA 的 bin 目录下执行：
# 将破解程序复制到 CATIA 的代码目录并执行 copy catia_v5r19sp0_x32_crk.exe D:\catia_v5r19\intel_a\code\bin\ cd /d D:\catia_v5r19\intel_a\code\bin catia_v5r19sp0_x32_crk.exe这里的逻辑是：破解程序必须和 CATIA 的主可执行文件处于同一目录，它运行时按相对路径定位需要打补丁的二进制文件。执行后点 Start，等进度走完再启动 CATIA 验证能否正常打开。这一步没做就去装 CAA，CAA 安装程序检测不到有效的 CATIA 授权，会在中途报错退出。
提示：破解文件是 32 位版本，对应的是 x32 的 CATIA。如果你拿到的是 64 位安装包，这个文件不适用，需要找对应位数的版本，否则执行后 CATIA 依然打不开。
2.3 CAA 安装：目录指向 CATIA 与第二张盘的切换
CAA 的安装目录要选在 CATIA 的安装目录里面，也就是D:\catia_v5r19下，安装类型选完全安装。安装过程中会提示插入第二张盘，此时把 CAA 的第二张光盘映像载入虚拟光驱，点确定继续。装完后还有一步容易漏：把include.rar解压到D:\catia_v5r19目录下。这个包是 CAA 的头文件集合，不解压的话后面编译时会报找不到CATIAApplicationFrame.h之类的头文件。
2.4 RADE 安装与注册机的正确用法
RADE 装在盘符根目录，与 CATIA 平级，比如D:\RADE。目录不存在就新建，标识按安装程序要求输入，环境目录用默认值。完全安装，一路下一步到完成。
RADE 装完必须注册，否则 VS 里打开工作空间时mkmk工具链不可用。注册分三步，顺序不能乱：
# 第一步：替换 RADE 的四个可执行文件 # 将破解包解压出的以下文件复制到 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\ # 第二步：把 CATIA 的 JS0GROUP.dll 复制到 RADE 的 bin 目录并替换 copy D:\catia_v5r19\intel_a\code\bin\JS0GROUP.dll D:\RADE\intel_a\code\bin\ # 第三步：运行注册机 cd /d D:\RADE\intel_a\code\bin CATVBTLicenser.exe第二步的JS0GROUP.dll替换是关键。RADE 自带的这个库版本和 CATIA 的不一致，不替换的话注册机能跑但授权写不进去，表现为点 Apply 后没有成功提示。第三步运行CATVBTLicenser.exe，界面出来后选中右侧所有选项，点 Apply，看到正确提示才算完成。
3. 在 VS2005 里打开 CAA 工作空间：从 CAASystem.edu 到 Prerequisite 挂接
3.1 运行 CATVBTSetup 与工作空间目录的建立
RADE 注册完成后，先运行D:\RADE\intel_a\code\bin下的CATVBTSetup.exe。这个工具负责把 CAA 的 VS 集成组件注册到 VS2005 里，运行时会弹提示，忽略即可。Target 选项下的 Installation Directory 选 CATIA 的安装目录，Documentation 选项下的路径设为D:\catia_v5r19\CAADoc\Doc，点 OK 完成。
接着在 CATIA 安装目录下新建工作空间文件夹，比如CAAWorkspaceR19。然后把CAADoc下的CAASystem.edu整个文件夹复制到工作空间里。这个 edu 目录是 CAA 自带的示例工程，用它来验证环境是否配通最直接，不用自己从零建工程。
3.2 Open CAA V5 Workspace 的参数填写
打开 VS2005，走文件菜单里的Open CAA V5 Workspace。对话框里 With 后面选MkmkWorkspace，Directory 选刚才建的工作空间路径，Tool level 选V5R19_B19。点 OK 后会弹一个警告，继续点 OK；再提示工作空间里无工程，点确定。然后展开树形结构，选中CAASysCallBack.m，点 OK，解决方案资源管理器里就会出现工程结构。
这一步常见的翻车是 Tool level 选错。V5R19_B19里的 B19 对应 CATIA 的 build 号，选成别的版本，后面编译时mkmk会报工具链不匹配。如果你不确定自己的 CATIA 是哪个 build，去 CATIA 的安装目录看版本信息文件，别凭记忆填。
3.3 Locate Prerequisite Workspaces 的路径配置
工程打开后，菜单栏会出现 CAAV5Workspace 菜单。点Locate Prerequisite Workspaces...，Mode 选Access prerequisites from their origin location，然后在 Origin for prerequisite Frameworks 里点 Add，选 CATIA 的安装文件夹路径，点 OK。配置正确的话，界面会列出 CATIA 自带的各个 framework，说明 VS 已经能找到 CAA 的 API 库了。
配置项 填写值 Mode Access prerequisites from their origin location Origin for prerequisite D:\catia_v5r19 Tool level V5R19_B19 Workspace Directory D:\catia_v5r19\CAAWorkspaceR19 Documentation Path D:\catia_v5r19\CAADoc\Doc这张表建议对着填一遍，尤其是 Origin 路径，必须指向 CATIA 安装根目录而不是intel_a子目录。指错了，Prerequisite 列表是空的，编译时链接阶段会报一堆 unresolved external。
4. 避坑与排查：这套环境最容易翻车的五个地方
4.1 现象：CATIA 装完打不开，双击无反应
原因：破解文件没执行，或者执行的破解文件位数与安装包不匹配。32 位的破解程序对 64 位 CATIA 无效，执行后看似成功，实际补丁没打上。
解决：确认安装包位数，找对应位数的破解文件，复制到intel_a\code\bin下重新执行。执行时用管理员权限运行，避免写文件被拦截。
4.2 现象：RADE 注册机点 Apply 后没有成功提示
原因：JS0GROUP.dll没有从 CATIA 的 bin 目录复制过来替换，或者复制了但版本不对。RADE 注册机写授权时依赖这个库的导出函数，版本不匹配会静默失败。
解决：重新从D:\catia_v5r19\intel_a\code\bin复制JS0GROUP.dll到D:\RADE\intel_a\code\bin覆盖，再跑一次CATVBTLicenser.exe。覆盖前先把 RADE 原来的文件备份一份，方便回退。
4.3 现象：VS 里 Open CAA V5 Workspace 后菜单是灰的
原因：CATVBTSetup.exe没运行，或者运行了但 Installation Directory 指错了。VS 的 CAA 插件靠这个工具注册，注册信息里的路径不对，菜单项就不会激活。
解决：重新运行CATVBTSetup.exe，Target 的 Installation Directory 严格选 CATIA 安装根目录，Documentation 路径选到CAADoc\Doc，完成后重启 VS2005。
4.4 现象：编译时报找不到头文件
原因：include.rar没有解压到 CATIA 安装目录，或者解压到了错误的层级。CAA 的头文件搜索路径是相对 CATIA 根目录配置的，解压位置差一层就找不到。
解决：确认D:\catia_v5r19下存在 include 目录，且目录里直接是头文件而不是多套了一层文件夹。如果多套了一层，把头文件挪上来。
4.5 现象：Prerequisite 列表为空，链接报 unresolved external
原因：Locate Prerequisite Workspaces里的 Origin 路径指到了intel_a或code\bin子目录，而不是 CATIA 安装根目录。
解决：重新打开该对话框，把 Origin 改成D:\catia_v5r19，点 OK 后等列表刷新。刷新不出来就关掉 VS 重开，让插件重新扫描。
5. 环境验证与工程固化：用 CAASystem.edu 跑通第一次编译
环境配完不能只看菜单亮不亮，得实际编译一次才算数。我一般拿CAASystem.edu这个自带示例做验证，因为它不依赖额外代码，编译链路走通就说明工具链、头文件路径、Prerequisite 挂接三件事都对了。
验证步骤是这样的：在 VS 里打开CAASysCallBack.m后，先别急着 Build，去 CAAV5Workspace 菜单下确认 Prerequisite 已经列出 CATIA 的 framework。然后选 Build 菜单里的Build Solution，观察输出窗口。正常情况会看到mkmk依次编译各个 module，最后提示 0 error。如果中途报错，重点看两类信息：一类是Cannot open include file，回去查 include 目录；另一类是unresolved external symbol，回去查 Prerequisite 路径。
编译通过后，还有一步验证是运行。CAA 的工程运行需要在 CATIA 环境里加载编译出的 DLL，具体做法是把生成的win_b64或intel_a下的输出目录加到 CATIA 的环境变量里，然后启动 CATIA 看命令是否注册成功。这一步因工程类型不同差异较大，示例工程主要是验证编译链路，运行验证可以放到自己建工程时再做。
验证检查点 通过标准 Prerequisite 列表 能看到 CATIA 自带的 framework 条目 Build Solution 输出 0 error，mkmk 正常走完各 module include 目录 D:\catia_v5r19\include 下直接是 .h 文件 Tool level V5R19_B19 与 CATIA build 号一致有一个习惯我后来一直保持：每配好一台机器，就把工作空间目录、Prerequisite 路径、Tool level 这三项记在一个文本文件里放在工作空间根目录。原因是这套环境一旦换机器或者重装，参数很容易记混，尤其是 Tool level 的 build 号，凭记忆填十次错三次。另一个经验是，所有替换过的 DLL 和 exe 都留一份原始备份在单独的backup文件夹，出问题能快速回退，不用重装整个 CATIA。这套环境老、步骤碎，但把目录约定和替换顺序守住，复现并不难。希望帮到你。
本文还有配套的精品资源，点击获取
