windeployqt工具打包发布程序(Qt Widgets Application)

使用windeployqt简化Qt程序部署
最新推荐文章于 2025-10-09 19:58:55 发布
原创 最新推荐文章于 2025-10-09 19:58:55 发布 · 1.3k 阅读 · 4 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#windeployqt工具打包发布程序 #Warning: Unable to read c:\Use #qt\work\install\mkspecs\qconfi

本文介绍如何使用Qt自带的windeployqt工具简化Qt程序的部署过程，避免手动复制大量dll文件导致的问题，确保exe文件在不同电脑上正常运行。

环境：QT5.9.3+qtCreator+MSVC2015 32bit

发布qtCreator生成的exe程序时，需要复制一大堆 dll，如果自己去复制dll会很麻烦，甚至一不小心会导致exe在别的电脑里无法正常运行。此处使用 Qt 官方自带的打包工具：windeployqt.exe，它存在于对应的安装目录的bin目录下。

当程序编译release版本完成后，会生成一个xxx.exe文件，将这个exe文件放入新的文件夹下。

从cmd直接运行windeployqt会报如下错误：

Warning: Unable to read c:\Users\qt\work\install\mkspecs\qconfig.pri:

切记！！！

应当从开始菜单打开 对应版本的Qt 命令行工具，然后使用 windeployqt 工具命令如下：

 

欢迎大家指教，希望大家喜欢

路漫漫其修远兮，同志仍须努力

Qt入门之Widget Application
蛐蛐的博客
05-02 2510
1.创建项目 1.1 选择模板 由于要创建一个Widget项目，所以选择 Qt Widgets Application 模板 1.2 项目路径 输入项目所在父目录和项目名称 1.3 构建系统 可以选择CMake、Qbs和qmake 1.4 主类名 设置窗口主类名、文件名 1.5 翻译文件 设置翻译文件，这里不需要 1.6 选择工具集 可以选择MSVC和MinGW的工具集，要考虑交叉编译 1.7 配置...
Qt程序打包发布方法（使用官方提供的windeployqt工具）_qt发布软件
2401_86963632的博客
09-12 696
以官方 Qt 5.4.0+MinGW 开发环境为例，windeployqt工具在 %QTDIR%\Qt5.4.0\5.4\mingw491_32\bin 目录下，其中 QTDIR 是 Qt 的安装目录，是环境变量。进入这个文件夹，在进入它的子文件夹 release 里面，找到 hellomw.exe，将这个exe 复制到一个新的单独的文件夹里用于发布，比如存到 D:\hellomw\ 文件夹里面。生成的程序运行正常之后，找到项目的生成目录，比如 项目源码路径：C:\QtPros\hellomw\。
Qt发布可执行程序（Qt Widgets Application）
zhaol_90的博客
12-27 2958
1）以Release 方式编译生成 exe 程序：    生成的程序运行正常之后，找到项目的生成目录，比如 项目源码路径：C:\QtPros\hellomw\ 。    它的项目生成目录是 C:\QtPros\build-hellomw-Desktop_Qt_5_4_0_MinGW_32bit-Release\ 。    进入这个文件夹，在进入它的子文件夹 release 里面，找到 hello...
QtWidgetsApplication1.rar
07-20
用QT编写的数值输入控件的源代码 1.带有下拉数字小键盘输入的功能 2.前后缀、范围、小数位数等设置
[Qt] 关于这个报错的一些体会：DirectWrite: CreateFontFaceFromHDC() failed (指示输入文件 (例如字体文件) 中的错误。) for QFontDef(Fa
最新发布
kd13777834017的博客
10-09 320
虽然此时程序还能正常运行，但一是因为担心忽略这个报错后会引发很多问题，二是因为我有强迫症，所以我开始修这个报错。哇还好发现得早，不然我差点就要把我那代码翻个底朝天了。已知在我这个项目里输入ᐠ( ᑒ )ᐟ，会变成方块字，但是还能正常输出，所以我就没管它。所以每一次运行时，程序都会从json文件中读取ᐠ( ᑒ )ᐟ，于是每一次运行都会报错。尝试把ᐠ( ᑒ )ᐟ删除，再次运行程序，果然不报错了！我靠这一修就是两个小时，并且中间不知道破防了几次。最后不知道是看了哪个网页，我联想到了“乱码”。
【Qt】QtCreator新建QtWidgetsApplication
jn10010537的博客
01-09 2946
冒号后面的两行代码，是C++的列表初始化。其中QMainWindow(parent) 是父类构造函数的初始化列表操作，即显式调用基类（父类）的构造函数。ui文件是xml格式的，Qt编译时，先用uic.exe工具将mainwindow.ui编译生成ui_mainwindow.h头文件。ui(new Ui::MainWindow) 是子类的成员初始化，即初始化ui指针，ui指针在mainwindow.h中定义的。这个头文件ui_mainwindow.h是c++类，可以通过。
QtWidgetsApplication 项目教程
gitblog_01065的博客
09-13 1014
QtWidgetsApplication 项目教程 1. 项目介绍 QtWidgetsApplication 是一个基于 Qt 框架的开源项目，旨在帮助开发者快速创建桌面应用程序。该项目利用 Qt Widgets 模块提供的 UI 元素，创建经典的桌面风格用户界面。QtWidgetsApplication 项目提供了一个简单的示例应用程序，展示了如何使用 Qt Creator 和 Qt Desig...
Qt windeployqt 打包的Qt动态库介绍
L-Super的博客
07-04 2138
在 Windows 平台，通常使用 Qt 的工具将可执行文件的相关 Qt 依赖项部署到当前路径下。组件文件名可执行文件Qt Windows 平台插件Qt Windows Vista 风格的插件Qt 核心模块Qt GUI 模块Qt6Gui.dllQt Widgets 模块根据应用程序使用的功能，可能需要其他插件 (：SVG 图标支持qgif.dll：提供对 GIF 图像格式的支持。qicns.dll：提供对 ICNS 图像格式的支持。qico.dll：提供对 ICO 图像格式的支持。
Qt windeployqt打包分析
L-Super的博客
10-15 2092
Qt程序打包一般流程： 开始菜单 - 打开Qt对应编译器命令行 - 输入`windeployqt test.exe`命令 那么，这个过程经历了什么呢？这个就是今天要分析的主题。
怎么打包发布QT程序（图文详解）
weixin_41209471的博客
09-30 1365
###一.对于Qt Widgets Application项目 1.对于QtCreator 新建的Qt Widgets Application 项目，在左下角选择以 Release 方式编译生成 exe 程序，点击绿色三角形运行： 可以看到qt文件所在位置产生一个新的文件夹： 2.进入这个文件夹，可以看到里面有个release子文件夹 双击静进入后，选择其中与你的Application同名的exe文件复制到一个新建的文件夹中，如下图所示： 3.在开始菜单找到QT命令行 输入复制的exe文件所在位
Qt Widgets Application可执行程序发布
Gavin的博客
06-08 681
一、Qt Widgets Application可执行程序生成 <1>首先用 QtCreator 新建一个 Qt Widgets Application 项目，直接用默认的 QMainWindow 程序就可以了, 项目名字假定是 hellomw。 <2>然后以 Release 方式编译生成 exe 程序 二、复制生成的exe文件到独立的文件夹 <1> 生成的程序运行正常之后，找到项目的生成目录，比如 项目源码路径：C:\QtPros\helloworld 它的项目生
1、Your First QtWidgets Application
u013049912的博客
07-18 232
导入后，您将创建一个QApplication实例。由于Qt可以从命令行接收参数，您可以将任何参数传递给QApplication对象。与任何其他编程框架一样，您从传统的“HelloWorld”程序开始。创建应用程序对象后，我们创建了一个QLabel对象。最后，我们调用app.exec()进入Qt主循环，开始执行Qt代码。实际上，仅在此处显示标签，但现在可以忽略。对于使用PySide6的小部件应用程序，您必须始终从从PySide6.QtWidgets模块导入适当的类开始。...
Qt5学习笔记（一）：Qt Widgets Application项目初探
baggiowangyu的专栏
06-07 894
笔者长期使用MFC开发Windows GUI软件。随着软件向Linux平台迁移的趋势越发明朗，GUI程序的跨平台需求也越来越多。因此笔者计划重新抓一下Qt来实现跨平台GUI程序的实现。
Qt开发：Qt Widgets模块——QApplication类
热门推荐
一世豁然的专栏
05-18 1万+
QApplication类管理GUI应用程序的控制流和主要设置。头文件：#include &lt;QApplication&gt; qmake：QT += widgets继承：QGuiApplicationQApplication专门为QGuiApplication提供基于QWidget的应用程序所需的一些功能。 它处理小部件特定的初始化，最终化。对于任何使用Qt的GUI应用程序，只需一个QApp...
Qt Widgets Application打包发布
IT-Why
05-08 511
以Release方式构建运行编译生成exe。 进入build-。。。。。。-Release目录找到生成的exe，复制到一个单独的空目录。 从开始菜单打开Qt命令行：Qt 5.8 for Desktop (MinGW 5.3.0 32 bit) cd到刚才exe复制到的文件夹 输入命令：windeployqt exename.exe 此处输入你的实际exe名字，然后程序会自动把需要的运行库等复制到
Qt Widgets 应用程序核心类 - QApplication 详解
笔记
09-29 739
摘要：QApplication是Qt Widgets应用的核心类，负责GUI应用程序的控制流和全局设置。它继承自QGuiApplication和QCoreApplication，提供样式管理、调色板/字体设置、用户交互参数配置以及窗口管理等功能。通过qApp宏可全局访问应用实例，支持运行时动态调整界面风格。示例展示了QApplication的初始化、属性设置、样式更改和事件循环管理，以及高级功能如字体大小控制和样式表应用，体现了其在Qt Widgets开发中的核心作用。
C++学习（一二六）Qt Widgets Application 和 Qt Quick Application
hankern的专栏
07-11 2666
Qt Widgets Application 是传统的c++，不适合移动端开发。 Qt Quick Application 是qt的QML和C++的结合 比较适合做界面类的东西，页面布局（UI）用的QML，但是内部的业务逻辑还是用QT语法，协同JavaScript。 ...
Qt5Widgets Application打包发布
IT-Why
07-14 300
Qt5Widgets Application程序的打包发布官方提供了打包程序，在安装目录Qt5.8.0\5.8\mingw53_32\bin中 名字为windeployqt.exe。 打包方法如下： Release方式编译生成exe程序，然后将其复制到一个空的文件夹中。 开始菜单——Qt命令行——进入此目录 运行windeployqt.exe hello.exe 然后程序运行需要的资源即
QT Widgets Application项目在vs下开发完成怎么封装为动态库和静态库？
07-11
<think>我们正在处理用户的问题：如何在Visual Studio中将QT Widgets项目打包为动态库和静态库。 根据之前的引用，我们得知用户可能遇到了一些困难，特别是关于静态编译的问题。引用[1]和[2]提到，默认的Qt安装是动态编译的，而且静态编译需要自己编译Qt静态库，过程复杂且耗时。引用[3]提供了编译Qt静态库的配置命令示例。 用户的需求是将QT Widgets项目打包为动态库和静态库，所以我们分为两部分来回答：动态库和静态库。 注意：由于静态库的创建需要静态编译的Qt库，而默认安装的Qt是动态的，因此静态库的创建可能需要先编译静态版本的Qt。 步骤概览： 1. 动态库（DLL）的创建：相对简单，因为默认的Qt就是动态链接的。 2. 静态库（LIB）的创建：需要先编译静态版本的Qt库，然后配置项目使用静态库。 详细步骤： ## 一、创建动态库（DLL） 1. 在Visual Studio中创建一个Qt Widgets Application项目（如果还没有，请先创建）。 2. 修改项目配置，使其生成动态库： - 打开项目属性（右键项目 -> 属性）。 - 在“常规”选项卡中，将“配置类型”改为“动态库(.dll)”。 - 在“C/C++” -> “预处理器”中，添加预处理器定义`BUILD_DLL`（或其他用于导出符号的宏，具体见下一步）。 3. 在代码中，需要导出类或函数。例如，在头文件中使用如下方式： ```cpp #ifdef BUILD_DLL #define MY_EXPORT __declspec(dllexport) #else #define MY_EXPORT __declspec(dllimport) #endif class MY_EXPORT MyWidget : public QWidget { Q_OBJECT public: MyWidget(QWidget *parent = nullptr); // ... 其他成员 }; ``` 这样，在编译动态库时，会导出类`MyWidget`；在使用该动态库的程序中，会导入这个类。 4. 在项目属性中，确保Qt的链接设置正确。通常，在安装Qt VS Tools后，Qt的相关路径会自动配置。 5. 编译项目，将生成一个DLL文件。 注意：生成的DLL文件需要和Qt的动态库（如Qt5Core.dll, Qt5Widgets.dll等）一起分发，或者将Qt的动态库放在系统路径下。 ## 二、创建静态库（LIB） 创建静态库的前提是拥有静态编译的Qt库。如果还没有，需要先编译Qt的静态版本。 ### 步骤1：编译静态Qt库 1. 下载Qt源代码（与已安装的Qt版本一致）。 2. 打开命令提示符（或Qt提供的命令行工具），进入Qt源代码目录。 3. 配置编译选项，使用类似于引用[3]中的命令，但需要根据实际情况调整路径和选项： ```bash configure -platform win32-msvc2013 -mp -debug-and-release -static -prefix "E:\Qt\5.3.1-static-vs2013" -qt-sql-sqlite -qt-zlib -qt-libpng -qt-libjpeg -opengl desktop -qt-freetype -no-qml-debug -no-angle -nomake tests -nomake examples -skip qtwebkit ``` 注意： - `-platform`：指定编译器平台，如`win32-msvc2017`（根据你的Visual Studio版本选择）。 - `-static`：表示静态编译。 - `-prefix`：指定安装路径。 - 其他选项根据需求添加或移除。 4. 运行配置命令后，执行`nmake`（或`jom`）进行编译和安装。这个过程可能需要几个小时。 ### 步骤2：在Visual Studio中创建静态库项目 1. 在Visual Studio中，创建一个新的Qt Widgets Application项目（或者将现有项目改为静态库）。 2. 修改项目配置： - 打开项目属性，将“配置类型”改为“静态库(.lib)”。 - 在“C/C++” -> “预处理器”中，添加`QT_STATICPLUGIN`（如果需要使用静态插件）和`QT_NO_DEBUG`（如果是发布版本）等定义。 3. 配置Qt版本：在Qt VS Tools的设置中，添加刚刚编译的静态Qt库的路径（例如`E:\Qt\5.3.1-static-vs2013`），并设置为当前项目的Qt版本。 4. 在代码中，不需要像动态库那样处理导出（因为静态库是链接到可执行文件中的）。但是，如果静态库中包含了Qt的元对象系统（如Q_OBJECT），则需要运行`moc`工具。通常，Qt VS Tools会自动处理。 5. 编译项目，生成LIB文件。 注意：使用静态库时，需要将生成的LIB文件和其他静态库一起链接到最终的可执行文件中。同时，由于Qt静态编译会将所有用到的模块都链接进去，所以最终的可执行文件会比较大。 ## 注意事项 - 动态库的依赖：动态库依赖于Qt的动态库，发布时需要带上这些DLL。 - 静态库的依赖：静态库将Qt代码都链接到库中，但使用该静态库的程序仍然需要链接Qt的静态库（因为静态库中只包含了项目自身的代码，不包括Qt核心库）。实际上，通常的做法是： 1. 将项目编译为静态库（A.lib）。 2. 然后，在另一个应用程序中，链接A.lib和Qt的静态库（如Qt5Core.lib, Qt5Widgets.lib等）。 - 插件问题：如果使用了Qt插件（如图像格式插件、数据库插件等），在静态编译时需要将这些插件也静态链接到程序中。这可以通过在代码中调用`Q_IMPORT_PLUGIN`和`Q_INIT_RESOURCE`来实现。 由于静态编译Qt库和创建静态库的过程较为复杂，用户可以根据实际需求选择动态库或静态库。 根据引用[2]和[3]的经验，用户可能已经尝试过静态编译但遇到了困难。如果用户不想花费时间编译静态Qt库，那么动态库可能是更简单的选择。 相关问题： 1. 如何解决Qt动态库的依赖问题，使得程序在没有安装Qt的电脑上运行？ 2. 静态编译Qt库时，如何优化编译参数以减少编译时间和最终文件大小？ 3. 在Windows下，如何将Qt插件（如图像格式插件）静态链接到程序中？</think>### 如何在 Visual Studio 中将 QT Widgets 项目打包为动态库和静态库 #### **一、打包为动态库 (DLL)** 1. **修改项目配置** - 在 Visual Studio 中右键项目 → **属性** → **常规** → **配置类型** → 选择 **动态库 (.dll)** - 在 **C/C++ → 预处理器** 中添加 `QTDLL` 宏定义（避免 Qt 静态链接） ![](https://docs.microsoft.com/zh-cn/cpp/build/media/vs2019-property-page-general.png?view=msvc-170) 2. **导出符号处理** 在公共类/函数声明前添加导出宏（示例）： ```cpp // MyWidget.h #ifdef MYLIB_EXPORT # define MYLIB_API __declspec(dllexport) #else # define MYLIB_API __declspec(dllimport) #endif class MYLIB_API MyWidget : public QWidget { Q_OBJECT public: explicit MyWidget(QWidget* parent = nullptr); }; ``` 3. **生成与依赖处理** - 编译后将生成 `.dll` 和 `.lib`（导入库）文件 - 分发时需附带： - 项目生成的 `.dll` - Qt 核心动态库（如 `Qt5Core.dll`, `Qt5Widgets.dll`） - 平台插件目录 `platforms/qwindows.dll` > **验证动态库**：新建测试项目链接导入库（`.lib`），调用 `MyWidget` 并确保 Qt 动态库在 PATH 中[^2][^4]。 --- #### **二、打包为静态库 (LIB)** ⚠️ **前提：必须使用静态编译的 Qt 库**（默认安装不支持静态链接[^1][^2]） 1. **编译静态 Qt 库** - 下载 Qt 源码（版本需匹配） - 执行静态编译配置（示例命令[^3]）： ```bash configure -static -prefix "C:\Qt\5.15.2-static" -platform win32-msvc -nomake examples -nomake tests -opengl desktop -qt-zlib -qt-libpng nmake install # 耗时数小时 ``` 2. **修改项目配置** - 项目属性 → **常规** → **配置类型** → **静态库 (.lib)** - **C/C++ → 代码生成** → **运行时库**：选择 `/MT`（静态 CRT） - **Qt Project Settings** → 切换 Qt 版本为编译好的静态库路径 3. **处理静态资源** 在代码中显式初始化资源（避免插件加载问题）： ```cpp #include <QApplication> #include <QtPlugin> Q_IMPORT_PLUGIN(QWindowsIntegrationPlugin) // 导入平台插件 int main(int argc, char* argv[]) { QApplication::setLibraryPaths(QStringList()); // 禁用动态插件搜索 QApplication app(argc, argv); // ... } ``` 4. **生成与使用** - 编译后生成 `.lib` 文件 - 使用时链接： - 项目生成的 `.lib` - 所有静态 Qt 库（如 `Qt5Widgets.lib`, `Qt5Core.lib`） - Windows 系统库（`user32.lib`, `gdi32.lib` 等） > **关键问题**：静态编译需确保所有依赖（包括图像格式插件、SQL驱动）显式链接到最终程序[^1][^3]。 --- ### **常见问题解决** - **动态库依赖问题**： 使用 [Dependency Walker](http://www.dependencywalker.com/) 检查缺失 DLL，通过 `windeployqt` 工具自动收集依赖： ```bash windeployqt --release path/to/your.dll ``` - **静态编译错误**： 若出现 `undefined reference to Q_INIT_RESOURCE`，在代码中手动初始化资源： ```cpp void loadResources() { Q_INIT_RESOURCE(my_resources); } ``` - **插件兼容性**： 部分 Qt 模块（如 QtWebEngine）不支持静态链接，需移除相关代码[^2]。 --- ### **对比总结** | **类型** | 优点 | 缺点 | |------------|--------------------------|-------------------------------| | **动态库** | 部署灵活、体积小 | 需分发 Qt DLL 和插件 | | **静态库** | 单文件分发、无外部依赖 | 编译复杂、文件体积大 | 根据需求选择： - 快速部署 → 动态库（配合 `windeployqt`） - 独立单文件 → 静态库（需预编译 Qt 源码） ---
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
表情包 代码片
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

xumingyifrend

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值