Ubuntu 20.04 编译 Qt 5.15.3 源码指南

安装必要的依赖项

确保系统已安装编译工具链和 Qt 依赖的库。打开终端并运行以下命令：

sudo apt update
sudo apt install build-essential libgl1-mesa-dev libxkbcommon-dev libxkbcommon-x11-dev libxcb-xinerama0-dev libxcb-icccm4-dev libxcb-image0-dev libxcb-keysyms1-dev libxcb-render-util0-dev libxcb-xinerama0-dev libx11-xcb-dev libfontconfig1-dev libfreetype6-dev libx11-dev libxext-dev libxfixes-dev libxi-dev libxrender-dev libxcb1-dev libx11-xcb-dev libxcb-glx0-dev

下载 Qt 5.15.3 源码

从 Qt 官方仓库或镜像站获取源码包。使用 wget 下载：

wget https://download.qt.io/official_releases/qt/5.15/5.15.3/single/qt-everywhere-src-5.15.3.tar.xz
tar xvf qt-everywhere-src-5.15.3.tar.xz
cd qt-everywhere-src-5.15.3

配置编译选项

通过 configure 脚本定制编译参数。以下是一个典型配置示例：

./configure -prefix /opt/qt5.15.3 -opensource -confirm-license -nomake examples -nomake tests -qt-xcb -skip qtwebengine

参数说明：

• -prefix：指定安装目录。
• -opensource：选择开源版本。
• -nomake examples/tests：跳过示例和测试以加速编译。
• -skip qtwebengine：可选，跳过需要复杂依赖的模块。

开始编译

使用多线程编译以加快速度（根据 CPU 核心数调整 -j 参数）：

make -j$(nproc)

安装 Qt 到指定目录

编译完成后，执行安装命令：

sudo make install

安装完成后，Qt 将位于 /opt/qt5.15.3 目录。

配置环境变量

将 Qt 路径添加到系统环境变量中。编辑 ~/.bashrc 文件：

echo 'export PATH=/opt/qt5.15.3/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

验证安装

运行以下命令检查 Qt 版本：

qmake --version

输出应显示 Qt version 5.15.3。

常见问题解决

编译过程中缺少依赖项

根据报错信息安装对应的开发包。例如，若提示缺少 libssl，则执行：

sudo apt install libssl-dev

QtWebEngine 编译失败

该模块需要额外依赖（如 ninja 和 python2）。若需启用，需提前安装：

sudo apt install ninja-build python2

或在配置时跳过该模块（如前述示例）。

性能优化

若需更快的编译速度，可禁用调试符号：

./configure -release ...

注意事项

• 编译时间可能较长（1-3 小时），取决于硬件性能。
• 确保磁盘空间充足（至少 20GB 剩余空间）。
• 推荐在干净的 Ubuntu 系统中操作，避免依赖冲突。