使用 LLVM-Mingw 编译的 Qt 应用程序部署指南：拷贝必要库到 exe 目录

news/2025/10/16 17:19:33/文章来源:https://www.cnblogs.com/lizhiqiang0204/p/19146198

使用 LLVM-Mingw 编译的 Qt 应用程序部署指南：拷贝必要库到 exe 目录

大家好！在开发 Qt 应用程序时，如果使用 LLVM-Mingw 作为编译器，部署到其他 Windows 机器上时常常会遇到 DLL 缺失的问题，导致程序无法运行。这是因为 Qt 和 LLVM-Mingw 依赖于特定的动态库文件。今天，我将分享一个简单有效的部署方法：通过配置环境变量、使用 windeployqt 工具拷贝 Qt 库，并手动拷贝 LLVM-Mingw 所需的库文件到 exe 目录下。这样，你就可以打包一个自包含的应用程序了。

本文基于 Qt 6.9.1 和 LLVM-Mingw 1706 版本，步骤通用。如果你使用其他版本，可能需要稍作调整。让我们一步步来操作吧！

前提准备

确保已安装 Qt 6.9.1（包含 LLVM-Mingw 工具链）。
已编译生成你的 Qt 应用程序 xx.exe（假设 exe 文件名为 xx.exe）。
操作环境：Windows 10/11，命令提示符（CMD）或 PowerShell 以管理员权限运行。

步骤 1: 添加 LLVM-Mingw bin 目录到环境变量

为了让系统能找到 LLVM-Mingw 的工具和库，首先需要将相关路径添加到系统的 PATH 环境变量中。

打开“系统属性” > “高级” > “环境变量”。
在“系统变量”中找到 Path，点击“编辑”。
点击“新建”，添加路径：C:\Qt\6.9.1\llvm-mingw_64\bin。
点击“确定”保存，重启命令提示符以生效。

为什么这么做？ 这能让后续命令（如 windeployqt）能访问 LLVM-Mingw 的组件，避免路径错误。

验证：打开 CMD，输入 echo %PATH%，检查是否包含该路径。

步骤 2: 使用 windeployqt 拷贝 Qt 所需的库

windeployqt 是 Qt 提供的部署工具，它会自动扫描 exe 文件并拷贝所需的 Qt DLL、插件和资源到指定目录。

打开命令提示符（CMD），以管理员权限运行。
使用 cd 命令定位到 xx.exe 所在目录，例如：
```
cd C:\path\to\your\app
```
执行以下命令：
```
windeployqt xx.exe
```

命令解释：

windeployqt 会自动检测 Qt 版本和架构（这里是 mingw_64）。
它会拷贝 Qt 的核心库（如 Qt6Core.dll、Qt6Gui.dll 等）、平台插件（如 platforms/qwindows.dll）和图像格式插件到 xx.exe 同目录下。
如果你的应用使用了特定模块（如 QtMultimedia），可以添加参数如 --dir output_dir 来指定输出目录，或 --release 指定 Release 模式。

运行后，目录下会多出许多 .dll 文件和子文件夹（如 platforms、imageformats）。测试运行 xx.exe，Qt 相关问题应该已解决。

常见问题：

如果提示 “windeployqt 未找到”，确保步骤 1 已完成。
对于静态链接 Qt，跳过此步；但动态链接时必不可少。

步骤 3: 拷贝 LLVM-Mingw 所需的库到 exe 目录

LLVM-Mingw 作为编译器，其生成的 exe 依赖于 MinGW 的运行时库（如 libgcc_s_seh-1.dll、libstdc++-6.dll 等）。这些库需要手动拷贝。

打开资源管理器，导航到 C:\Qt\Tools\llvm-mingw1706_64\x86_64-w64-mingw32\bin。
找到以下常见必需 DLL（根据你的应用依赖，可能需更多；用 Dependency Walker 或类似工具检查）：
- libgcc_s_seh-1.dll
- libstdc++-6.dll
- libwinpthread-1.dll
- libzstd.dll（如果使用了压缩）
- 其他如 libiconv-2.dll 等（视情况而定）。
将这些 DLL 直接拷贝到 xx.exe 所在目录下。