1. 从“Hello Qt”开始为什么选择Qt 6如果你刚接触Qt或者从Qt 5迁移过来面对Qt 6的第一个问题往往是我该怎么开始一个项目是像教科书一样用命令行编译还是在Qt Creator里点几下鼠标不同的方法背后其实对应着不同的开发场景和认知路径。很多人上来就跟着教程用Qt Creator的向导点几下生成了一个带UI的窗口程序跑起来很有成就感但关掉IDE后可能连项目文件结构都说不清楚更别提手动编译和部署了。这就是我想写这篇内容的原因。我不打算只给你一个“点击这里下一步”的教程而是想带你从三个不同的维度亲手把Qt 6的应用“造”出来。这三种方法分别是使用Qt Creator的图形化向导最快捷、手动编写CMakeLists.txt最透彻、以及使用qmake最经典但已非主流。我们会从最简单的“Hello World”命令行程序开始逐步过渡到带窗口的GUI应用并在最后我会重点带你搞清楚一个让很多新手困惑的问题编译生成的那个可执行文件到底怎样才能在别人的电脑上独立运行这个过程里你会理解.pro文件、CMakeLists.txt、main.cpp以及Qt核心模块之间的关系而不是仅仅记住点击顺序。选择Qt 6作为起点是明智的。Qt 6是Qt框架的一个重要分水岭它解决了许多Qt 5的历史包袱在模块化、性能和对现代C标准的支持上都上了一个台阶。当然对于新手你可能会听到一些关于“Qt 6的某些模块还不稳定”或“第三方库支持不够”的讨论但对于学习核心的GUI编程和应用创建来说Qt 6的API更清晰文档也更好直接从Qt 6入门可以避免先学一套过时理念再迁移的麻烦。接下来我们就从最直观、最省心的方式开始。2. 方法一Qt Creator向导——五分钟创建可运行的应用这是绝大多数人包括我刚开始时接触Qt的第一种方式。Qt Creator是Qt官方推荐的集成开发环境IDE它把项目创建、代码编辑、构建和调试都集成在了一起对新手极其友好。它的核心价值在于“开箱即用”你不需要关心编译器路径、库文件链接这些底层细节可以专注于代码逻辑本身。2.1 项目类型选择与初始配置安装好Qt 6和Qt Creator后打开它你会看到欢迎界面。点击“New Project”新建项目或者通过菜单栏的“File”-“New File or Project...”进入项目创建向导。这时你会看到一个项目模板选择界面。这里的选择决定了你项目的起点骨架。对于纯粹的学习和大多数桌面应用我推荐从这两个模板开始Qt Widgets Application这是创建传统桌面GUI应用的标准选择。它基于经典的QWidget控件体系你可以通过拖拽的方式设计界面使用Qt Designer适合需要复杂自定义控件、对界面像素级控制或有大量遗留代码的项目。我们第一个GUI应用就用它。Qt Console Application如果你想创建一个没有图形界面、只在控制台命令行窗口输入输出的程序就选这个。它是学习C和Qt核心库非GUI部分的绝佳起点排除了界面干扰。我们的“Hello World”就从这里开始。这里有一个关键的细节在模板选择后Qt Creator会要求你设置项目的“构建系统”。在Qt 6中CMake是官方首推且未来的方向而qmake是传统的构建系统目前仍在维护但已不推荐用于新项目。所以请毫不犹豫地选择CMake。这一步的选择直接决定了你项目根目录下生成的是CMakeLists.txt文件还是.pro文件。接下来你需要为项目命名例如HelloQtConsole选择源码存放路径然后进入“Kit Selection”套件选择界面。这里你需要选择一个配置好的“Kit”它本质上是一套编译工具链编译器、Qt版本、调试器等的集合。确保你选择的Kit中Qt版本是Qt 6.x例如Qt 6.5.3 MinGW 64-bit。如果这里没有可选的Kit说明你的Qt安装或环境配置可能有问题需要回头检查。2.2 理解生成的项目骨架点击“Finish”后Qt Creator会自动为你生成项目文件并打开。对于一个控制台应用生成的文件非常简单CMakeLists.txt: 项目的构建脚本CMake用它来生成你本地IDE如Makefile或Visual Studio项目所需的构建文件。这是项目的“总指挥”。main.cpp: 程序的入口源文件。我们打开CMakeLists.txt看一眼它可能长这样cmake_minimum_required(VERSION 3.16) project(HelloQtConsole VERSION 0.1 LANGUAGES CXX) set(CMAKE_CXX_STANDARD 17) set(CMAKE_CXX_STANDARD_REQUIRED ON) find_package(Qt6 REQUIRED COMPONENTS Core) qt_standard_project_setup() qt_add_executable(HelloQtConsole main.cpp ) target_link_libraries(HelloQtConsole PRIVATE Qt6::Core)我来逐行解释一下这对你后续手动编写CMakeLists.txt至关重要cmake_minimum_required(VERSION 3.16)指定构建本项目所需CMake的最低版本。Qt 6通常需要CMake 3.16或更高。project(...)定义项目名称、版本和编程语言CXX代表C。set(CMAKE_CXX_STANDARD 17)指定使用C17标准。Qt 6大量运用了现代C特性。find_package(Qt6 REQUIRED COMPONENTS Core)这是关键命令。它告诉CMake去查找Qt 6的安装包并且是“必需”的。COMPONENTS Core指定我们需要链接Qt6Core这个核心模块。如果后续需要GUI这里就要加上Widgets。qt_add_executable(...)定义一个名为HelloQtConsole的可执行文件目标它的源代码包含main.cpp。target_link_libraries(... PRIVATE Qt6::Core)将可执行文件目标与Qt6::Core库进行链接。PRIVATE意味着这个链接关系仅作用于当前目标。再看main.cpp它通常是一个最简单的框架#include QCoreApplication #include QDebug int main(int argc, char *argv[]) { QCoreApplication a(argc, argv); qDebug() Hello, Qt!; return a.exec(); }#include QCoreApplication对于控制台程序我们需要QCoreApplication来管理应用的事件循环虽然简单程序可能用不到事件循环但这是一个好习惯。QCoreApplication a(argc, argv);创建应用对象。qDebug() ...;使用Qt提供的调试输出流打印信息比std::cout更强大能自动处理空格和换行并且在不同平台输出到合适的流。return a.exec();启动应用的事件循环。对于控制台程序如果没有需要处理的事件如信号槽、定时器程序会立即返回。但写上它是标准的做法。现在点击Qt Creator左下角的绿色三角运行按钮或按CtrlR你就能在IDE下方的“应用程序输出”面板看到“Hello, Qt!”了。整个过程你几乎没有写一行配置代码这就是Qt Creator向导的魅力——它帮你屏蔽了所有底层复杂度。2.3 从控制台到窗口创建第一个Widgets应用理解了控制台应用创建GUI应用就水到渠成了。我们再通过向导创建一个“Qt Widgets Application”。流程类似在模板选择时选“Qt Widgets Application”构建系统依然选CMake。生成后你会发现文件变多了CMakeLists.txt内容更丰富了find_package中多了Widgets组件qt_add_executable里可能多了mainwindow.cpp等文件。main.cpp入口文件现在创建的是QApplication对象GUI程序专用和MainWindow对象。mainwindow.h/mainwindow.cpp主窗口类的头文件和实现文件。mainwindow.ui这是一个XML格式的UI文件你可以用Qt Creator内置的Qt Designer双击打开它以拖拽的方式设计界面。这是Qt的核心优势之一——将界面设计与业务逻辑分离。我们重点关注CMakeLists.txt的变化... find_package(Qt6 REQUIRED COMPONENTS Core Widgets) # 增加了Widgets组件 ... qt_add_executable(HelloQtWidgets main.cpp mainwindow.cpp mainwindow.h mainwindow.ui # UI文件也被列为源文件构建时会自动处理 ) ... target_link_libraries(HelloQtWidgets PRIVATE Qt6::Core Qt6::Widgets) # 链接了Widgets库注意UI文件.ui也被列在了qt_add_executable里。CMake和Qt的集成工具qt6_wrap_ui通常被qt_add_executable自动调用会在构建过程中将.ui文件编译成对应的C头文件通常是ui_mainwindow.h这样你在代码中就可以通过ui对象来访问和操作界面上的控件了。运行这个Widgets应用一个空白的窗口就弹出来了。你可以尝试在Qt Designer里拖一个按钮Push Button到窗口上保存然后直接运行无需任何额外代码就能看到按钮出现在窗口中。这是因为mainwindow.cpp的构造函数里有一句ui-setupUi(this);它自动完成了UI文件的加载和控件创建。注意使用Qt Creator向导时它默认可能会为你勾选“创建版本控制仓库”如Git。如果你暂时不需要记得取消勾选避免在项目根目录生成.git文件夹。另外项目路径和名称最好不要包含中文或空格虽然Qt本身支持但某些底层工具链尤其是Windows下的MinGW可能会因此出现难以排查的路径问题。3. 方法二手动编写CMakeLists.txt——彻底掌握构建过程依赖向导很方便但它像是一个黑盒。如果你想真正理解Qt项目是如何组织、如何被构建的或者你需要将Qt集成到一个已有的、复杂的CMake项目中那么亲手从零开始编写CMakeLists.txt是必经之路。这个过程能让你对项目的依赖关系、构建步骤有颗粒度的掌控。3.1 从零搭建一个纯CMake项目结构我们抛开Qt Creator只用文本编辑器如VS Code和命令行来创建一个同样的“Hello Qt”控制台程序。首先创建一个全新的空文件夹例如manual_qt_project。在里面创建两个文件CMakeLists.txt和main.cpp。main.cpp的内容和之前一样#include QCoreApplication #include QDebug int main(int argc, char *argv[]) { QCoreApplication app(argc, argv); qDebug() Hello from manual CMake project!; return app.exec(); }接下来是重头戏我们手动编写CMakeLists.txt# 1. 指定CMake最低版本要求 cmake_minimum_required(VERSION 3.16) # 2. 定义项目名称、版本和语言 project(ManualHelloQt VERSION 0.1.0 LANGUAGES CXX) # 3. 设置C标准 set(CMAKE_CXX_STANDARD 17) set(CMAKE_CXX_STANDARD_REQUIRED ON) # 4. 自动包含Qt提供的CMake工具函数和宏 # 这行非常重要它提供了qt_add_executable, qt_add_library等专用命令 include(GNUInstallDirs) # 通常Qt的find_package需要这个虽然不是必须 find_package(Qt6 REQUIRED COMPONENTS Core) # 5. 启用CMake的自动处理功能MOC, UIC, RCC # 对于纯控制台程序可能不需要但加上是好习惯为后续添加GUI做准备 set(CMAKE_AUTOMOC ON) set(CMAKE_AUTUIC ON) set(CMAKE_AUTORCC ON) # 6. 定义可执行文件目标 add_executable(${PROJECT_NAME} main.cpp ) # 7. 链接Qt库到目标 target_link_libraries(${PROJECT_NAME} PRIVATE Qt6::Core) # 8. 设置目标属性可选但推荐 # 在Windows上让可执行文件子系统为控制台这样运行时才会弹出控制台窗口显示qDebug输出 if (WIN32) set_target_properties(${PROJECT_NAME} PROPERTIES WIN32_EXECUTABLE FALSE ) endif()这个CMakeLists.txt比向导生成的更详细我加入了一些解释和最佳实践。关键点在于第4步的find_package和第7步的target_link_libraries。find_package会去系统环境变量CMAKE_PREFIX_PATH或者Qt安装目录下寻找Qt6的配置包。如果你在命令行构建时发现找不到Qt6通常需要手动设置这个路径例如cmake -B build -DCMAKE_PREFIX_PATH/path/to/your/qt6/installation。3.2 配置、构建与测试有了这两个文件我们就可以在命令行中进行“配置-构建”了。这是标准的CMake跨平台构建流程生成构建系统在项目根目录manual_qt_project下打开终端命令行执行cmake -B build这个命令告诉CMake在build子目录下生成构建系统文件如Unix下的Makefile或Windows下的Visual Studio解决方案。-B是指定构建目录。CMake会根据CMakeLists.txt和当前系统环境检测编译器、查找Qt等依赖。编译项目上一步成功后进入build目录或者使用CMake的--build选项进行编译cmake --build build或者cd build make # 在Linux/macOS上 # 或者在Windows上如果你用的是Visual Studio生成器则使用 # cmake --build . --config Release运行程序编译成功后在build目录或它的子目录如Debug或Release下你会找到生成的可执行文件如ManualHelloQt.exe或ManualHelloQt。直接在命令行运行它# 在build目录下 ./ManualHelloQt # Linux/macOS # 或者 .\ManualHelloQt.exe # Windows你应该能看到“Hello from manual CMake project!”的输出。这个过程看似比点一下“运行”按钮复杂但它揭示了构建的本质CMake是一个构建系统生成器它本身不编译代码而是根据你的CMakeLists.txt生成你本地环境如Make, Ninja, MSBuild认识的构建脚本再由这些本地工具去调用编译器进行编译。3.3 添加GUI模块与资源文件现在我们升级这个手动项目把它变成一个带有简单窗口和图标的应用这涉及到添加新的Qt模块和资源。首先修改main.cpp创建一个窗口#include QApplication #include QPushButton #include QWidget int main(int argc, char *argv[]) { QApplication app(argc, argv); QWidget window; window.setWindowTitle(Manual Qt Window); window.resize(400, 300); QPushButton button(Click Me!, window); button.move(150, 130); window.show(); return app.exec(); }然后更新CMakeLists.txt。我们需要找到并链接Widgets模块并且因为代码中直接使用了QWidget和QPushButton所以需要包含对应的头文件不过CMake的AUTOMOC和链接库会处理好这些。cmake_minimum_required(VERSION 3.16) project(ManualQtWidgets VERSION 0.1.0 LANGUAGES CXX) set(CMAKE_CXX_STANDARD 17) set(CMAKE_CXX_STANDARD_REQUIRED ON) # 关键修改在COMPONENTS中增加Widgets find_package(Qt6 REQUIRED COMPONENTS Core Widgets) set(CMAKE_AUTOMOC ON) set(CMAKE_AUTOUIC ON) set(CMAKE_AUTORCC ON) add_executable(${PROJECT_NAME} main.cpp ) # 关键修改链接Qt6::Widgets库 target_link_libraries(${PROJECT_NAME} PRIVATE Qt6::Core Qt6::Widgets) # 不再需要设置WIN32_EXECUTABLE因为QApplication默认就是GUI程序重新执行cmake -B build和cmake --build build运行生成的可执行文件一个带按钮的窗口就出现了。实操心得手动编写CMakeLists.txt时最常见的错误就是find_package找不到Qt。除了设置CMAKE_PREFIX_PATH还要确保你的Qt安装是完整的并且包含对应架构如x64的库。在Windows上如果你安装了多个Qt版本或多个编译器套件如MSVC和MinGW它们之间是不能混用的必须用对应编译器套件下的Qt。一个检查方法是在Qt安装目录的bin文件夹下运行qmake -v查看其输出的Qt版本和编译器信息是否与你当前使用的CMake生成器匹配。4. 方法三使用qmake——理解传统Qt项目的构建逻辑尽管Qt 6官方推荐CMake但qmake作为Qt亲生的构建工具历史悠久有海量的遗留项目包括Qt自身的一部分仍在使用它。了解qmake不仅能帮助你维护老项目也能让你更深刻地理解Qt项目的元信息是如何被组织的。qmake的核心是一个名为.pro项目的配置文件。4.1 .pro文件语法与核心指令qmake的配置文件.pro其语法比CMakeLists.txt更简洁更专注于Qt生态。我们创建一个hello_qmake.pro文件和一个简单的main.cpp。main.cpp还是用之前的控制台版本。hello_qmake.pro文件内容如下# 注释以‘#’开头 # 1. 指定生成的目标类型和名称 TEMPLATE app # app 表示生成可执行程序lib表示库 TARGET HelloQmake # 生成的可执行文件名称 # 2. 指定Qt要使用的模块 # 对于控制台程序只需要core QT core # 如果是GUI程序则需要QT core gui widgets # 注意在Qt 5及以后gui和widgets模块通常是分开的widgets依赖于gui。 # 3. 指定C标准 CONFIG c17 # 4. 指定源文件 SOURCES main.cpp # 5. 指定头文件可选qmake会自动扫描依赖但显式声明更好 HEADERS # 6. 其他配置 # CONFIG console # 在Windows上确保生成控制台子系统程序对于非Qt GUI程序 # 对于Qt GUI程序QApplication则不需要console否则会弹出两个窗口一个控制台一个GUI。这个.pro文件非常直白TEMPLATE定义输出类型TARGET定义名字QT指定模块SOURCES和HEADERS列出文件。CONFIG用于进行各种配置比如C标准、是否启用调试信息等。4.2 使用qmake生成Makefile并构建使用qmake构建的过程通常是两步生成Makefile在终端中进入包含.pro文件的目录运行qmake或者如果你安装了多个Qt版本可能需要指定完整路径或者使用qmake -qtqt6来确保调用的是Qt 6的qmake。这个命令会读取.pro文件并根据当前系统环境生成一个Makefile在Windows上可能是Makefile.Release和Makefile.Debug。执行make进行编译上一步成功后直接运行makeLinux/macOS或nmakeWindows MSVC或mingw32-makeWindows MinGWmake编译完成后会在当前目录或release/debug子目录下生成可执行文件HelloQmake。4.3 qmake与CMake的对比与迁移考量为什么Qt要转向CMake了解它们的差异有助于你做出选择生态与通用性CMake是业界的事实标准拥有庞大的生态几乎所有的C/C开源库都支持CMake。使用CMake你的Qt项目可以更容易地集成非Qt的第三方库如Boost, OpenCV。qmake则基本局限于Qt生态内部。功能与灵活性CMake的功能更强大、更底层可以描述极其复杂的构建逻辑、条件编译、自定义目标等。qmake语法简单但对于复杂项目其脚本可能变得难以维护。学习曲线qmake对于纯Qt项目入门更简单。CMake学习曲线更陡峭但一旦掌握受益无穷。Qt官方支持Qt 6开始CMake是官方一等公民新特性和优化会优先在CMake上体现。qmake虽然仍被支持但已不再是未来发展的重点。对于新项目毫无悬念应该选择CMake。对于已有的qmake项目除非项目非常简单且没有集成其他库的需求否则建议制定计划向CMake迁移。迁移通常不是直接翻译而是需要重新设计构建逻辑但核心的源文件是不变的。注意事项在qmake项目中如果你使用了Qt的元对象系统信号槽、属性等你需要确保在SOURCES中列出了对应的.cpp文件qmake会自动调用moc元对象编译器工具来生成必要的代码。如果遇到“undefined reference to vtable”这类链接错误很可能是某个类的头文件没有Q_OBJECT宏或者moc没有正确运行可以尝试执行qmake后重新make clean再make。5. 可执行文件的生成、依赖与部署实战当你成功编译出一个Qt应用兴奋地点开生成的可执行文件.exe或无后缀文件却可能弹出一堆错误比如“无法找到Qt6Core.dll”或“程序异常退出”。这是因为你的可执行文件在运行时需要动态链接到Qt的库文件DLL或.so。这些库文件在你开发机的Qt安装目录下但到了没有安装Qt的目标机器上就找不到了。解决这个问题的过程就是“部署”。5.1 理解动态链接与依赖关系Qt默认采用动态链接Dynamic Linking。这意味着你的程序文件本身并不包含Qt库的代码只包含了调用这些库的“线索”。当程序运行时操作系统确切地说是动态链接器/加载器会根据这些线索去系统的特定路径如Windows的应用程序所在目录、PATH环境变量指向的目录、系统目录Linux的/usr/libLD_LIBRARY_PATH等查找对应的库文件如Qt6Core.dll,libQt6Core.so。你可以使用工具来查看可执行文件的依赖Windows使用Dependency Walker老牌或微软自家的dumpbin /dependents your_app.exe命令。Linux使用ldd your_app命令。macOS使用otool -L your_app命令。运行这些命令你会看到一长串依赖除了Qt自身的库Qt6Core,Qt6Gui,Qt6Widgets等可能还有C运行时库如msvcp140.dll,vcruntime140.dll、平台相关库如windowsapp.dll等。5.2 手动部署将程序“打包”到新环境手动部署是最基础、最直观的方式适合小型项目或快速测试。核心思想是将程序运行所需的所有动态库文件复制到可执行文件所在的同一目录下。Windows有一个特性当加载一个可执行文件时会首先在其所在目录查找所需的DLL。步骤分解找到你的Qt安装目录。通常类似C:\Qt\6.5.3\mingw_64Windows MinGW或/home/user/Qt/6.5.3/gcc_64Linux。定位bin和plugins目录。bin目录下有Qt的核心DLL如Qt6Core.dll和重要的工具程序如windeployqt。plugins目录下有平台插件、图像格式插件等。使用windeployqt工具Windows。这是Qt官方提供的部署工具能自动分析你的.exe文件并将其依赖的Qt库、插件等复制到目标目录。这是最推荐的手动部署方法。首先将你的Release版本的可执行文件例如MyApp.exe复制到一个新的空文件夹比如MyAppDeploy。然后打开Qt 6.5.3 MinGW 64-bit命令行在开始菜单的Qt目录下可以找到这个环境已经配置好了Qt的路径。切换到MyAppDeploy目录cd /d D:\path\to\MyAppDeploy执行部署命令windeployqt MyApp.exe工具会自动运行将所需的Qt库、插件、翻译文件等复制到当前目录。它甚至会尝试处理OpenGL和ANGLE的依赖。处理非Qt依赖。windeployqt只负责Qt自身的依赖。你还需要处理C运行时库。对于MinGW通常需要libgcc_s_seh-1.dll,libstdc-6.dll,libwinpthread-1.dll它们位于MinGW的bin目录下例如C:\Qt\Tools\mingw1120_64\bin。对于MSVC你需要安装对应的“Visual C Redistributable”运行库或者将msvcp140.dll,vcruntime140.dll等文件也一并复制注意版权和分发许可。一个简单的方法是在开发机上运行你的程序如果报错缺少某个DLL就从系统或编译器目录找到它并复制过来。测试。将整个MyAppDeploy文件夹复制到一台没有安装Qt和开发环境的纯净Windows机器上直接双击MyApp.exe看是否能正常运行。对于Linux和macOS情况略有不同。Linux下通常将程序安装到/usr/local目录下并确保库路径正确或者使用patchelf工具修改可执行文件的RPATH使其在相对路径下查找库。macOS下则需要构建.appbundle将库文件放入MyApp.app/Contents/Frameworks目录并使用macdeployqt工具类似windeployqt和install_name_tool来修正依赖路径。这些操作更为复杂通常与打包工具如Linux的AppImage、Snap macOS的dmg制作结合进行。5.3 静态编译一劳永逸的终极方案既然动态链接这么麻烦能不能把Qt库直接“塞进”可执行文件里可以这就是静态编译Static Linking。你需要从源码开始用特定的配置参数编译一个静态版本的Qt库然后用这个静态库去编译你的程序。这样生成的可执行文件会非常大因为它包含了所有用到的Qt代码但好处是它几乎可以独立运行依赖极少可能只需要系统C库。为什么不总是用静态编译许可问题Qt有LGPL和商业许可证。如果你静态链接LGPL版本的Qt根据协议你可能需要以某种方式提供你的应用程序的源代码或目标文件以便用户可以重新链接。动态链接则更容易满足LGPL的要求。商业许可证则没有这个限制。文件体积可执行文件会变得非常庞大。更新困难如果Qt发现安全漏洞需要更新你必须重新编译并分发整个巨大的可执行文件而不是替换一个小的DLL。编译耗时从源码编译Qt本身就是一个耗时巨大的工程。因此静态编译通常用于特定场景如发布一个极简的、对依赖极度敏感的单文件工具或者是在有商业许可保障下的闭源分发。5.4 使用高级工具进行专业化打包对于正式的产品发布手动复制文件显得原始且容易出错。更专业的做法是使用安装包制作工具或应用打包工具WindowsInno Setup,NSIS: 老牌且强大的安装包制作工具。你可以编写脚本在安装过程中将程序文件、依赖库、开始菜单快捷方式等部署到用户电脑的指定位置。它们不负责分析依赖你需要自己确保所有文件都被包含进去。Advanced Installer: 功能更全的商业软件有图形界面。Qt Installer Framework: Qt官方提供的安装框架功能强大可以创建带在线更新功能的安装包学习曲线较陡。跨平台CMakeCPack: 如果你使用CMake可以配合CPack模块生成各种格式的安装包如ZIP, NSIS, DEB, RPM等。你需要编写额外的CMake脚本定义安装规则install命令。jom和windeployqt结合脚本可以编写批处理或Python脚本自动化构建、调用windeployqt、收集文件、打包成ZIP的过程。一个常见的半自动化流程是使用CMake构建Release版本 - 将可执行文件复制到发布目录 - 调用windeployqt处理Qt依赖 - 手动或脚本复制其他第三方DLL - 使用Inno Setup或CPack生成安装包。踩坑实录部署时最常遇到的几个坑1)Debug与Release版本混用千万不要把Debug版的Qt库如Qt6Cored.dll拿去部署Release版程序反之亦然。这会导致奇怪的崩溃。确保你部署的是Release构建的产物。2)插件丢失程序能启动但图片加载不了或者样式异常可能是缺少imageformats或platforms插件。windeployqt通常会帮你复制plugins目录下的必要插件。3)VC运行库在目标机器上如果使用MSVC编译务必确保安装了对应版本的Visual C Redistributable或者将msvcp140.dll等文件随包分发需注意许可。4)路径问题程序中如果使用了相对路径访问资源文件如图标、配置文件在部署后当前工作目录可能变化导致找不到文件。建议使用QCoreApplication::applicationDirPath()来获取可执行文件所在目录并以此为基础构建资源文件的绝对路径。
1. 从“Hello Qt”开始为什么选择Qt 6如果你刚接触Qt或者从Qt 5迁移过来面对Qt 6的第一个问题往往是我该怎么开始一个项目是像教科书一样用命令行编译还是在Qt Creator里点几下鼠标不同的方法背后其实对应着不同的开发场景和认知路径。很多人上来就跟着教程用Qt Creator的向导点几下生成了一个带UI的窗口程序跑起来很有成就感但关掉IDE后可能连项目文件结构都说不清楚更别提手动编译和部署了。这就是我想写这篇内容的原因。我不打算只给你一个“点击这里下一步”的教程而是想带你从三个不同的维度亲手把Qt 6的应用“造”出来。这三种方法分别是使用Qt Creator的图形化向导最快捷、手动编写CMakeLists.txt最透彻、以及使用qmake最经典但已非主流。我们会从最简单的“Hello World”命令行程序开始逐步过渡到带窗口的GUI应用并在最后我会重点带你搞清楚一个让很多新手困惑的问题编译生成的那个可执行文件到底怎样才能在别人的电脑上独立运行这个过程里你会理解.pro文件、CMakeLists.txt、main.cpp以及Qt核心模块之间的关系而不是仅仅记住点击顺序。选择Qt 6作为起点是明智的。Qt 6是Qt框架的一个重要分水岭它解决了许多Qt 5的历史包袱在模块化、性能和对现代C标准的支持上都上了一个台阶。当然对于新手你可能会听到一些关于“Qt 6的某些模块还不稳定”或“第三方库支持不够”的讨论但对于学习核心的GUI编程和应用创建来说Qt 6的API更清晰文档也更好直接从Qt 6入门可以避免先学一套过时理念再迁移的麻烦。接下来我们就从最直观、最省心的方式开始。2. 方法一Qt Creator向导——五分钟创建可运行的应用这是绝大多数人包括我刚开始时接触Qt的第一种方式。Qt Creator是Qt官方推荐的集成开发环境IDE它把项目创建、代码编辑、构建和调试都集成在了一起对新手极其友好。它的核心价值在于“开箱即用”你不需要关心编译器路径、库文件链接这些底层细节可以专注于代码逻辑本身。2.1 项目类型选择与初始配置安装好Qt 6和Qt Creator后打开它你会看到欢迎界面。点击“New Project”新建项目或者通过菜单栏的“File”-“New File or Project...”进入项目创建向导。这时你会看到一个项目模板选择界面。这里的选择决定了你项目的起点骨架。对于纯粹的学习和大多数桌面应用我推荐从这两个模板开始Qt Widgets Application这是创建传统桌面GUI应用的标准选择。它基于经典的QWidget控件体系你可以通过拖拽的方式设计界面使用Qt Designer适合需要复杂自定义控件、对界面像素级控制或有大量遗留代码的项目。我们第一个GUI应用就用它。Qt Console Application如果你想创建一个没有图形界面、只在控制台命令行窗口输入输出的程序就选这个。它是学习C和Qt核心库非GUI部分的绝佳起点排除了界面干扰。我们的“Hello World”就从这里开始。这里有一个关键的细节在模板选择后Qt Creator会要求你设置项目的“构建系统”。在Qt 6中CMake是官方首推且未来的方向而qmake是传统的构建系统目前仍在维护但已不推荐用于新项目。所以请毫不犹豫地选择CMake。这一步的选择直接决定了你项目根目录下生成的是CMakeLists.txt文件还是.pro文件。接下来你需要为项目命名例如HelloQtConsole选择源码存放路径然后进入“Kit Selection”套件选择界面。这里你需要选择一个配置好的“Kit”它本质上是一套编译工具链编译器、Qt版本、调试器等的集合。确保你选择的Kit中Qt版本是Qt 6.x例如Qt 6.5.3 MinGW 64-bit。如果这里没有可选的Kit说明你的Qt安装或环境配置可能有问题需要回头检查。2.2 理解生成的项目骨架点击“Finish”后Qt Creator会自动为你生成项目文件并打开。对于一个控制台应用生成的文件非常简单CMakeLists.txt: 项目的构建脚本CMake用它来生成你本地IDE如Makefile或Visual Studio项目所需的构建文件。这是项目的“总指挥”。main.cpp: 程序的入口源文件。我们打开CMakeLists.txt看一眼它可能长这样cmake_minimum_required(VERSION 3.16) project(HelloQtConsole VERSION 0.1 LANGUAGES CXX) set(CMAKE_CXX_STANDARD 17) set(CMAKE_CXX_STANDARD_REQUIRED ON) find_package(Qt6 REQUIRED COMPONENTS Core) qt_standard_project_setup() qt_add_executable(HelloQtConsole main.cpp ) target_link_libraries(HelloQtConsole PRIVATE Qt6::Core)我来逐行解释一下这对你后续手动编写CMakeLists.txt至关重要cmake_minimum_required(VERSION 3.16)指定构建本项目所需CMake的最低版本。Qt 6通常需要CMake 3.16或更高。project(...)定义项目名称、版本和编程语言CXX代表C。set(CMAKE_CXX_STANDARD 17)指定使用C17标准。Qt 6大量运用了现代C特性。find_package(Qt6 REQUIRED COMPONENTS Core)这是关键命令。它告诉CMake去查找Qt 6的安装包并且是“必需”的。COMPONENTS Core指定我们需要链接Qt6Core这个核心模块。如果后续需要GUI这里就要加上Widgets。qt_add_executable(...)定义一个名为HelloQtConsole的可执行文件目标它的源代码包含main.cpp。target_link_libraries(... PRIVATE Qt6::Core)将可执行文件目标与Qt6::Core库进行链接。PRIVATE意味着这个链接关系仅作用于当前目标。再看main.cpp它通常是一个最简单的框架#include QCoreApplication #include QDebug int main(int argc, char *argv[]) { QCoreApplication a(argc, argv); qDebug() Hello, Qt!; return a.exec(); }#include QCoreApplication对于控制台程序我们需要QCoreApplication来管理应用的事件循环虽然简单程序可能用不到事件循环但这是一个好习惯。QCoreApplication a(argc, argv);创建应用对象。qDebug() ...;使用Qt提供的调试输出流打印信息比std::cout更强大能自动处理空格和换行并且在不同平台输出到合适的流。return a.exec();启动应用的事件循环。对于控制台程序如果没有需要处理的事件如信号槽、定时器程序会立即返回。但写上它是标准的做法。现在点击Qt Creator左下角的绿色三角运行按钮或按CtrlR你就能在IDE下方的“应用程序输出”面板看到“Hello, Qt!”了。整个过程你几乎没有写一行配置代码这就是Qt Creator向导的魅力——它帮你屏蔽了所有底层复杂度。2.3 从控制台到窗口创建第一个Widgets应用理解了控制台应用创建GUI应用就水到渠成了。我们再通过向导创建一个“Qt Widgets Application”。流程类似在模板选择时选“Qt Widgets Application”构建系统依然选CMake。生成后你会发现文件变多了CMakeLists.txt内容更丰富了find_package中多了Widgets组件qt_add_executable里可能多了mainwindow.cpp等文件。main.cpp入口文件现在创建的是QApplication对象GUI程序专用和MainWindow对象。mainwindow.h/mainwindow.cpp主窗口类的头文件和实现文件。mainwindow.ui这是一个XML格式的UI文件你可以用Qt Creator内置的Qt Designer双击打开它以拖拽的方式设计界面。这是Qt的核心优势之一——将界面设计与业务逻辑分离。我们重点关注CMakeLists.txt的变化... find_package(Qt6 REQUIRED COMPONENTS Core Widgets) # 增加了Widgets组件 ... qt_add_executable(HelloQtWidgets main.cpp mainwindow.cpp mainwindow.h mainwindow.ui # UI文件也被列为源文件构建时会自动处理 ) ... target_link_libraries(HelloQtWidgets PRIVATE Qt6::Core Qt6::Widgets) # 链接了Widgets库注意UI文件.ui也被列在了qt_add_executable里。CMake和Qt的集成工具qt6_wrap_ui通常被qt_add_executable自动调用会在构建过程中将.ui文件编译成对应的C头文件通常是ui_mainwindow.h这样你在代码中就可以通过ui对象来访问和操作界面上的控件了。运行这个Widgets应用一个空白的窗口就弹出来了。你可以尝试在Qt Designer里拖一个按钮Push Button到窗口上保存然后直接运行无需任何额外代码就能看到按钮出现在窗口中。这是因为mainwindow.cpp的构造函数里有一句ui-setupUi(this);它自动完成了UI文件的加载和控件创建。注意使用Qt Creator向导时它默认可能会为你勾选“创建版本控制仓库”如Git。如果你暂时不需要记得取消勾选避免在项目根目录生成.git文件夹。另外项目路径和名称最好不要包含中文或空格虽然Qt本身支持但某些底层工具链尤其是Windows下的MinGW可能会因此出现难以排查的路径问题。3. 方法二手动编写CMakeLists.txt——彻底掌握构建过程依赖向导很方便但它像是一个黑盒。如果你想真正理解Qt项目是如何组织、如何被构建的或者你需要将Qt集成到一个已有的、复杂的CMake项目中那么亲手从零开始编写CMakeLists.txt是必经之路。这个过程能让你对项目的依赖关系、构建步骤有颗粒度的掌控。3.1 从零搭建一个纯CMake项目结构我们抛开Qt Creator只用文本编辑器如VS Code和命令行来创建一个同样的“Hello Qt”控制台程序。首先创建一个全新的空文件夹例如manual_qt_project。在里面创建两个文件CMakeLists.txt和main.cpp。main.cpp的内容和之前一样#include QCoreApplication #include QDebug int main(int argc, char *argv[]) { QCoreApplication app(argc, argv); qDebug() Hello from manual CMake project!; return app.exec(); }接下来是重头戏我们手动编写CMakeLists.txt# 1. 指定CMake最低版本要求 cmake_minimum_required(VERSION 3.16) # 2. 定义项目名称、版本和语言 project(ManualHelloQt VERSION 0.1.0 LANGUAGES CXX) # 3. 设置C标准 set(CMAKE_CXX_STANDARD 17) set(CMAKE_CXX_STANDARD_REQUIRED ON) # 4. 自动包含Qt提供的CMake工具函数和宏 # 这行非常重要它提供了qt_add_executable, qt_add_library等专用命令 include(GNUInstallDirs) # 通常Qt的find_package需要这个虽然不是必须 find_package(Qt6 REQUIRED COMPONENTS Core) # 5. 启用CMake的自动处理功能MOC, UIC, RCC # 对于纯控制台程序可能不需要但加上是好习惯为后续添加GUI做准备 set(CMAKE_AUTOMOC ON) set(CMAKE_AUTUIC ON) set(CMAKE_AUTORCC ON) # 6. 定义可执行文件目标 add_executable(${PROJECT_NAME} main.cpp ) # 7. 链接Qt库到目标 target_link_libraries(${PROJECT_NAME} PRIVATE Qt6::Core) # 8. 设置目标属性可选但推荐 # 在Windows上让可执行文件子系统为控制台这样运行时才会弹出控制台窗口显示qDebug输出 if (WIN32) set_target_properties(${PROJECT_NAME} PROPERTIES WIN32_EXECUTABLE FALSE ) endif()这个CMakeLists.txt比向导生成的更详细我加入了一些解释和最佳实践。关键点在于第4步的find_package和第7步的target_link_libraries。find_package会去系统环境变量CMAKE_PREFIX_PATH或者Qt安装目录下寻找Qt6的配置包。如果你在命令行构建时发现找不到Qt6通常需要手动设置这个路径例如cmake -B build -DCMAKE_PREFIX_PATH/path/to/your/qt6/installation。3.2 配置、构建与测试有了这两个文件我们就可以在命令行中进行“配置-构建”了。这是标准的CMake跨平台构建流程生成构建系统在项目根目录manual_qt_project下打开终端命令行执行cmake -B build这个命令告诉CMake在build子目录下生成构建系统文件如Unix下的Makefile或Windows下的Visual Studio解决方案。-B是指定构建目录。CMake会根据CMakeLists.txt和当前系统环境检测编译器、查找Qt等依赖。编译项目上一步成功后进入build目录或者使用CMake的--build选项进行编译cmake --build build或者cd build make # 在Linux/macOS上 # 或者在Windows上如果你用的是Visual Studio生成器则使用 # cmake --build . --config Release运行程序编译成功后在build目录或它的子目录如Debug或Release下你会找到生成的可执行文件如ManualHelloQt.exe或ManualHelloQt。直接在命令行运行它# 在build目录下 ./ManualHelloQt # Linux/macOS # 或者 .\ManualHelloQt.exe # Windows你应该能看到“Hello from manual CMake project!”的输出。这个过程看似比点一下“运行”按钮复杂但它揭示了构建的本质CMake是一个构建系统生成器它本身不编译代码而是根据你的CMakeLists.txt生成你本地环境如Make, Ninja, MSBuild认识的构建脚本再由这些本地工具去调用编译器进行编译。3.3 添加GUI模块与资源文件现在我们升级这个手动项目把它变成一个带有简单窗口和图标的应用这涉及到添加新的Qt模块和资源。首先修改main.cpp创建一个窗口#include QApplication #include QPushButton #include QWidget int main(int argc, char *argv[]) { QApplication app(argc, argv); QWidget window; window.setWindowTitle(Manual Qt Window); window.resize(400, 300); QPushButton button(Click Me!, window); button.move(150, 130); window.show(); return app.exec(); }然后更新CMakeLists.txt。我们需要找到并链接Widgets模块并且因为代码中直接使用了QWidget和QPushButton所以需要包含对应的头文件不过CMake的AUTOMOC和链接库会处理好这些。cmake_minimum_required(VERSION 3.16) project(ManualQtWidgets VERSION 0.1.0 LANGUAGES CXX) set(CMAKE_CXX_STANDARD 17) set(CMAKE_CXX_STANDARD_REQUIRED ON) # 关键修改在COMPONENTS中增加Widgets find_package(Qt6 REQUIRED COMPONENTS Core Widgets) set(CMAKE_AUTOMOC ON) set(CMAKE_AUTOUIC ON) set(CMAKE_AUTORCC ON) add_executable(${PROJECT_NAME} main.cpp ) # 关键修改链接Qt6::Widgets库 target_link_libraries(${PROJECT_NAME} PRIVATE Qt6::Core Qt6::Widgets) # 不再需要设置WIN32_EXECUTABLE因为QApplication默认就是GUI程序重新执行cmake -B build和cmake --build build运行生成的可执行文件一个带按钮的窗口就出现了。实操心得手动编写CMakeLists.txt时最常见的错误就是find_package找不到Qt。除了设置CMAKE_PREFIX_PATH还要确保你的Qt安装是完整的并且包含对应架构如x64的库。在Windows上如果你安装了多个Qt版本或多个编译器套件如MSVC和MinGW它们之间是不能混用的必须用对应编译器套件下的Qt。一个检查方法是在Qt安装目录的bin文件夹下运行qmake -v查看其输出的Qt版本和编译器信息是否与你当前使用的CMake生成器匹配。4. 方法三使用qmake——理解传统Qt项目的构建逻辑尽管Qt 6官方推荐CMake但qmake作为Qt亲生的构建工具历史悠久有海量的遗留项目包括Qt自身的一部分仍在使用它。了解qmake不仅能帮助你维护老项目也能让你更深刻地理解Qt项目的元信息是如何被组织的。qmake的核心是一个名为.pro项目的配置文件。4.1 .pro文件语法与核心指令qmake的配置文件.pro其语法比CMakeLists.txt更简洁更专注于Qt生态。我们创建一个hello_qmake.pro文件和一个简单的main.cpp。main.cpp还是用之前的控制台版本。hello_qmake.pro文件内容如下# 注释以‘#’开头 # 1. 指定生成的目标类型和名称 TEMPLATE app # app 表示生成可执行程序lib表示库 TARGET HelloQmake # 生成的可执行文件名称 # 2. 指定Qt要使用的模块 # 对于控制台程序只需要core QT core # 如果是GUI程序则需要QT core gui widgets # 注意在Qt 5及以后gui和widgets模块通常是分开的widgets依赖于gui。 # 3. 指定C标准 CONFIG c17 # 4. 指定源文件 SOURCES main.cpp # 5. 指定头文件可选qmake会自动扫描依赖但显式声明更好 HEADERS # 6. 其他配置 # CONFIG console # 在Windows上确保生成控制台子系统程序对于非Qt GUI程序 # 对于Qt GUI程序QApplication则不需要console否则会弹出两个窗口一个控制台一个GUI。这个.pro文件非常直白TEMPLATE定义输出类型TARGET定义名字QT指定模块SOURCES和HEADERS列出文件。CONFIG用于进行各种配置比如C标准、是否启用调试信息等。4.2 使用qmake生成Makefile并构建使用qmake构建的过程通常是两步生成Makefile在终端中进入包含.pro文件的目录运行qmake或者如果你安装了多个Qt版本可能需要指定完整路径或者使用qmake -qtqt6来确保调用的是Qt 6的qmake。这个命令会读取.pro文件并根据当前系统环境生成一个Makefile在Windows上可能是Makefile.Release和Makefile.Debug。执行make进行编译上一步成功后直接运行makeLinux/macOS或nmakeWindows MSVC或mingw32-makeWindows MinGWmake编译完成后会在当前目录或release/debug子目录下生成可执行文件HelloQmake。4.3 qmake与CMake的对比与迁移考量为什么Qt要转向CMake了解它们的差异有助于你做出选择生态与通用性CMake是业界的事实标准拥有庞大的生态几乎所有的C/C开源库都支持CMake。使用CMake你的Qt项目可以更容易地集成非Qt的第三方库如Boost, OpenCV。qmake则基本局限于Qt生态内部。功能与灵活性CMake的功能更强大、更底层可以描述极其复杂的构建逻辑、条件编译、自定义目标等。qmake语法简单但对于复杂项目其脚本可能变得难以维护。学习曲线qmake对于纯Qt项目入门更简单。CMake学习曲线更陡峭但一旦掌握受益无穷。Qt官方支持Qt 6开始CMake是官方一等公民新特性和优化会优先在CMake上体现。qmake虽然仍被支持但已不再是未来发展的重点。对于新项目毫无悬念应该选择CMake。对于已有的qmake项目除非项目非常简单且没有集成其他库的需求否则建议制定计划向CMake迁移。迁移通常不是直接翻译而是需要重新设计构建逻辑但核心的源文件是不变的。注意事项在qmake项目中如果你使用了Qt的元对象系统信号槽、属性等你需要确保在SOURCES中列出了对应的.cpp文件qmake会自动调用moc元对象编译器工具来生成必要的代码。如果遇到“undefined reference to vtable”这类链接错误很可能是某个类的头文件没有Q_OBJECT宏或者moc没有正确运行可以尝试执行qmake后重新make clean再make。5. 可执行文件的生成、依赖与部署实战当你成功编译出一个Qt应用兴奋地点开生成的可执行文件.exe或无后缀文件却可能弹出一堆错误比如“无法找到Qt6Core.dll”或“程序异常退出”。这是因为你的可执行文件在运行时需要动态链接到Qt的库文件DLL或.so。这些库文件在你开发机的Qt安装目录下但到了没有安装Qt的目标机器上就找不到了。解决这个问题的过程就是“部署”。5.1 理解动态链接与依赖关系Qt默认采用动态链接Dynamic Linking。这意味着你的程序文件本身并不包含Qt库的代码只包含了调用这些库的“线索”。当程序运行时操作系统确切地说是动态链接器/加载器会根据这些线索去系统的特定路径如Windows的应用程序所在目录、PATH环境变量指向的目录、系统目录Linux的/usr/libLD_LIBRARY_PATH等查找对应的库文件如Qt6Core.dll,libQt6Core.so。你可以使用工具来查看可执行文件的依赖Windows使用Dependency Walker老牌或微软自家的dumpbin /dependents your_app.exe命令。Linux使用ldd your_app命令。macOS使用otool -L your_app命令。运行这些命令你会看到一长串依赖除了Qt自身的库Qt6Core,Qt6Gui,Qt6Widgets等可能还有C运行时库如msvcp140.dll,vcruntime140.dll、平台相关库如windowsapp.dll等。5.2 手动部署将程序“打包”到新环境手动部署是最基础、最直观的方式适合小型项目或快速测试。核心思想是将程序运行所需的所有动态库文件复制到可执行文件所在的同一目录下。Windows有一个特性当加载一个可执行文件时会首先在其所在目录查找所需的DLL。步骤分解找到你的Qt安装目录。通常类似C:\Qt\6.5.3\mingw_64Windows MinGW或/home/user/Qt/6.5.3/gcc_64Linux。定位bin和plugins目录。bin目录下有Qt的核心DLL如Qt6Core.dll和重要的工具程序如windeployqt。plugins目录下有平台插件、图像格式插件等。使用windeployqt工具Windows。这是Qt官方提供的部署工具能自动分析你的.exe文件并将其依赖的Qt库、插件等复制到目标目录。这是最推荐的手动部署方法。首先将你的Release版本的可执行文件例如MyApp.exe复制到一个新的空文件夹比如MyAppDeploy。然后打开Qt 6.5.3 MinGW 64-bit命令行在开始菜单的Qt目录下可以找到这个环境已经配置好了Qt的路径。切换到MyAppDeploy目录cd /d D:\path\to\MyAppDeploy执行部署命令windeployqt MyApp.exe工具会自动运行将所需的Qt库、插件、翻译文件等复制到当前目录。它甚至会尝试处理OpenGL和ANGLE的依赖。处理非Qt依赖。windeployqt只负责Qt自身的依赖。你还需要处理C运行时库。对于MinGW通常需要libgcc_s_seh-1.dll,libstdc-6.dll,libwinpthread-1.dll它们位于MinGW的bin目录下例如C:\Qt\Tools\mingw1120_64\bin。对于MSVC你需要安装对应的“Visual C Redistributable”运行库或者将msvcp140.dll,vcruntime140.dll等文件也一并复制注意版权和分发许可。一个简单的方法是在开发机上运行你的程序如果报错缺少某个DLL就从系统或编译器目录找到它并复制过来。测试。将整个MyAppDeploy文件夹复制到一台没有安装Qt和开发环境的纯净Windows机器上直接双击MyApp.exe看是否能正常运行。对于Linux和macOS情况略有不同。Linux下通常将程序安装到/usr/local目录下并确保库路径正确或者使用patchelf工具修改可执行文件的RPATH使其在相对路径下查找库。macOS下则需要构建.appbundle将库文件放入MyApp.app/Contents/Frameworks目录并使用macdeployqt工具类似windeployqt和install_name_tool来修正依赖路径。这些操作更为复杂通常与打包工具如Linux的AppImage、Snap macOS的dmg制作结合进行。5.3 静态编译一劳永逸的终极方案既然动态链接这么麻烦能不能把Qt库直接“塞进”可执行文件里可以这就是静态编译Static Linking。你需要从源码开始用特定的配置参数编译一个静态版本的Qt库然后用这个静态库去编译你的程序。这样生成的可执行文件会非常大因为它包含了所有用到的Qt代码但好处是它几乎可以独立运行依赖极少可能只需要系统C库。为什么不总是用静态编译许可问题Qt有LGPL和商业许可证。如果你静态链接LGPL版本的Qt根据协议你可能需要以某种方式提供你的应用程序的源代码或目标文件以便用户可以重新链接。动态链接则更容易满足LGPL的要求。商业许可证则没有这个限制。文件体积可执行文件会变得非常庞大。更新困难如果Qt发现安全漏洞需要更新你必须重新编译并分发整个巨大的可执行文件而不是替换一个小的DLL。编译耗时从源码编译Qt本身就是一个耗时巨大的工程。因此静态编译通常用于特定场景如发布一个极简的、对依赖极度敏感的单文件工具或者是在有商业许可保障下的闭源分发。5.4 使用高级工具进行专业化打包对于正式的产品发布手动复制文件显得原始且容易出错。更专业的做法是使用安装包制作工具或应用打包工具WindowsInno Setup,NSIS: 老牌且强大的安装包制作工具。你可以编写脚本在安装过程中将程序文件、依赖库、开始菜单快捷方式等部署到用户电脑的指定位置。它们不负责分析依赖你需要自己确保所有文件都被包含进去。Advanced Installer: 功能更全的商业软件有图形界面。Qt Installer Framework: Qt官方提供的安装框架功能强大可以创建带在线更新功能的安装包学习曲线较陡。跨平台CMakeCPack: 如果你使用CMake可以配合CPack模块生成各种格式的安装包如ZIP, NSIS, DEB, RPM等。你需要编写额外的CMake脚本定义安装规则install命令。jom和windeployqt结合脚本可以编写批处理或Python脚本自动化构建、调用windeployqt、收集文件、打包成ZIP的过程。一个常见的半自动化流程是使用CMake构建Release版本 - 将可执行文件复制到发布目录 - 调用windeployqt处理Qt依赖 - 手动或脚本复制其他第三方DLL - 使用Inno Setup或CPack生成安装包。踩坑实录部署时最常遇到的几个坑1)Debug与Release版本混用千万不要把Debug版的Qt库如Qt6Cored.dll拿去部署Release版程序反之亦然。这会导致奇怪的崩溃。确保你部署的是Release构建的产物。2)插件丢失程序能启动但图片加载不了或者样式异常可能是缺少imageformats或platforms插件。windeployqt通常会帮你复制plugins目录下的必要插件。3)VC运行库在目标机器上如果使用MSVC编译务必确保安装了对应版本的Visual C Redistributable或者将msvcp140.dll等文件随包分发需注意许可。4)路径问题程序中如果使用了相对路径访问资源文件如图标、配置文件在部署后当前工作目录可能变化导致找不到文件。建议使用QCoreApplication::applicationDirPath()来获取可执行文件所在目录并以此为基础构建资源文件的绝对路径。
![[C++]内存管理：串顺序存储的内存回收](http://pic.xiahunao.cn/yaotu/[C++]内存管理：串顺序存储的内存回收)
