为何QPdfDocument未找到？Qt6 Pdf组件CMake配置报错求助

问题根源 #

勾选了Qt PDF组件但实际未完成有效安装，导致CMake找不到组件配置文件，编译器也无法定位对应头文件。

解决步骤 #

1. 重新通过Qt维护工具安装组件 #

• 找到Qt安装根目录下的MaintenanceTool.exe（例如C:\Qt\MaintenanceTool.exe）并运行
• 选择「添加或移除组件」，进入组件选择界面
• 展开已安装的Qt 6.3.1版本，找到MinGW 64位对应的套件，展开「Additional Libraries」分类
• 确认「Qt PDF」和「Qt PDF Widgets」（若需PDF相关UI组件）已勾选，点击「下一步」完成安装

2. 验证安装结果 #

安装完成后检查以下路径是否存在对应文件：

• 组件配置文件：C:/Qt/6.3.1/mingw_64/lib/cmake/Qt6Pdf/Qt6PdfConfig.cmake
• 头文件：C:/Qt/6.3.1/mingw_64/include/QtPdf/QPdfDocument

3. 修正CMake配置 #

若安装后CMake仍无法识别组件，可手动指定Qt安装路径：

# 指定Qt安装目录
set(CMAKE_PREFIX_PATH "C:/Qt/6.3.1/mingw_64")

# 查找所需Qt组件（Widgets因用到QApplication需添加）
find_package(Qt6 REQUIRED COMPONENTS Pdf Widgets)

# 链接目标与Qt组件
target_link_libraries(mytarget PRIVATE Qt6::Pdf Qt6::Widgets)

4. IDE与构建配置检查 #

• 在Qt Creator中，确认当前使用的Kit对应已安装的Qt 6.3.1 MinGW 64位版本
• 清理项目构建目录，重新运行CMake并编译项目

内容的提问来源于stack exchange，提问作者Fishmarket