当前位置：首页 > news >正文

在Ubuntu 20.10上为老项目降级GCC 4.8，再搞定Qt 4.8.7编译（附字体修复）

news 2026/4/30 9:58:32

在Ubuntu 20.10上为老项目降级GCC 4.8并编译Qt 4.8.7的完整指南

当维护一个遗留的Qt 4.8.7项目时，在现代Ubuntu系统上会遇到各种兼容性问题。本文将深入探讨如何降级GCC编译器到4.8版本，成功编译Qt 4.8.7，并解决常见的字体显示问题。

1. 为什么需要降级GCC？

在现代Ubuntu系统上编译老旧的Qt项目时，使用高版本GCC往往会遇到各种编译错误。这是因为：

ABI不兼容：高版本GCC对C++ ABI做了修改，导致与老代码不兼容
语法变更：C++标准演进导致某些旧语法不再被支持
依赖关系：Qt 4.8.7是为特定GCC版本设计的，依赖特定编译器行为

关键考虑因素：

因素	高版本GCC	GCC 4.8
ABI兼容性	低	高
编译成功率	低	高
性能优化	好	一般
安全特性	完善	有限

2. 安装GCC 4.8的详细步骤

2.1 添加旧版软件源

由于GCC 4.8已从Ubuntu 20.10的默认源中移除，需要手动添加旧版源：

sudo nano /etc/apt/sources.list

在文件末尾添加以下内容：

deb http://dk.archive.ubuntu.com/ubuntu/ xenial main deb http://dk.archive.ubuntu.com/ubuntu/ xenial universe

2.2 处理公钥错误

更新源时可能会遇到公钥错误，解决方法：

sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 40976EAF437D05B5 sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 3B4FE6ACC0B21F32 sudo apt-get update

2.3 安装GCC 4.8

安装GCC和G++ 4.8版本：

sudo apt-get install gcc-4.8 g++-4.8

2.4 设置默认编译器

将GCC 4.8设为系统默认：

sudo update-alternatives --install /usr/bin/gcc gcc /usr/bin/gcc-4.8 40 \ --slave /usr/bin/g++ g++ /usr/bin/g++-4.8 \ --slave /usr/bin/gcov gcov /usr/bin/gcov-4.8 sudo update-alternatives --config gcc

选择GCC 4.8对应的编号，然后验证：

gcc --version

3. 编译Qt 4.8.7的完整流程

3.1 准备编译环境

首先安装必要的依赖：

sudo apt-get install libx11-dev libxext-dev libxtst-dev

3.2 配置Qt源码

解压源码并进入目录：

tar xf qt-everywhere-opensource-src-4.8.7.tar.gz cd qt-everywhere-opensource-src-4.8.7

初始配置命令：

./configure -opensource -no-openssl -no-sql-mysql

提示：如果之前尝试过配置，先运行make confclean清除旧配置

3.3 解决常见配置错误

可能遇到的错误及解决方案：

XLib功能测试失败：
- 确保已安装libx11-dev等包
- 检查/usr/include/X11是否存在
OpenGL相关错误：
```
sudo apt-get install libgl1-mesa-dev
```
缺少SQL驱动：
- 如果不需要数据库支持，可以添加-no-sql-*选项
- 或者安装相应开发包：libsqlite3-dev等

3.4 编译和安装

使用多核编译加速：

make -j$(nproc) sudo make install

编译时间可能较长，取决于系统配置。

4. 解决字体显示问题

Qt 4.8.7在现代系统上常遇到字体显示问题，特别是中文显示异常或字体模糊。

4.1 安装字体相关依赖

sudo apt-get install libfreetype6-dev libfontconfig1-dev sudo ln -s /usr/include/freetype2/freetype/ /usr/include/freetype

4.2 重新配置Qt

添加fontconfig支持重新配置：

./configure -opensource -no-openssl -no-sql-mysql -fontconfig make clean make -j$(nproc) sudo make install

4.3 配置系统字体

创建或修改~/.fonts.conf文件：

<?xml version="1.0"?> <!DOCTYPE fontconfig SYSTEM "fonts.dtd"> <fontconfig> <match target="font"> <edit name="antialias" mode="assign"> <bool>true</bool> </edit> <edit name="hinting" mode="assign"> <bool>true</bool> </edit> <edit name="hintstyle" mode="assign"> <const>hintslight</const> </edit> <edit name="rgba" mode="assign"> <const>rgb</const> </edit> </match> </fontconfig>

4.4 测试字体显示

创建一个简单的测试程序验证字体显示：

#include <QApplication> #include <QLabel> int main(int argc, char *argv[]) { QApplication app(argc, argv); QLabel label("中文测试 - 字体显示测试"); label.show(); return app.exec(); }

编译并运行，应该能看到清晰的中文显示。

5. 项目集成与维护建议

5.1 设置项目构建环境

在项目的.pro文件中添加：

QMAKE_CC = gcc-4.8 QMAKE_CXX = g++-4.8 QMAKE_LINK = g++-4.8

5.2 使用Docker容器隔离环境

为避免污染主机环境，可以考虑使用Docker：

FROM ubuntu:20.10 RUN apt-get update && apt-get install -y \ gcc-4.8 g++-4.8 \ libx11-dev libxext-dev libxtst-dev \ libfreetype6-dev libfontconfig1-dev # 设置默认GCC RUN update-alternatives --install /usr/bin/gcc gcc /usr/bin/gcc-4.8 40 \ --slave /usr/bin/g++ g++ /usr/bin/g++-4.8 \ --slave /usr/bin/gcov gcov /usr/bin/gcov-4.8