Windows下编译安装Qt5.15.0指南

1. 系统要求

• 操作系统: Windows 7 或更高版本（推荐 Windows 10/11）。

• 磁盘空间: 至少 20-30 GB（编译过程会生成大量中间文件）。

• 内存: 建议 8GB 或更高。

• 编译器: 需要安装 Visual Studio（推荐 MSVC 2017 或 MSVC 2019）。

2. 安装依赖工具

a. 安装 Visual Studio

• 下载并安装Visual Studio，选择 C++ 桌面开发工具包。

• 确保勾选 MSVC v142 或更高版本的编译器。

b. 安装 Perl

• 从 ActivePerlhttps://www.activestate.com/products/perl/ 或 Strawberry Perlhttp://strawberryperl.com/ 下载并安装。

c. 安装 Python

• 从 Python 官网https://www.python.org/ 下载并安装 Python 3.x 版本。

d. 安装 jom（可选，替代 nmake 加速编译）

• 下载 jomhttps://wiki.qt.io/Jom 并解压到某个目录（例如 C:\jom）。

• 将 jom.exe 所在目录添加到系统环境变量 PATH。

3. 获取 Qt 5.15.0 源代码

• 从清华镜像中下载 qt-everywhere-src-5.15.0.zip 并解压。

4. 配置编译环境

1. 打开 VS 开发者命令提示符：

   • 在开始菜单中找到 "x64 Native Tools Command Prompt for VS 2019"（根据你的 VS 版本选择）。

   • 切换到 Qt 源代码目录：

     cd /d D:\Qt\qt-everywhere-src-5.15.0

2. 运行 configure 脚本：

   configure.bat -prefix "C:\Qt\5.15.0\msvc2019" -opensource -confirm-license -platform win32-msvc -release -no-opengl -nomake examples -nomake tests

• 参数说明：
• -prefix: 指定安装目录。
• -opensource: 使用开源协议。
• -platform win32-msvc: 指定使用 MSVC 编译器。
• -release: 仅编译 Release 版本（如需 Debug，可添加 -debug-and-release）。
• -nomake examples: 跳过示例程序编译以节省时间。

5. 编译与安装

1. 使用 jom 多线程编译（推荐）：

   jom -j 8  # 根据 CPU 核心数调整线程数（如 -j 8）

   或使用 nmake（较慢）：

   nmake

2. 安装到指定目录：

   jom install  # 或 nmake install

6. 配置环境变量

1. 将 Qt 安装目录的 bin 文件夹（如 C:\Qt\5.15.0\msvc2019\bin）添加到系统环境变量 PATH。

2. 验证安装：

   qmake -v

7. 验证 Qt 安装

1. 打开 Qt Creator，在 工具 > 选项 > Kits 中检查是否检测到新编译的 Qt 版本。

2. 创建一个简单的 Qt 项目并编译运行。

常见问题

1. 编译失败：

   • 检查是否安装了所有依赖工具（Perl、Python、VS 编译器）。

   • 确保命令提示符环境正确（使用 VS 的开发者命令提示符）。

2. 缺少模块：

   • 若需特定模块（如 WebEngine），在 configure 时不要使用 -skip 参数。

3. 路径问题：

   • 避免源码或安装路径包含空格或特殊字符。