开启跨平台 UI 之旅前言1️⃣Qt QC 极简安装2️⃣Qt 简介Qt 核心独立工具一览3️⃣新建项目IDE选择与介绍VSQt 集成插件选择项目模板初次加载 CMake 配置错误的解决办法QC4️⃣ 项目界面简介前言学完 C/C 语法大家是不是早就受够了那个黑乎乎的控制台窗口敲了半天代码连个像样的按钮都做不出来谁不想搞出一个真正带界面、能给别人用的桌面软件呢。听说 Qt 跨平台很牛结果刚打开官方安装器就傻眼了——全家桶动辄大几十个 G勾选项看的人眼花缭乱一不小心 C 盘直接红了。好不容易装完顺着教程建个项目有时只是挪了一下文件夹就跳出一堆玄学的 CMake 编译报错极其搞心态分分钟劝退。这篇专栏不废话全是我亲自踩过的坑。直接手把手带你避开 50G 的安装器陷阱极简配置出纯净的环境。1️⃣Qt QC 极简安装官方地址https://www.qt.io/development/downloadQt 那个在线安装器里面 90% 的企业级组件和移动端编译包初阶段做个简单的桌面软件根本碰不到。在安装列表里只勾选绿色项就行了在Developer Tools目录里展开Qt Creator。展开最新的Qt 版本号比如 Qt 6.x.x在这一列里勾选sourcesMinGW 64-bit/MSVC 64-bit。展开Additional Libraries勾选Qt HTTP ServerQt ChartsQt MultimediaQt Serial Port如果你的电脑里装了 VS 并打算用 VSIDE 则三个都勾选否则使用 QCIDE 就勾选MinGW 64-bit。2️⃣Qt 简介Qt 是一个强大的跨平台 C 图形用户界面应用程序开发框架。将 Qt 与 Visual Studio 强强联合不仅能够充分发挥 VS 在代码编辑、强大调试和大型工程管理上的优势还能无缝体验 Qt 优雅的界面构建能力。Qt 核心独立工具一览在成功安装 Qt之后在系统的开始菜单中找到一系列按功能划分的独立工具。它们各司其职涵盖了从文档查阅、界面绘制到程序国际化的完整工作流Qt Assistant官方的帮助文档阅读器。它提供了极其详尽的 Qt 类和函数介绍支持全文检索是你开发过程中的得力助手。Qt Designer强大的可视化界面设计师。支持所见即所得的拖拽式开发完全无需编写代码即可快速制作出精美的 UI 界面。Qt Linguist专为应用国际化设计的“语言家”工具能够高效管理和提取文本轻松完成软件的多语言翻译工作。Qt 命令行工具为开发者提供纯粹的命令行环境带有相关的编译套件支持 MinGW 13.1.0 64-bit 与 MSVC 2022 64-bit 等。Qt CreatorQt 官方出品的综合性 IDE。如果你不使用 Visual Studio这款工具将是你的主力开发环境其体验类似于经典的 VS2026。3️⃣新建项目IDE选择与介绍VS如果你已经有了项目可以直接在项目文件夹下右键用VS打开Qt 集成插件打开 Visual Studio呼出扩展窗口。搜索“Qt”。安装官方扩展插件Qt Visual Studio Tools。装完后上方会提示关闭VS跟着操作就行了。注下面的CMake tools是假的不要装错选择项目模板安装完插件后再次打开VS在 Visual Studio 的起始页面点击“创建新项目”。对于绝大多数传统桌面客户端开发我们选择Qt Widgets Application模板即可。接下来进入“配置新项目”的常规窗口。在这里我们输入基本的工程信息建议勾选将解决方案和项目放在同一目录中复选框。配置好路径后会正式进入 Qt 插件专属的“Qt Widgets Application Wizard”向导首页。向导会自动检测环境我们需要确认以下核心选项的配置Build System默认选择Qt Visual Studio Project (Qt/MSBuild)即可。Build Configurations构建环境这里虽然给了选项但我们只能选一个通常就选Debug如果这里没有选项就请先看点击这里跳转配置好后重新操作。 避坑指南请将视线移到向导窗口的左下角 “Project Settings” 区域。你会看到一个名为Enable PCH Support的复选框。正如图中所示的那样——在新项目中强烈建议不要勾选它尽管 PCH预编译头文件的初衷是为了加速编译但在如今的 Qt 开发生态中尤其是当你计划混合使用 CMake 构建系统时IDE 自动生成的 PCH 机制往往会导致严重的依赖混乱。它会“自作主张”地缓存一些头文件从而在跨平台编译或迁移 CMake 时引发令人头疼的配置报错。1保持代码结构的标准和干净才是长远之计。最后就是一些基本信息大家看的懂的不多介绍唯一要注意的是图中黄框内选项初次加载 CMake 配置错误的解决办法在 VS 中打开新创建的 Qt 项目时可能并不会看到成功编译的提示而是遭遇 CMake 生成失败。在输出窗口中你通常会看到类似下面这样的致命错误信息Could not find a package configuration file provided by “Qt6” (requested version 6.5) with any of the following names:Qt6.cpsqt6.cpsQt6Config.cmakeqt6-config.cmake这通常是因为我们在CMakeLists.txt中要求查找特定版本的 Qt但编译器却不知道去哪里寻找这些库文件。注意 Visual Studio 的顶部边缘你会发现一条醒目的黄色通知栏提示——“Qt Visual Studio Tools — You must select a Qt version to use for development. Select Qt version…”在顶部菜单栏中依次点击扩展(X)-Qt VS Tools-Qt Versions。点击input导入选择你安装Qt的文件夹找到msvc2022_64文件打开例D:\Dev\Qt\6.11.1\msvc2022_64等待添加后再次生成 CMake 缓存之前的报错就会无了。当然如果你用的是博主同款6.11版本可能会有新的报错报错原因项目配置中开启了“将警告视为错误”即 /WX 编译选项。Qt 6.11 提示 compressEvent 将在 Qt 7 中移除在头文件里触发了这个警告编译器把它当成了严重错误直接中断了生成。在“解决方案资源管理器”中右键点击你的项目 VS_Qt_CMake选择最下方的 “属性” 。在左侧菜单展开 C/C - “预处理器” 。在 “预处理器定义”中点击编辑添加一行宏定义QT_NO_DEPRECATED_WARNINGS。点击“应用”并“确定”然后重新生成解决方案。再次运行就成功出现这个弹窗这就是你未来大展身手的应用UI界面如果你在配置路径时遇到更复杂的环境变量问题可以随时参考 Qt 官方 CMake配置文档 获取权威解答。QCQC的项目创建非常简单wins搜索Qt点击绿色QC图标打开点击创建项目模板选择选CMake或CMake with Qt 5…千万不要Qbs版本弃子基本信息设置按需选择在QC中我们用MinGW更好只需勾选前两个4️⃣ 项目界面简介希望这篇文章能帮你快速扫平 Qt 的配置障碍如果觉得对你有帮助欢迎点赞收藏。我们下一篇博客将正式进入 Qt 界面的核心开发敬请期待预编译头文件Precompiled Header虽然能将庞大且不常变动的头文件如QtWidgets提前编译为二进制缓存但在 CMake 的跨平台语法体系中处理特定于 MSBuild 的 PCH 设置非常繁琐。为了保证项目在 Windows、Linux 和 Mac 上的一致性放弃 IDE 专属的 PCH 优化是明智的选择。 ↩︎
Qt Creator 极简安装与 CMake 配置指南 | 桌面开发实战 01
发布时间：2026/6/19 22:45:08
开启跨平台 UI 之旅前言1️⃣Qt QC 极简安装2️⃣Qt 简介Qt 核心独立工具一览3️⃣新建项目IDE选择与介绍VSQt 集成插件选择项目模板初次加载 CMake 配置错误的解决办法QC4️⃣ 项目界面简介前言学完 C/C 语法大家是不是早就受够了那个黑乎乎的控制台窗口敲了半天代码连个像样的按钮都做不出来谁不想搞出一个真正带界面、能给别人用的桌面软件呢。听说 Qt 跨平台很牛结果刚打开官方安装器就傻眼了——全家桶动辄大几十个 G勾选项看的人眼花缭乱一不小心 C 盘直接红了。好不容易装完顺着教程建个项目有时只是挪了一下文件夹就跳出一堆玄学的 CMake 编译报错极其搞心态分分钟劝退。这篇专栏不废话全是我亲自踩过的坑。直接手把手带你避开 50G 的安装器陷阱极简配置出纯净的环境。1️⃣Qt QC 极简安装官方地址https://www.qt.io/development/downloadQt 那个在线安装器里面 90% 的企业级组件和移动端编译包初阶段做个简单的桌面软件根本碰不到。在安装列表里只勾选绿色项就行了在Developer Tools目录里展开Qt Creator。展开最新的Qt 版本号比如 Qt 6.x.x在这一列里勾选sourcesMinGW 64-bit/MSVC 64-bit。展开Additional Libraries勾选Qt HTTP ServerQt ChartsQt MultimediaQt Serial Port如果你的电脑里装了 VS 并打算用 VSIDE 则三个都勾选否则使用 QCIDE 就勾选MinGW 64-bit。2️⃣Qt 简介Qt 是一个强大的跨平台 C 图形用户界面应用程序开发框架。将 Qt 与 Visual Studio 强强联合不仅能够充分发挥 VS 在代码编辑、强大调试和大型工程管理上的优势还能无缝体验 Qt 优雅的界面构建能力。Qt 核心独立工具一览在成功安装 Qt之后在系统的开始菜单中找到一系列按功能划分的独立工具。它们各司其职涵盖了从文档查阅、界面绘制到程序国际化的完整工作流Qt Assistant官方的帮助文档阅读器。它提供了极其详尽的 Qt 类和函数介绍支持全文检索是你开发过程中的得力助手。Qt Designer强大的可视化界面设计师。支持所见即所得的拖拽式开发完全无需编写代码即可快速制作出精美的 UI 界面。Qt Linguist专为应用国际化设计的“语言家”工具能够高效管理和提取文本轻松完成软件的多语言翻译工作。Qt 命令行工具为开发者提供纯粹的命令行环境带有相关的编译套件支持 MinGW 13.1.0 64-bit 与 MSVC 2022 64-bit 等。Qt CreatorQt 官方出品的综合性 IDE。如果你不使用 Visual Studio这款工具将是你的主力开发环境其体验类似于经典的 VS2026。3️⃣新建项目IDE选择与介绍VS如果你已经有了项目可以直接在项目文件夹下右键用VS打开Qt 集成插件打开 Visual Studio呼出扩展窗口。搜索“Qt”。安装官方扩展插件Qt Visual Studio Tools。装完后上方会提示关闭VS跟着操作就行了。注下面的CMake tools是假的不要装错选择项目模板安装完插件后再次打开VS在 Visual Studio 的起始页面点击“创建新项目”。对于绝大多数传统桌面客户端开发我们选择Qt Widgets Application模板即可。接下来进入“配置新项目”的常规窗口。在这里我们输入基本的工程信息建议勾选将解决方案和项目放在同一目录中复选框。配置好路径后会正式进入 Qt 插件专属的“Qt Widgets Application Wizard”向导首页。向导会自动检测环境我们需要确认以下核心选项的配置Build System默认选择Qt Visual Studio Project (Qt/MSBuild)即可。Build Configurations构建环境这里虽然给了选项但我们只能选一个通常就选Debug如果这里没有选项就请先看点击这里跳转配置好后重新操作。 避坑指南请将视线移到向导窗口的左下角 “Project Settings” 区域。你会看到一个名为Enable PCH Support的复选框。正如图中所示的那样——在新项目中强烈建议不要勾选它尽管 PCH预编译头文件的初衷是为了加速编译但在如今的 Qt 开发生态中尤其是当你计划混合使用 CMake 构建系统时IDE 自动生成的 PCH 机制往往会导致严重的依赖混乱。它会“自作主张”地缓存一些头文件从而在跨平台编译或迁移 CMake 时引发令人头疼的配置报错。1保持代码结构的标准和干净才是长远之计。最后就是一些基本信息大家看的懂的不多介绍唯一要注意的是图中黄框内选项初次加载 CMake 配置错误的解决办法在 VS 中打开新创建的 Qt 项目时可能并不会看到成功编译的提示而是遭遇 CMake 生成失败。在输出窗口中你通常会看到类似下面这样的致命错误信息Could not find a package configuration file provided by “Qt6” (requested version 6.5) with any of the following names:Qt6.cpsqt6.cpsQt6Config.cmakeqt6-config.cmake这通常是因为我们在CMakeLists.txt中要求查找特定版本的 Qt但编译器却不知道去哪里寻找这些库文件。注意 Visual Studio 的顶部边缘你会发现一条醒目的黄色通知栏提示——“Qt Visual Studio Tools — You must select a Qt version to use for development. Select Qt version…”在顶部菜单栏中依次点击扩展(X)-Qt VS Tools-Qt Versions。点击input导入选择你安装Qt的文件夹找到msvc2022_64文件打开例D:\Dev\Qt\6.11.1\msvc2022_64等待添加后再次生成 CMake 缓存之前的报错就会无了。当然如果你用的是博主同款6.11版本可能会有新的报错报错原因项目配置中开启了“将警告视为错误”即 /WX 编译选项。Qt 6.11 提示 compressEvent 将在 Qt 7 中移除在头文件里触发了这个警告编译器把它当成了严重错误直接中断了生成。在“解决方案资源管理器”中右键点击你的项目 VS_Qt_CMake选择最下方的 “属性” 。在左侧菜单展开 C/C - “预处理器” 。在 “预处理器定义”中点击编辑添加一行宏定义QT_NO_DEPRECATED_WARNINGS。点击“应用”并“确定”然后重新生成解决方案。再次运行就成功出现这个弹窗这就是你未来大展身手的应用UI界面如果你在配置路径时遇到更复杂的环境变量问题可以随时参考 Qt 官方 CMake配置文档 获取权威解答。QCQC的项目创建非常简单wins搜索Qt点击绿色QC图标打开点击创建项目模板选择选CMake或CMake with Qt 5…千万不要Qbs版本弃子基本信息设置按需选择在QC中我们用MinGW更好只需勾选前两个4️⃣ 项目界面简介希望这篇文章能帮你快速扫平 Qt 的配置障碍如果觉得对你有帮助欢迎点赞收藏。我们下一篇博客将正式进入 Qt 界面的核心开发敬请期待预编译头文件Precompiled Header虽然能将庞大且不常变动的头文件如QtWidgets提前编译为二进制缓存但在 CMake 的跨平台语法体系中处理特定于 MSBuild 的 PCH 设置非常繁琐。为了保证项目在 Windows、Linux 和 Mac 上的一致性放弃 IDE 专属的 PCH 优化是明智的选择。 ↩︎
