从零开始：Qt编译配置入门指南

从零开始：Qt编译配置入门指南

引用

CSDN

等

12

来源

1.

https://blog.csdn.net/jiesunliu3215/article/details/139313008

2.

https://cloud.baidu.com/article/3290986

3.

https://blog.csdn.net/qq_37286579/article/details/143878045

4.

https://blog.csdn.net/xie__jin__cheng/article/details/140654101

5.

https://blog.csdn.net/wtl1992/article/details/143638700

6.

https://blog.csdn.net/wkd_007/article/details/141891950

7.

https://blog.csdn.net/m0_51064412/article/details/136495082

8.

https://blog.csdn.net/weixin_44339850/article/details/137562610

9.

https://blog.csdn.net/qianniulaoren/article/details/139028554

10.

https://developer.aliyun.com/article/1488363

11.

https://www.qt.io/zh-cn/blog/qt-6.8-released

12.

https://docs.pingcode.com/baike/3209498

Qt是一款跨平台的C++图形用户界面应用程序框架，广泛应用于桌面、嵌入式和移动设备的开发。对于初学者来说，掌握Qt的编译配置是入门的第一步。本文将详细介绍如何在Windows环境下从零开始搭建Qt开发环境，包括获取源码、安装必要的构建工具链、使用CMake以及Ninja等工具。

在开始Qt开发之前，你需要准备以下工具：

1. Qt SDK：包含Qt库和Qt Creator集成开发环境。
2. C++编译器：Qt SDK已经内置了MinGW编译器，你也可以选择使用Microsoft Visual C++ (MSVC)。
3. CMake：用于生成构建系统。
4. Ninja：轻量级的构建工具，可以替代传统的Makefile系统。

下载Qt SDK

Qt5.15及Qt6版本需要使用在线安装程序进行软件安装。你可以从以下地址下载：

• 官网：https://download.qt.io/official_releases/online_installers/
• 国内镜像：
  • 中国科学技术大学：https://mirrors.ustc.edu.cn/qtproject/official_releases/online_installers/
  • 清华大学：https://mirrors.tuna.tsinghua.edu.cn/qt/official_releases/online_installers/
  • 北京理工大学：https://mirror.bit.edu.cn/qtproject/official_releases/online_installers/

安装Qt SDK

1. 下载完成后，运行安装程序。由于在线安装可能会非常慢，建议通过命令行启动安装程序：

   打开PowerShell，输入以下命令：

   cd 下载目录路径
   .\qt-unified-windows-x64-online.exe --mirror https://mirrors.ustc.edu.cn/qtproject
   

   如果下载路径在非C盘，需要先切换盘符：

   D:
   

2. 输入邮箱账号和密码，点击“下一步”。

3. 勾选“我已阅读并同意xxx”和“我是个人用户xxx”，点击“下一步”。

4. 进入欢迎页面，点击“下一步”。

5. 选择“disable sending xxx”，点击“下一步”。

6. 设置安装路径，注意要使用英文路径，避免安装错误。选择自定义安装内容，点击“下一步”。

7. 选择需要安装的Qt版本和编译器。建议选择LTS（长期支持）版本。如果不确定需求，可以选择全部内容。点击“下一步”。

8. 选择开发工具，点击“下一步”。

9. 勾选最下方选项，点击“下一步”。

10. 点击“安装”按钮，等待进度条完成。

11. 安装完成后，点击“完成”。

配置Qt Creator

1. 打开Qt Creator，在“工具”菜单中选择“选项”。

2. 在弹出的对话框中，配置Qt版本、编译器等信息。确保Qt Creator能够正确识别并使用你安装的Qt SDK和C++编译器。

3. 配置编译器：

   • 打开Qt Creator，点击菜单栏中的“工具”然后选择“选项”。
   • 在弹出的对话框中，选择“构建和运行”。
   • 在左侧导航栏中，选择“编译器”。
   • 如果Qt Creator没有自动检测到你的编译器，你可以点击“添加”按钮，然后选择你的编译器类型（如GCC、MinGW、MSVC等）。
   • 填写编译器的名称、路径和相关参数。

4. 配置Qt版本：

   • 在“构建和运行”设置中，选择“Qt版本”。
   • 点击“添加”按钮，然后选择你的Qt安装路径。
   • Qt Creator会自动检测并显示可用的Qt版本。

5. 配置构建套件：

   • 在“构建和运行”设置中，选择“构建套件”。
   • 点击“添加”按钮来创建一个新的构建套件。
   • 为套件命名，并选择之前配置的编译器和Qt版本。

使用CMake和Ninja

1. 安装Ninja：确保系统上已安装Ninja。可以从Ninja的GitHub页面下载预编译的二进制文件，或使用包管理器安装。

2. 配置CMake使用Ninja：在命令行中运行CMake，并指定Ninja作为生成器：

   mkdir build && cd build
   cmake -G Ninja ..
   

3. 构建项目：运行以下命令进行构建：

   ninja
   

4. 安装和清理：使用以下命令进行安装和清理：

   ninja install
   ninja clean
   

在Qt Creator中使用CMake和Ninja

1. 打开Qt Creator，点击“文件”->“新建文件或项目”。

2. 选择“CMake项目”，点击“选择”。

3. 输入项目名称和位置，点击“下一步”。

4. 选择构建系统为CMake，点击“下一步”。

5. 选择构建目录，点击“下一步”。

6. 在“构建套件”中选择之前配置的套件，点击“完成”。

7. 在项目配置中，选择“构建步骤”。

8. 在“构建步骤”中，选择“CMake”。

9. 在“CMake参数”中添加-G Ninja，点击“应用”。

10. 点击“构建”按钮，使用Ninja进行构建。

1. 安装速度慢：使用国内镜像源可以显著提高下载速度。

2. 编译器配置错误：确保环境变量（如PATH）已正确设置，以便Qt Creator能够找到编译器和其他必要的工具。

3. 构建失败：检查CMakeLists.txt文件是否正确配置，确保所有依赖项都已安装。

4. Qt Creator无法识别Qt版本：在Qt Creator的“选项”中手动添加Qt版本路径。

通过以上步骤，你已经完成了Qt开发环境的搭建和基本配置。接下来，你可以尝试创建一个简单的Qt Widgets应用程序，体验Qt开发的魅力。记住，实践是最好的学习方式，多动手编写代码，你将很快掌握Qt开发的精髓。