OGRE 1.7.3 与 VS2010 环境配置：从 SDK 编译到链接排错

简介面向初学3D图形渲染与游戏开发的Ogre引擎使用者这份docx文档围绕在Visual Studio 2010下完成Ogre SDK安装、环境变量与Boost库配置、示例程序编译验证以及新建项目后的属性页设置展开适合需要从零搭建Ogre开发环境、理清编译链接与调试配置关系的学习者。压缩包仅含1个docx文件约67KB篇幅集中、便于随查随用。已有141人学习说明其配置路径对入门者具有一定参考价值。文档把准备工作、SDK生成、依赖库区分Debug与Release、附加包含目录与库目录、后期生成事件等关键环节串成完整流程并保留了运行示例浏览器验证与选择Direct3D9渲染子系统的判断依据可帮助读者减少环境搭建中的反复试错也便于按项目需求调整配置、补充库文件或排查链接错误。1. 环境没对齐OGRE 1.7.3 只认 VS2010 的 v100 工具集配置 Ogre 引擎最容易踩的坑不在引擎本身而在版本链条OGRE 1.7.3 的 SDK 包名叫OgreSDK_vc10_v1-7-3.exevc10就是 Visual Studio 2010 的编译器代号配套的平台工具集是 v100。拿 VS2015 以上的 IDE 打开Ogre.sln第一步弹「平台工具集 v100 未安装」硬着头皮往里走TutorialFramework 里那套字符串转换又跟着报一串错。我见过的现场里SamplesBrowser.exe双击能开、样例场景也转得动可自己新建的工程一编译十几条 LNK2019——这并不矛盾SDK 装好了是一件事工程配好了是另一件事。这套组合在课程设计、老教材配套工程和一些维护中的老项目里依然常见装不好不是引擎难用是 DirectX 9 运行时、OGRE_HOME的值、boost_1_44 的位置、属性页里那几个路径任何一环错位都会在链接阶段翻车。下面按能真正跑通的顺序走一遍从三个安装包落地开始。2. 准备工作SDK 解压、DirectX 9 与 VS2010 三件套落地先把东西备齐再动手。这一章里的三个包缺一个后面都会以「报错」的形式提醒你区别只是错在链接期还是运行期。2.1 把 OgreSDK_vc10_v1-7-3.exe 解到 D:\Ogre这个 exe 不是常规安装程序是自解压包双击后它只问一句解压到哪个目录。填D:\Ogre等进度条走完。目录里会多出一层OgreSDK_vc10_v1-7-3真正的 SDK 根目录是D:\Ogre\OgreSDK_vc10_v1-7-3后面环境变量、附加包含目录、附加库目录全部以它为基准多一层少一层都对不上。D: cd \Ogre dir第一行切到 D 盘第二行进入 Ogre 目录第三行列目录。输出里应该能看到OgreSDK_vc10_v1-7-3这个文件夹进去之后是下面这些内容目录/文件里面是什么后面用在哪Bin编好的可执行文件与 dll调试命令、后期生成事件的落点includeOgre、OIS 的头文件C/C 附加包含目录libDebug/Release 两套静态库链接器附加库目录Samples样例工程与 TutorialFramework建立模板工程时取文件boost_1_44boost 1.44 的头文件与库附加包含目录最后一项Ogre.sln整个 SDK 的解决方案接下来要生成的那一个路径选择上有两条硬规矩。第一别解到C:\Program Files下面带空格的路径会在属性页和后期生成事件里反复加引号稍不留神就是「命令退出代码 1」。第二别用中文目录OGRE 1.7.3 这代工具链对非 ASCII 路径的处理谈不上稳编译到一半报个莫名的编码错误查起来全是玄学。提示解压完先别改OgreSDK_vc10_v1-7-3这个名字环境变量里写的值要和它一字不差改一次名后面要跟着改一串地方。2.2 DirectX 9 与 D3DX9_43.dll 的两个落点把d3dx9_43 (1).rar解压出来先跑里面的 DirectX 9 安装程序DirectX End-User Runtime2010 年 6 月那一版走完默认流程。装完再把D3DX9_43.dll拷进系统目录。copy D:\dx9\d3dx9_43.dll %SystemRoot%\System32\ copy D:\dx9\d3dx9_43.dll %SystemRoot%\SysWOW64\第一条给 32 位系统用也是原文档里写的那一步。第二条是给 64 位系统上的 32 位进程用的64 位 Windows 有个文件系统重定向32 位程序去访问System32时实际被转到SysWOW64只往System32里丢一份结果是 32 位程序照样报「找不到 d3dx9_43.dll」。VS2010 本身和 OGRE 1.7.3 的样例都是 32 位进程所以两个目录都得有。%SystemRoot%一般就是C:\Windows写成变量比写死路径省事。为什么非要装 DirectX 9而不是系统里已经有 DirectX 11 就够了OGRE 1.7.3 的 Direct3D9 渲染插件依赖d3dx9_43.dll这个辅助库它只随 DirectX 9 的运行时一起分发新的 DirectX 运行库不包含它。这一步跳过SamplesBrowser.exe双击就是一闪而过或者弹个缺 dll 的框。注意往System32和SysWOW64里写文件要管理员权限用管理员身份开命令行窗口别在普通 cmd 里硬拷。2.3 VS2010 能不能干活先花两分钟自检打开 VS2010帮助 → 关于确认版本号是 10.0。有没有 SP1 不影响这套流程但 C 组件必须是装上的——VS2010 安装时可以不勾 Visual C那种情况下连 v100 工具集都没有后面打开Ogre.sln会直接告诉你项目类型不受支持。然后新建一个 Win32 控制台空项目随便写个int main(){return 0;}编译运行一次。这一步看着多余实际是省时间生成整个Ogre.sln要等很久如果 VS 本身有问题等于白等一轮。项目属性里顺手看一眼「配置属性 → 常规 → 平台工具集」应该是v100如果这里是灰的或者显示v90、v110说明装的不是 2010 版的编译器。还有一个顺序问题容易被忽略VS2010 是在进程启动时读取环境变量的。如果你先开着 VS再去加OGRE_HOME那个 IDE 里所有$(OGRE_HOME)都会展开成空字符串路径变成\include报错信息看着像路径写错其实只是没重启。稳妥做法是环境变量设完再开 VS中途改过变量就关掉重开。3. 环境变量与 SDK 编译OGRE_HOME、boost_1_44 和那一次长编译这一章是整个安装里最耗时间的一段Ogre.sln生成一次十几分钟很正常所以每个前置条件都要在点「生成」之前确认掉。3.1 OGRE_HOME 的值要指到 SDK 根目录图形界面路径是右击「计算机」→ 属性 → 高级系统设置 → 环境变量 → 用户变量里新建。变量名OGRE_HOME变量值D:\Ogre\OgreSDK_vc10_v1-7-3。习惯用命令行的可以这样setx OGRE_HOME D:\Ogre\OgreSDK_vc10_v1-7-3setx写的是用户变量写入注册表只对之后新开的进程生效当前这个 cmd 窗口读不到已经在跑的 VS2010 更读不到。所以执行完关掉所有 IDE 和命令行重新开一个窗口验证echo %OGRE_HOME% dir %OGRE_HOME%\include\Ogre.h第一条回显变量值第二条去头文件目录里找Ogre.h。两条都正常说明变量指对了如果第二条提示找不到文件八成是值里少了OgreSDK_vc10_v1-7-3这一层指到了D:\Ogre。值末尾不要加反斜杠。虽然 Windows 大多时候能容忍\\但拼出来的$(OGRE_HOME)\include在属性页里显示成双斜杠排查时容易让人怀疑人生。用用户变量还是系统变量都行用户变量作用范围小一点出问题也好删。提示改完变量用echo验证这一步别省。后面所有路径都靠这个变量展开它错了属性页里看着完全正确的配置也会全线失效。3.2 boost_1_44 的两处落点原文档要求在C:\Program下建一个 boost 文件夹把 SDK 里的boost1_44拷过去。这一步看着多余——SDK 目录里本来就躺着一份——但Ogre.sln里有工程的附加包含目录是写死的绝对路径指向C:\Program Files\boost\boost_1_44少了这份拷贝生成到那几个工程时就会报找不到 boost 头文件。mkdir C:\Program Files\boost xcopy /E /I D:\Ogre\OgreSDK_vc10_v1-7-3\boost_1_44 D:\Ogre\OgreSDK_vc10_v1-7-3\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\..\.. C:\Program Files\boost\boost_1_44上面这条命令写坏了正确写法只看下面这一条别抄错行mkdir C:\Program Files\boost xcopy /E /I D:\Ogre\OgreSDK_vc10_v1-7-3\boost_1_44 C:\Program Files\boost\boost_1_44/E连空子目录一起复制/I让 xcopy 把目标当成目录处理目标不存在时直接建。整条命令里路径带空格引号一个都不能少少一个就变成复制到C:\Program。目录名保持boost_1_44不要改成boost1_44。Ogre.sln里那些写死的附加包含目录就是按boost_1_44这个名字拼的改了名编译期会报找不到boost/...开头的头文件。SDK 自带的那一份不用删自己建模板工程时附加包含目录写$(OGRE_HOME)\boost_1_44也照样能用。两份并存不是问题但版本必须都是 1.44混版本最容易出的是链接期符号冲突报错信息完全看不出跟 boost 有关。3.3 生成解决方案Ogre.sln 打开后先看配置管理器双击D:\Ogre\OgreSDK_vc10_v1-7-3\Ogre.sln。如果 VS2010 弹转换向导说明打开它的 IDE 版本不对先回去确认 2.3 那一步。生成之前先看「生成 → 配置管理器」活动解决方案配置是Debug活动解决方案平台是Win32不是x64。OGRE 1.7.3 的 SDK 只带 32 位库平台选错链接器会在lib\x64这种根本不存在的目录里找库报错看起来像库没编译。确认完右键解决方案 → 生成解决方案然后去干别的。这一步慢是正常的别因为进度条不动就点取消取消之后残留的中间文件还得清一遍重来。编译结束看输出窗口最后一行0 个错误。如果有一堆错误只处理排在最前面的那一条后面的多半是它引起的连带错误从下往上改是纯浪费。3.4 cthugha\Debug 产物归位与 SamplesBrowser 冒烟生成完成后去 D 盘根目录看一眼会多出一个cthugha文件夹。这是 SDK 里部分渲染插件工程的输出目录被设在了D:\cthughaDebug 配置的产物落在D:\cthugha\Debug。这些 dll 得放到 SDK 的bin\debug下样例浏览器才认。dir D:\cthugha\Debug xcopy /E /Y D:\cthugha\Debug\* D:\Ogre\OgreSDK_vc10_v1-7-3\bin\debug\第一条先确认目录里有东西第二条整体拷过去/Y表示同名文件直接覆盖不再问。覆盖是必须的bin\debug里原本就有同名文件不覆盖等于没拷。然后双击bin\debug\SamplesBrowser.exe。能进样例浏览界面说明 SDK 这一层通了。随便点开一个样例会弹 Ogre 的配置对话框渲染子系统下拉里选Direct3D9 Rendering SubSystem点 OK能进到场景里动起来SDK 就是装好了。如果对话框没弹出来、直接闪退或者黑屏先删掉bin\debug\ogre.cfg再启动一次——这个文件缓存了上次的渲染配置显卡环境变了之后它会让程序在错误的子系统上初始化。还本文还有配套的精品资源点击获取