VS2013配置Qt,最直接有效的方案是安装Qt 5.9.9,在安装时勾选MSVC2013组件,再通过Qt VS Tools插件完成版本映射,只要版本匹配,整个配置过程半小时内就能搞定,比硬撑高版本省心得多。
vs2013配置qt5.9的完整步骤
确认vs2013能用的qt版本
VS2013的编译器是MSVC12.0,Qt官方从5.10版本开始就不再提供MSVC2013的预编译包,如果你强行装Qt 5.10以上,在VS2013里根本找不到对应的编译套件,业内专家指出,Qt 5.9.9是支持VS2013的最后一个长期支持版本,也是“VS2013+Qt”这个组合里的最佳终点。
下载地址建议直接用Qt官方archive,别在第三方网站乱找,安装时选择“Custom”模式,展开Qt 5.9.9节点,勾选MSVC2013 32-bit和MSVC2013 64-bit组件,只做桌面程序的话,Android/iOS模块可以不勾,能省不少磁盘空间。
安装Qt VS Tools插件
VS2013没有原生Qt支持,需要单独安装Visual Studio Add-in for Qt5,到Qt官方插件下载页找到对应的.vsix安装包,双击后VS会自动启动扩展安装流程,装完重启VS,顶部工具栏会出现“Qt VS Tools”菜单。
打开“Qt VS Tools -> Qt Versions”,把路径指到qmake.exe所在目录,比如你装在 D:QtQt5.9.9,那就填 D:QtQt5.9.95.9.9msvc2013_64,保存后新建项目,模板里就能看到Qt Widgets Application等选项。
配置时的几个小细节
- 安装路径不要带中文和空格,推荐
D:Qt这种简洁目录。 - 插件安装失败时,用管理员身份重开VS再装一次。
- 手动把Qt的bin目录加入系统PATH,
,否则运行程序时会找不到Qt5Core.dll。
D:QtQt5.9.95.9.9msvc2013_64bin
如何验证配置成功
新建项目时选择“Qt Widgets Application”,在向导里确认Qt版本下拉框里能看到刚才填的5.9.9,然后直接按F5编译运行,如果弹出一个空窗口,说明环境已经通了,如果报错,就按后面的排查清单来。
vs2013怎么配置qt环境?手动设置三步走
如果插件实在装不上,或者你想完全掌控每个环节,可以纯手动配置,这条路稍麻烦,但能加深理解。
第一步:把include和lib目录加到VC++目录
在VS2013里打开“项目属性 -> VC++目录”,在“包含目录”里填写 D:QtQt5.9.95.9.9msvc2013_64include,在“库目录”里填写 D:QtQt5.9.95.9.9msvc2013_64lib,这里注意区分32位和64位,选错了后面编译报错会让你怀疑人生。
第二步:设置附加依赖项
打开“链接器 -> 输入 -> 附加依赖项”,至少写入:
- Qt5Widgets.lib
- Qt5Gui.lib
- Qt5Core.lib
用到了网络、SQL、XML这些模块,就再补上对应的lib,手动配置时漏写依赖项是常有的事,每次报“无法解析的外部符号”时,先回来检查这里。
第三步:处理moc和uic生成规则
这一步最折腾,你需要把Qt的bin目录加进PATH,然后在项目“生成事件”里手动调用moc.exe和uic.exe处理头文件和.ui文件,顺序弄反会导致moc生成失败,多数情况下,手动配置容易因为“预生成事件”的步骤写错而卡住,所以纯手动只适合学习,实际做项目还是用插件来得香。

对比:qt vs2013哪个版本更合适
很多新手纠结“VS2013配Qt5.9是不是太老”“用Qt5.15行不行”,这里直接把常见版本和VS2013的适配关系列出来:
| Qt版本 | 官方预编译包兼容VS2013 | 推荐程度 |
|---|---|---|
| Qt 5.6 | 支持 | 可用,但组件较旧 |
| Qt 5.9.9 | 支持 | 强烈推荐,稳定LTS |
| Qt 5.12 | 不支持 | 不推荐,需自行编译 |
| Qt 5.15 | 不支持 | 不推荐,自编译复杂度高 |
| Qt 6.x | 不支持 | 完全无法原生配合使用 |
行业共识认为,除非有特殊要求,VS2013搭配Qt5.9.9就是性能与兼容性的平衡点,如果你非要给VS2013装Qt5.12以上,就得下载源码再用VS2013编译整个Qt库,中间要装Perl、Python和JOM,耗时好几个小时,还会遇到OpenSSL等第三方依赖问题,这种折腾实在没必要。
实战排查:vs2013配置qt时常见的坑
坑一:插件装完但没有Qt项目模板
先打开“工具 -> 扩展和更新”,确认插件已经启用,另一个常见原因是VS2013的系统更新没打全,装上Visual Studio 2013 Update 5再重启,模板就会出现了,插件安装时建议右键以管理员身份运行VS。
坑二:编译报错“LNK1112: module machine type ‘x64’ conflicts with target machine type ‘X86’”
这是项目平台和目标Qt套件位数不匹配,打开“属性管理器”,确认当前活动平台是Win32还是x64,然后去Qt Versions里选择对应的msvc2013还是msvc2013_64,两边必须一致。

坑三:运行程序提示“找不到Qt5Cored.dll”
带“d”后缀的库是Debug版本,如果你安装Qt时没勾Debug模块,那编译Debug程序就会缺这个DLL,最简单的办法是切换成Release模式编译,或者在安装包里补勾Debug组件。
坑四:中文路径导致moc崩溃
项目文件夹如果放在“C:用户张三项目”这种带中文的路径下,moc.exe经常报出莫名其妙的错误,把项目挪到一个纯英文路径,D:workdemo,问题会立刻消失。
vs2013配置qt常见问题问答
为什么vs2013配置qt5.9后还是检测不到qmake?
检查“Qt Versions”里填的路径是否指向了包含bin子目录的版本根目录,qmake.exe应该位于 版本根目录binqmake.exe,同时确认安装时真的勾选了MSVC2013模块,没勾的话整个目录下都不会有qmake.exe。
用vs2013配qt和直接qt creator开发差别大吗?
调试体验上,VS2013的内存窗口、断点管理更顺手;Qt Creator则更擅长UI设计器的实时预览和.qrc资源编辑,多数情况下,团队协作项目用VS2013,单独做界面原型时切到Qt Creator,两者共用同一个Qt安装目录,不会互相干扰。
vs2013配置qt有必要额外安装qt creator吗?
不是强制要求,但建议装上,Qt Creator可以快速验证某个.ui文件或示例程序是否正常,出问题时还能用来区分是VS配置问题还是Qt本身的问题,安装时在组件列表里勾选Qt Creator即可,不会影响VS2013的环境。
