当前位置：首页 > news >正文

QT Quick（C++）跨平台应用程序项目实战教程 2 — 环境搭建和项目创建

news 来源：原创 2025/8/9 19:24:13

引言

1. 安装Qt开发环境

1.1 下载Qt安装包

1.2 安装Qt

1.3 安装Visual Studio 2022

1.4 在Visual Studio 2022中安装Qt插件

1.5 在Visual Studio 2022中安装大模型编程助手

2. 创建Qt Quick项目

2.1 创建新项目

2.2 项目结构

2.3 运行项目

3. 理解项目代码

3.1 main.cpp文件

3.2 main.qml文件

引言

在上一篇文章中，我们介绍了本教程的目标和结构，并简要说明了Qt Quick和C++在跨平台开发中的重要性。本文是教程的第2篇，我们将详细讲解如何搭建Qt开发环境，并创建一个Qt Quick项目。这是开发跨平台应用程序的第一步，也是至关重要的一步。

1. 安装Qt开发环境

1.1 下载Qt安装包

首先，需要下载并安装Qt开发环境。Qt提供了一个名为Qt Online Installer的工具，可以帮助我们轻松安装Qt框架、Qt Creator IDE以及相关的工具和库。

首先访问Qt官方网站并下载适用于Windows操作系统的安装包，如下图所示。

如果官网下载速度慢，也可以选择清华大学开源软件镜像站进行下载。

1.2 安装Qt

双击安装包进入安装界面。首先需要登录Qt账户，如果没有需要按照界面提示进行账户注册然后再登录。

然后选择安装目录并且选择自定义安装：

在接下来的安装过程中，需要选择要安装的组件，推荐按照下图所示进行勾选

最后按照默认提示完成安装即可（在安装过程中建议最好关闭杀毒软件）。

本教程安装的Qt版本为6.8.2，这是一个长期支持版本。

1.3 安装Visual Studio 2022

前面安装的Qt本质上是一个C++组件库，它的运行还需要依赖C++及编译器环境。本文推荐使用Visual Studio 2022。使用Visual Studio 2022作为Qt开发工具，可以提供强大的调试功能、高效的代码编辑器和丰富的插件支持，提升开发效率和体验。

首先前往Visual Studio官网下载Visual Studio 2022安装包。

下载完成后双击安装包进行安装，在组件选择时选择“使用C++的桌面开发”，如下图所示：

选择好以后安装默认提示进行安装即可。

1.4 在Visual Studio 2022中安装Qt插件

安装完成后，打开Visual Studio 2022，选择右侧“继续但无需代码”链接进入Visual Studio 2022主界面，如下图所示：

单击顶部菜单栏，选择“扩展”->“管理扩展”。在“浏览”窗体中选择Qt Visual Studio Tools进行安装，如下图所示：

选择好以后，关闭Visual Studio 2022，然后会自动进行插件更新。

1.5 在Visual Studio 2022中安装大模型编程助手

为了提高后续编程效率，推荐在Visual Studio 2022中安装大模型编程助手。具体安装方法同1.4节，只需要安装对应的插件即可。插件可以选择智普的CodeGeeX，如下图所示。

2. 创建Qt Quick项目

2.1 创建新项目

打开Visual Studio 2022，选择“创建新项目”：

在模板选择页面搜索qt，然后选择Qt Quick Application，如下图所示：

项目名称填写AudioPlayer，如下图所示：

单击创建，进入Qt项目配置界面，选择CMake工程，如下图所示：

最后单击Finish即可。

2.2 项目结构

创建项目后，会自动生成以下文件和文件夹：

main.qml：这是Qt Quick应用程序的主界面文件，使用QML语言编写。
main.cpp：这是C++入口文件，负责启动QML引擎并加载main.qml。
CMakeLists.txt：这是项目的构建配置文件。

2.3 运行项目

直接按Ctrl+F5可以启动程序，如下图所示：

你的第一个Qt Quick应用程序！

3. 理解项目代码

3.1 `main.cpp`文件

main.cpp是应用程序的入口点，代码如下：

#include <QGuiApplication>
#include <QQmlApplicationEngine>int main(int argc, char *argv[])
{
#if defined(Q_OS_WIN) && QT_VERSION_CHECK(5, 6, 0) <= QT_VERSION && QT_VERSION < QT_VERSION_CHECK(6, 0, 0)QCoreApplication::setAttribute(Qt::AA_EnableHighDpiScaling);
#endifQGuiApplication app(argc, argv);QQmlApplicationEngine engine;engine.load(QUrl(QStringLiteral("qrc:/qt/qml/audioplayer/main.qml")));if (engine.rootObjects().isEmpty())return -1;return app.exec();
}

QGuiApplication：管理GUI应用程序的控制流和主设置。
QQmlApplicationEngine：用于加载和运行QML文件。
engine.load：加载main.qml文件作为应用程序的主界面。

3.2 m`ain.qml`文件

main.qml定义了应用程序的用户界面，代码如下：

import QtQuick 2.9
import QtQuick.Window 2.2Window {visible: truewidth: 640height: 480title: "AudioPlayer"Text {anchors.fill: parenthorizontalAlignment: Text.AlignHCenterverticalAlignment: Text.AlignVCenterfont.bold: truefont.pointSize: 42text: "Hello World!"}
}

Window：表示应用程序的主窗口。
width和height：设置窗口的初始大小。
visible：设置窗口是否可见。
title：设置窗口标题。
Text：设置初始文本，现在在界面中间。

现在，你已经成功搭建了Qt开发环境，并创建了第一个Qt Quick项目。在下一篇文章中，我们将深入探讨Qt Quick的基础知识，学习如何使用QML创建更复杂的用户界面。

引言

1. 安装Qt开发环境

1.1 下载Qt安装包

1.2 安装Qt

1.3 安装Visual Studio 2022

1.4 在Visual Studio 2022中安装Qt插件

1.5 在Visual Studio 2022中安装大模型编程助手

2. 创建Qt Quick项目

2.1 创建新项目

2.2 项目结构

2.3 运行项目

3. 理解项目代码

3.1 main.cpp文件

3.2 main.qml文件

相关文章：

3.1 `main.cpp`文件

3.2 m`ain.qml`文件