【Qt】MSVC编译Qt源码

使用 MSVC（Microsoft Visual C++）编译器编译 Qt 源码需要遵循以下步骤。以下是详细的操作流程：

---

1. 准备工作

1. 安装 Visual Studio
   确保已安装 Visual Studio（建议使用与 Qt 版本兼容的版本，例如 Qt 5.x 支持 VS2019，Qt 6.x 需要 VS2022）。安装时需勾选 C++ 桌面开发工具（包含 MSVC 编译器）。

2. 下载 Qt 源码

   • 从 Qt 官网 下载源码包（如 .zip 或 .tar.xz）。
   • 或通过 Qt 安装工具（Qt Maintenance Tool）勾选源码选项（Sources）。

3. 安装必要工具

   • Perl：从 Strawberry Perl 或 ActivePerl 安装。
   • jom（可选）：替代 nmake 的多核编译工具，从 Qt jom 下载。

---

2. 配置编译环境

1. 打开 MSVC 命令行工具
   根据目标平台选择：

   • x86: x86 Native Tools Command Prompt for VS 2022
   • x64: x64 Native Tools Command Prompt for VS 2022

2. 设置环境变量（可选）
   确保以下工具在 PATH 中：

   set PATH=C:\Qt\Tools\Ninja;%PATH%  # 如果使用 Ninja 替代 nmake
   set PATH=C:\Strawberry\perl\bin;%PATH%  # Perl 路径
   

---

3. 配置 Qt 源码

1. 解压源码并进入目录

   cd C:\Qt\6.7.0\Src  # 假设源码解压到此路径
   

2. 创建构建目录

   mkdir build
   cd build
   

3. 运行 configure 脚本

   ..\configure -prefix C:\Qt\6.7.0\msvc2022  # 指定安装路径
               -platform win32-msvc         # 指定编译器平台
               -opensource                  # 使用开源协议
               -confirm-license            # 自动确认协议
               -nomake examples            # 不编译示例
               -nomake tests               # 不编译测试
               -mp                        # 启用多核编译
               -skip webengine             # 跳过复杂模块（可选）
   

   • 常用参数：
     • -static: 生成静态库。
     • -shared: 生成动态库（默认）。
     • -debug-and-release: 编译 Debug 和 Release 版本。
     • -list-features: 查看可选模块。

---

4. 编译源码

1. 使用 nmake 编译

   nmake  # 单线程编译（较慢）
   

   或使用 jom（多线程加速）：

   jom -j 8  # 根据 CPU 核心数调整
   

2. 安装到指定目录

   nmake install
   

---

5. 验证安装

1. 检查安装目录
   确保 C:\Qt\6.7.0\msvc2022 包含 bin、lib、include 等目录。

2. 在 Qt Creator 中配置

   • 打开 Qt Creator，进入 Tools > Options > Kits > Qt Versions。
   • 添加新路径 C:\Qt\6.7.0\msvc2022\bin\qmake.exe。

---

6. 常见问题

1. 缺少头文件或库

   • 检查是否安装了 Windows SDK 和正确的 MSVC 版本。
   • 确保 configure 参数正确（如未跳过必要模块）。

2. 内存不足

   • 使用 jom 或 ninja 替代 nmake 以提高效率。
   • 关闭其他占用内存的程序。

3. 静态编译失败

   • 添加 -static 参数后，需确保依赖库（如 OpenSSL）也支持静态链接。

---

附：分模块编译（可选）

若仅需编译特定模块（如 Qt Core）：

cd qtbase
configure ...  # 同上
nmake module-qtbase

---

参考 Qt 官方编译文档。