1. 项目概述
最近在开发一个需要分发的Qt应用程序时,遇到了依赖库部署的难题。经过调研,发现静态编译Qt6.10+VS2022的方案能够完美解决这个问题。静态编译后的程序不再需要附带一堆DLL文件,单个exe就能直接运行,极大简化了部署流程。
这次编译过程耗时约6小时(i7-12700H处理器),最终生成的静态库占用约4.5GB磁盘空间。虽然编译时间较长,但换来的是部署时的极大便利。下面我将详细记录整个编译过程,包括环境准备、配置调整、编译优化等关键环节,特别是那些官方文档没有提及的实用技巧。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 编译环境准备
2.1 必要软件下载
开始前需要准备以下工具链(所有链接均为官网最新版本):
-
Strawberry Perl (5.38.2.1):用于提供perl环境
- 官网下载:https://strawberryperl.com/
- 备用镜像:建议使用国内镜像源加速下载
-
Python (3.11.9):Qt构建系统依赖
- 官网下载:https://www.python.org/downloads/
- 注意:必须添加到系统PATH环境变量
-
Qt 6.10.1源码包:
- 通过Qt在线安装器获取
- 安装时勾选"MSVC 2022 64-bit"和"Sources"组件
-
Visual Studio 2022:
- 安装时至少选择"使用C++的桌面开发"工作负载
- 额外勾选"Windows 10/11 SDK"和"C++ CMake工具"
提示:建议将所有软件安装在非系统盘(如D盘),避免路径过长问题。我个人的安装路径是D:\QtDevTools\
2.2 环境配置要点
安装完成后需要进行以下验证:
-
Perl环境测试:
bash复制
perl -v应显示类似"v5.38.2"的版本信息
-
Python环境验证:
bash复制
python --version确认输出为Python 3.11.x
-
VS2022工具链检查:
打开"x64 Native Tools Command Prompt for VS 2
