OCCT 实战（3）Windows下OCCT与Qt集成开发环境搭建

最新推荐文章于 2026-06-16 21:16:49 发布

原创

最新推荐文章于 2026-06-16 21:16:49 发布 · 1.1k 阅读

1. 为什么要在Windows上集成OCCT与Qt？

如果你已经按照上一篇文章《OCCT 实战（2）Windows平台编译OCCT》的步骤，成功在Windows上把OCCT编译出来了，那么恭喜你，你已经拿到了一个强大的“3D建模引擎”。但光有引擎还不够，你还需要一个“驾驶舱”来操作它、观察它。这个驾驶舱，就是图形用户界面（GUI）。

想象一下，你造了一台性能强悍的汽车发动机（OCCT），但如果没有方向盘、仪表盘和车窗（GUI），你既没法控制它，也看不到它跑起来的样子。在Windows桌面开发领域，Qt 就是打造这个“驾驶舱”最流行、最强大的工具包之一。它提供了丰富的控件、成熟的信号槽机制，以及对OpenGL的完美支持，天生就适合用来做3D可视化应用。

所以，把OCCT和Qt集成在一起，目标非常明确：用Qt来构建一个美观、易用的Windows应用程序窗口，然后把OCCT强大的3D建模和渲染能力，像嵌入一块画布一样，放到这个窗口里。 这样，你就能通过按钮、菜单来创建模型，在Qt的OpenGL控件里实时旋转、缩放、查看你的3D设计。无论是做CAD原型系统、3D打印切片软件，还是简单的几何查看器，这个组合都是绝佳起点。

我刚开始接触这个组合时，也踩过不少坑，比如环境变量没设对导致程序崩溃，或者链接库时版本不匹配。但一旦打通，你会发现开发效率提升巨大。接下来，我就带你一步步搭建这个集成开发环境，我会把每个环节的细节和容易出错的地方都讲清楚，让你少走弯路。

2. 环境准备：查漏补缺，确保工具链完整

在开始集成之前，我们需要确保所有必要的“零件”都已备齐。如果你已经完成了OCCT的编译，那么大部分工具已经有了，但我们还需要为Qt集成做一些特别的检查和准备。

2.1 核心工具清单与版本确认

首先，打开你的命令行或者PowerShell，逐个检查以下工具的版本和安装情况。版本兼容性是成功的关键，我强烈建议使用以下组合，这是经过大量项目验证的稳定搭配：

Visual Studio：推荐使用 VS2019 或 VS2022。请确保安装时勾选了“使用C++的桌面开发”工作负载。检查方法：打开“开发者命令提示符”，输入 cl，应该能看到编译器版本信息。
CMake：版本需要 ≥ 3.16。安装时务必勾选“Add CMake to the system PATH for all users”。检查命令：cmake --version。
Qt：这是新加入的关键角色。请到Qt官网下载在线安装器，安装 Qt 5.15.2 LTS 或更高版本（如5.15.8）。特别注意：在安装组件时，必须选择与你Visual Studio版本匹配的MSVC套件。例如，如果你用VS2019，就选择 msvc2019_64；用VS2022，就选择 msvc2022_64。同时，建议勾选 Qt Creator（一个优秀的Qt集成开发环境）和 Qt Charts 等你可能用到的模块。
OCCT及其第三方库：假设你已经按照上一篇文章编译并安装好了OCCT。请记住你的OCCT安装路径（例如 D:\Libs\OCCT-7.8.0-install）和第三方库的路径（例如 D:\Libs\OCCT-7.8.0\3rdparty）。确保这些路径没有中文或特殊字符。

2.2 配置系统环境变量（关键步骤）

为了让CMake和你的项目能顺利找到Qt，我们需要设置一个重要的环境变量：Qt5_DIR（如果你用Qt6则是Qt6_DIR）。这个变量指向Qt安装目录下对应编译器版本的 lib/cmake/Qt5 文件夹。

找到你的Qt5_DIR路径：它通常形如 C:\Qt\5.15.2\msvc2019_64\lib\cmake\Qt5。请根据你的实际安装路径调整。
设置系统环境变量：
- 在Windows搜索栏输入“环境变量”，选择“编辑系统环境变量”。
- 点击“环境变量”。
- 在“系统变量”部分，点击“新建”。
- 变量名：Qt5_DIR
- 变量值：你的Qt5 CMake路径（例如 C:\Qt\5.15.2\msvc2019_64\lib\cmake\Qt5）。
- 一路点击“确定”保存。