Qt 项目编译错误排查与解决记录
Qt 项目编译错误排查与解决记录项目信息项目路径D:\ai_xi_bai_projext_code\code\Chap01_Intro\samp1_1HelloWorldQt 版本Qt 6.2.4 MSVC 2019 64bit编译器MSVC 2019 (Visual Studio 2019)操作系统Windows 11通用背景为什么需要在 .pro 中手动配置 SDK 路径本项目的编译环境Qt 6.2.4 MSVC 2019由于安装方式或环境配置原因qmake 未能自动检测到 Windows SDK 的路径导致编译器和链接器不知道去哪里找 SDK 的头文件和库文件。因此必须在.pro文件中手动指定 SDK 路径。Windows SDK 的目录结构如下C:\Program Files (x86)\Windows Kits\10\ ├── Include\10.0.19041.0\ │ ├── ucrt\ ← C 运行时头文件stddef.h, crtdbg.h, stdio.h … │ ├── um\ ← 用户模式 API 头文件windows.h, shellapi.h … │ └── shared\ ← 共享头文件 ├── Lib\10.0.19041.0\ │ ├── ucrt\x64\ ← C 运行时库libucrt.lib … │ └── um\x64\ ← 用户模式 API 库shell32.lib, user32.lib … └── bin\10.0.19041.0\ └── x64\ ← SDK 工具rc.exe, mt.exe …下面三个错误根源都是.pro中手动配置的 SDK 路径不完整——只配了ucrt缺少um和shared。错误一C1083 找不到 UCRT 头文件stddef.h / crtdbg.h / yvals.h错误现象cstddef:12: error: C1083: 无法打开包括文件: stddef.h: No such file or directory yvals.h:12: error: C1083: 无法打开包括文件: crtdbg.h: No such file or directory cstddef:12: error: C1083: 无法打开包括文件: stddef.h: No such file or directory根因这三个是编译阶段的错误比链接错误更早出现。stddef.h、crtdbg.h是UCRTUniversal C Runtime的头文件它们被 MSVC 的cstddef、yvals.h等 C 标准库头文件间接引用只有把$$SDK_ROOT/Include/$$SDK_VER/ucrt加入INCLUDEPATH编译器才能找到它们当.pro中未添加任何 SDK Include 路径时编译器在默认搜索路径中找不到这些头文件导致编译失败。这些错误先于链接错误出现是排查的第一步。错误二LNK1104 找不到系统库shell32.lib错误现象:-1: error: LNK1104: 无法打开文件shell32.lib根因这是链接阶段的错误。编译通过后链接器需要将系统 API 库如shell32.lib链接到可执行文件。Windows SDK Lib 子目录包含内容ucrt\x64\C 运行时库libucrt.lib 等um\x64\系统 API 库shell32.lib、user32.lib、kernel32.lib 等shell32.lib位于Lib\10.0.19041.0\um\x64\但.pro中只添加了-L$$SDK_ROOT/Lib/$$SDK_VER/ucrt/x64UCRT 库路径缺少了um/x64路径链接器在 UCRT 目录下找不到shell32.lib错误三LNK1158 找不到 rc.exe错误现象:-1: error: LNK1158: 无法运行rc.exe排查过程确认 rc.exe 存在C:\Program Files (x86)\Windows Kits\10\bin\10.0.19041.0\x64\rc.exe存在C:\Program Files (x86)\Windows Kits\10\bin\10.0.26100.0\x64\rc.exe存在检查 VS 2019 MSVC 工具链目录D:\visual_studio_2019\VC\Tools\MSVC\14.29.30133\bin\Hostx64\x64\下没有rc.exe检查 PATH 环境变量PATH 中未包含 Windows SDK 的 bin 目录根因rc.exe资源编译器是Windows SDK的工具不属于 MSVC。链接器在链接完成后需要用rc.exe将 manifest 嵌入 exe但 PATH 中找不到 SDK bin 目录。统一解决方案第一步修复 .pro 文件解决错误一 错误二补全所有 3 个 SDK 子目录的 Include编译用和 Lib链接用路径SDK_ROOT C:/Program Files (x86)/Windows Kits/10 SDK_VER 10.0.19041.0 # Include 路径 —— 编译器找头文件用 INCLUDEPATH $$SDK_ROOT/Include/$$SDK_VER/ucrt # C 运行时头文件stddef.h 等 INCLUDEPATH $$SDK_ROOT/Include/$$SDK_VER/um # 系统 API 头文件 INCLUDEPATH $$SDK_ROOT/Include/$$SDK_VER/shared # 共享头文件 # Lib 路径 —— 链接器找 .lib 用 LIBS -L$$SDK_ROOT/Lib/$$SDK_VER/ucrt/x64 # C 运行时库 LIBS -L$$SDK_ROOT/Lib/$$SDK_VER/um/x64 # 系统 API 库shell32.lib 等 # 额外的编译选项 QMAKE_CXXFLAGS /I$$SDK_ROOT/Include/$$SDK_VER/ucrt QMAKE_CXXFLAGS /I$$SDK_ROOT/Include/$$SDK_VER/um QMAKE_CXXFLAGS /I$$SDK_ROOT/Include/$$SDK_VER/shared第二步添加 SDK bin 到 PATH解决错误三将以下路径添加到用户环境变量 PATHC:\Program Files (x86)\Windows Kits\10\bin\10.0.19041.0\x64第三步清理并重新构建删除旧的 build 目录让 qmake 重新生成 Makefile重启 Qt Creator让新 PATH 生效重新qmake - Build提示如果通过 Visual Studio 的Developer Command Prompt for VS 2019启动 Qt Creator开发环境会自动配好所有 SDK 路径从根本上避免以上三个错误。经验总结Windows SDK 目录结构要记清Include/下有ucrt/、um/、shared/三个子目录Lib/下同样有ucrt/、um/两个子目录bin/下有rc.exe等工具手动配置 SDK 路径时必须同时添加 Include 和 Lib 的所有必要子目录ucrt um shared缺一不可三个错误的本质是同一问题缺ucrtInclude → 编译报 C1083找不到 stddef.h, crtdbg.h缺umLib → 链接报 LNK1104找不到 shell32.lib缺binPATH → 链接后报 LNK1158找不到 rc.exe出问题看 Makefile.pro修改后运行 qmake 会生成 MakefileMakefile.Debug 里的LIBS、INCPATH等变量直接反映最终编译配置是排查的关键最佳的启动方式通过Developer Command Prompt for VS启动 Qt CreatorSDK 路径、环境变量全都自动配好可以彻底避免此类问题

相关新闻

TMS320C2x DSP汇编指令深度解析:从MAR、MPY到NORM的实战指南

TMS320C2x DSP汇编指令深度解析:从MAR、MPY到NORM的实战指南

1. 项目概述:为什么我们要深挖TMS320C2x汇编指令?如果你正在或即将与德州仪器(TI)的TMS320C2x系列数字信号处理器(DSP)打交道,尤其是在电机控制、音频编解码或早期通信设备等对实时性和效率有极…

2026/11/9 9:43:23 阅读更多 →
Unity游戏开发:从基础到进阶的智能追踪导弹系统实现与优化

Unity游戏开发:从基础到进阶的智能追踪导弹系统实现与优化

1. 项目概述:从“打不准”到“躲不掉”的智能追踪在任何一个射击游戏里,让玩家感到“爽快”的,除了精准的枪法,往往还有那些带有智能追踪效果的武器。想象一下,你发射出一枚导弹,它拖着长长的尾焰&#xff…

2026/11/19 13:15:19 阅读更多 →
0基础专升本同学 怎么理解C语言?(上)

0基础专升本同学 怎么理解C语言?(上)

说实话,C语言不简单,我拆书都要专门写两片帖子。 尤其学到数组、函数、指针以后,理解难度会明显上升。 不过,我还是想把谭浩强的《C程序设计》带同学们从头梳理了一遍。 C语言到底是什么? 简单来说,C语言就…

2026/11/18 13:44:39 阅读更多 →

最新新闻

Electron桌面应用开发实战:从环境搭建到打包发布全流程

Electron桌面应用开发实战:从环境搭建到打包发布全流程

做前端这些年,我大部分时间都在跟浏览器标签页打交道,直到第一次把桌面应用跑起来,才发现原来自己一直被限制在地址栏和刷新按钮围起来的框框里。Electron这个词,最开始是在某段时间频繁出现在同事的讨论里,一个用HTML…

2026/11/19 21:38:27 阅读更多 →
滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

简介:亚太天能T109滑盖智能锁产品说明书是一份PDF格式的官方技术文档,主要面向智能锁安装人员、终端用户及售后维护者,帮助快速掌握产品安装、配置与常见故障处理。全包仅1个PDF文件,大小4.37MB,内容结构清晰&#xff…

2026/11/19 21:38:49 阅读更多 →
PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

上个月我在调试一台高速AGV的驱动系统,整车要求空载跑到8m/s,电机转速已经拉到额定点,驱动器的输出电压也顶到了母线电压极限附近。再往上踩速度指令,转速纹丝不动,三相电流反而开始震荡。那会儿我的第一反应就是&…

2026/11/19 21:39:09 阅读更多 →
C++核心知识点:从内存管理到STL的实战指南

C++核心知识点:从内存管理到STL的实战指南

C 这门语言我前前后后折腾了十几年,用它写过嵌入式驱动、做过游戏服务端,也搭过基础组件库。每次看到新人一头扎进"C 核心知识点"这个搜索词,我其实挺感慨的——这门语言的难点从来不是语法多,而是知识点之间的耦合太深…

2026/11/19 21:36:50 阅读更多 →
T109滑盖智能锁怎么装?安装调试与故障排查全攻略

T109滑盖智能锁怎么装?安装调试与故障排查全攻略

简介:亚太天能T109滑盖智能锁产品说明书以PDF格式发布,适合智能锁用户、安装人员与售后维修人员阅读。内容围绕T109系列指纹密码刷卡锁展开,先介绍前面板、后面板、锁体、机械钥匙、电池盒盖等部件名称与功能,再给出完整安装步骤&…

2026/11/19 21:37:45 阅读更多 →
LLM知识降熵:从信息垄断到理解权下放

LLM知识降熵:从信息垄断到理解权下放

你有没有过这种经历:翻开源码注释、论文摘要或者一份专业报告,每个字都认识,连在一起却像天书。想找人聊聊,身边要么没人懂,要么懂的懒得跟你解释。后来我试着把同一段内容丢给一个大语言模型,几秒钟之后&a…

2026/11/19 21:36:20 阅读更多 →

日新闻

周新闻

月新闻