装了新的QtCreator17,没有用Qt5.12自带的QtCreator4,导致QtCreator17无法找到Qt5.12帮助文档

首先说明,按照如下步骤,我的问题已经解决了。

如果你也是同样的问题,可参考以下步骤操作:

1. 确认Qt 5.12文档已正确安装

Qt Creator的帮助文档依赖Qt版本对应的.qch文档文件(Qt Help Collection)。首先检查Qt 5.12是否安装了文档:

  • Windows :查看Qt安装目录下的docs文件夹(如C:\Qt\5.12.18\Docs),或具体编译器的doc子目录(如C:\Qt\5.12.18\mingw73_64\doc)。

  • Linux/macOS :检查/opt/Qt/5.12.18/doc或自定义安装路径下的doc目录。

若未找到docs文件夹或文件缺失,说明安装时未勾选文档组件。需重新运行Qt安装器,在Qt 5.12的安装界面中勾选:

  • Qt 5.12.18 > Qt 5.12.18 > Documentation(所有子项,如Qt Core、Qt Widgets等)。

  • 安装完成后,确认docs目录下生成了.qch文件(如qt512.qch或按模块划分的.qch文件)。

2. 手动添加Qt 5.12文档到Qt Creator

若文档已安装但Qt Creator 17未自动识别,需手动配置文档路径:

步骤1:打开Qt Creator设置

启动Qt Creator 17 → 顶部菜单编辑(Edit)选项(Preference)→ 左侧导航栏 帮助(Help)文档(Documentation)

步骤2:添加Qt 5.12的.qch文件

点击右上角 添加(Add...)按钮,选择Qt 5.12的所有文档文件(.qch格式)。注意,所有.qch文件都添加上。

常见路径:

  • WindowsC:\Qt\5.12.18\Docs\Qt-5.12.18\*.qch(或按模块的路径,如C:\Qt\5.12.18\mingw73_64\doc\html\*.qch)。

  • Linux/macOS/opt/Qt/5.12.18/doc/*.qch/usr/local/Qt/5.12.18/doc/*.qch

提示 :若不确定.qch文件位置,可在Qt 5.12的docs目录下搜索*.qch文件(通常以qt512或模块名命名)。注意,所有.qch文件都添加上。

步骤3:验证文档加载

添加后,列表中会出现"Qt 5.12 Documentation"条目,状态应为"已加载"。若加载失败,检查:

  • .qch文件路径是否正确。

  • 文件是否被系统权限限制(尝试以管理员权限运行Qt Creator)。

  • Qt Creator版本是否兼容(Qt Creator 17理论上支持Qt 5.12文档,若异常可尝试更新Qt Creator到最新补丁版)。

总结

通过如上方法,就可以在QtCreator17中使用Qt5.12的帮助文档了。按F1快捷键,也能直接跳转到文档位置。

相关推荐
luoyayun3611 小时前
Qt + FFmpeg 音频工具:重采样实现
qt·ffmpeg·重采样
小短腿的代码世界20 小时前
Qt Bluetooth源码深度解析:从HCI协议到跨平台API的完整架构
开发语言·qt·架构
小短腿的代码世界21 小时前
Qt WebEngine多进程架构与IPC通信:从Chromium多进程到Qt信号槽融合
qt·架构·系统架构
尘中远1 天前
【Qwt 7.0 系列】快速入门与核心新特性概览 —— 更现代的 Qt 数据可视化库
qt·数据可视化·绘图·qwt·科学绘图
初阳7851 天前
【Qt】系统相关(3)——多线程
qt
初阳7851 天前
【Qt】系统相关(2)——文件
开发语言·qt
尘中远2 天前
【Qwt 7.0 系列】坐标轴与刻度系统 —— 刻度引擎、网格、图例与刻度朝内
qt·数据可视化·qcustomplot·qwt·工业软件·科学绘图
sycmancia2 天前
Qt——多线程间的互斥
开发语言·qt
尘中远2 天前
【Qwt 7.0 系列】常用图表类型实战 —— 柱状图、散点图、箱线图与直方图
qt·qwt·工业软件·科学绘图
尘中远2 天前
【Qwt 7.0 系列】交互功能详解 —— 平移、缩放、坐标轴交互与数据拾取
qt·数据可视化·绘图·qcustomplot·qwt·科学绘图