CMake-Qt程序编译

环境

系统：Windows 10专业版
CMake版本：3.31.5
Visual Studio版本：2019
Qt版本：5.15.2

准备工作

1.安装CMake，并确保CMake的运行程序添加到环境变量中；
2.安装Visual Studio 2019，并确保勾选了“使用C++的桌面开发”；
3.安装通信灵码IDE，并登录（非必须，可以用Visual Studio Code代替，或直接用CMD）；
4.安装Qt5，并记住其目录。

操作步骤

1.在“HelloWorld”的基础上，新建以下两个文件：

MainWidget.h

// 和CMakeLists.txt一个目录
#include <QWidget>  // 包含Qt基础窗口部件类

// 自定义窗口部件类，继承自QWidget
class MainWidget : public QWidget
{
    Q_OBJECT  // 启用Qt的信号槽机制

public:
    // 构造函数，parent参数指定父对象，默认为nullptr
    MainWidget(QWidget* parent = nullptr);

};

MainWidget.cpp

// 和CMakeLists.txt一个目录
#include "MainWidget.h"  // 包含MainWidget类声明

#include <QDebug>        // 包含调试输出功能

// MainWidget构造函数实现
// parent: 父窗口部件指针
MainWidget::MainWidget(QWidget* parent)
    : QWidget(parent)  // 调用父类QWidget的构造函数
{
    // 输出当前函数名到调试信息
    qDebug() << __FUNCTION__;
    // 设置窗口大小为100x100像素
    this->resize(100, 100);
}

添加完成，目录结构如下图所示：

2.修改CMakeLists.txt文件，内容如下：

CMakeLists.txt

# 指定所需的最低CMake版本
cmake_minimum_required(VERSION 3.15.0)

# 定义项目名称
project(study_cmake)

# 启用自动MOC功能，Qt的元对象编译器会自动处理包含Q_OBJECT的文件
set(CMAKE_AUTOMOC ON)

# 查找Qt5库，需要Widgets模块
find_package(Qt5 COMPONENTS Widgets REQUIRED)

# 创建可执行文件目标，包含所有源文件和头文件
add_executable(${PROJECT_NAME} main.cpp MainWidget.cpp MainWidget.h)

# 链接Qt5 Widgets库到可执行文件
target_link_libraries(${PROJECT_NAME} PRIVATE Qt5::Widgets)

3.修改main.cpp，内容如下：

main.cpp

// 和CMakeLists.txt一个目录
#include <QApplication>  // 包含Qt应用程序类

#include "MainWidget.h"  // 包含自定义的主窗口部件类

// 应用程序入口函数
int main(int argc, char* argv[])
{
    // 创建QApplication实例，管理应用程序全局状态
    QApplication app(argc, argv);

    // 创建MainWidget实例
    MainWidget w;
    // 显示主窗口
    w.show();

    // 启动事件循环，等待用户交互
    return app.exec();
}

4.点击菜单栏中的“终端”->“新建终端”，然后在命令行中分别执行下面两条命令（等第一条执行完，再执行第二条）：

//终端路径为CMakeLists.txt所在目录
//其中CMAKE_PREFIX_PATH的值请修改成实际安装的目录
cmake -S . -B WIN -DCMAKE_PREFIX_PATH=C:\Qt\5.15.2\msvc2019_64\lib\cmake

cmake --build .\WIN\   

执行成功，如下图所示：