在當今的軟件開發領域，跨平臺應用的需求日益增長，Qt作為一款流行的C++圖形用戶界面庫，因其強大的功能和易用性而備受開發者青睞。與此同時，CLion作為一款專為C/C++打造的強大IDE，提供了豐富的特性和高效的編碼體驗。本文將指導您如何在Windows環境下配置CLion與Qt的集成環境，使您能夠快速開始Qt應用程序的開發。

一、Qt MinGW組件

首先，需要確認您的本地Windows電腦上是否已經安裝了Qt MinGW相關組件。若尚未安裝，請按照以下步驟操作：

1.在您的本地電腦Qt的安裝目錄下，通過如下命令行運行如下命令以喚起Qt維護工具。為了加速下載過程，建議使用國內鏡像源。

// 使用 中國科學技術大學 鏡像喚起 Qt維護工具
.\MaintenanceTool.exe --mirror https://mirrors.ustc.edu.cn/qtproject/
// 使用 清華大學 鏡像喚起 Qt維護工具
.\MaintenanceTool.exe --mirror https://mirrors.tuna.tsinghua.edu.cn/qt/

2. 按照維護工具提供的界面指引，確保已安裝所有必需的Qt版本及組件。請參照以下三張圖核對組件安裝情況。

二、Qt環境變量

為了保證Qt工具鏈能夠在命令行中被正確識別，請確保您的系統環境變量中包含了Qt的安裝路徑。這一步驟對于后續的項目創建至關重要。

三、Clion新建Qt項目

當一切準備就緒后，打開CLion，并根據提示新建一個Qt Widgets Executable項目。

3.1 新建Qt項目

打開CLion，新建Qt Widgets Executable項目：

3.2 配置mingw工具

完成相關創建后，需完成Clion工具鏈環境配置后，才能完成程序的編譯運行。

配置工具鏈：操作步驟File——>Setting——>Toolchains，配置Toolset項為Qt路徑下mingw工具。

3.3 修改main.cpp

1. 修改main.cpp：

#include "mainwindow.h"  #include <QApplication>  int main(int argc, char *argv[])  
{  QApplication a(argc, argv);  MainWindow w;  w.show();  return a.exec();  
}

2. 添加mainwindow.ui：

<?xml version="1.0" encoding="UTF-8"?>
<ui version="4.0"><class>MainWindow</class><widget class="QMainWindow" name="MainWindow"><property name="geometry"><rect><x>0</x><y>0</y><width>800</width><height>600</height></rect></property><property name="windowTitle"><string>MainWindow</string></property><widget class="QWidget" name="centralwidget"><widget class="QWidget" name="gridLayoutWidget"><property name="geometry"><rect><x>190</x><y>80</y><width>160</width><height>80</height></rect></property><layout class="QGridLayout" name="gridLayout"/></widget></widget><widget class="QMenuBar" name="menubar"><property name="geometry"><rect><x>0</x><y>0</y><width>800</width><height>18</height></rect></property></widget><widget class="QStatusBar" name="statusbar"/></widget><resources/><connections/>
</ui>

3. 添加mainwindow.h：

#ifndef MAINWINDOW_H  
#define MAINWINDOW_H  #include <QMainWindow>  QT_BEGIN_NAMESPACE  
namespace Ui {  
class MainWindow;  
}  
QT_END_NAMESPACE  class MainWindow : public QMainWindow  
{  Q_OBJECT  public:  MainWindow(QWidget *parent = nullptr);  ~MainWindow();  private:  Ui::MainWindow *ui;  
};  
#endif // MAINWINDOW_H

4. 添加mainwindow.cpp：

#include "mainwindow.h"  
#include "./ui_mainwindow.h"  MainWindow::MainWindow(QWidget *parent)  : QMainWindow(parent)  , ui(new Ui::MainWindow)  
{  ui->setupUi(this);  
}  MainWindow::~MainWindow()  
{  delete ui;  
}

3.4 修改CMakeLists.txt

參照下方代碼，修改現有的CMakeLists.txt文件代碼：

# 指定 CMake 的最低版本要求為 3.23
cmake_minimum_required(VERSION 3.23.2)
# 定義項目的名稱為 "CLion_Qt_Demo"
project(CLion_Qt_Demo)# 開啟自動處理UI文件的功能，讓CMake自動將.ui文件轉換為對應的C++代碼
set(CMAKE_AUTOUIC ON)
# 開啟自動處理MOC（Meta-Object Compiler）的功能，用于處理Qt的信號槽機制相關代碼生成
set(CMAKE_AUTOMOC ON)
# 開啟自動處理RCC（Resource Compiler）的功能，用于處理資源文件（如圖片、樣式表等）
set(CMAKE_AUTORCC ON)# 設置 C++ 編譯標準為 C++17
set(CMAKE_CXX_STANDARD 17)
# 要求必須使用指定的C++標準，若不滿足則構建失敗
set(CMAKE_CXX_STANDARD_REQUIRED ON)# Qt
# 設置CMAKE_PREFIX_PATH環境變量：指向了Qt安裝目錄，用于幫助CMake找到Qt庫。
set(CMAKE_PREFIX_PATH D:/Program/Qt/6.8.1/mingw_64)
# 查找 Qt6 庫并配置其組件。這里指定了需要 Core、Gui 和 Widgets 組件，并且是必須的 (REQUIRED)。
# 如果找不到指定的組件，CMake 配置過程將會失敗。
find_package(Qt6 COMPONENTSCoreGuiWidgetsREQUIRED)# 定義項目源文件列表，包含主函數源文件、主窗口源文件、主窗口頭文件和主窗口UI文件
set(PROJECT_SOURCESmain.cppmainwindow.cppmainwindow.hmainwindow.ui)
add_executable(CLion_Qt_Demo${PROJECT_SOURCES})# 將 Qt6 的 Core、Gui 和 Widgets 庫鏈接到名為 "CLion_Qt_Demo" 的可執行文件上。
# 這使得在編譯時可以訪問 Qt 提供的功能，并且在運行時與這些庫鏈接。
target_link_libraries(CLion_Qt_DemoQt6::CoreQt6::GuiQt6::Widgets
)

3.5 運行Qt程序:

經過上述步驟，已成功的在Windows環境中配置好了CLion與Qt的開發環境。現在，可以嘗試運行一下的Qt程序，看看是否能夠正常顯示UI界面，以此驗證配置是否正確。