Ubuntu 20.04安装QtCharts 5.12依赖缺失如何解决？

Question

在Ubuntu 20.04系统中安装QtCharts模块（基于Qt 5.12）时，常因缺少对应的开发包导致依赖无法满足。典型错误提示为“无法定位软件包 libqt5charts5-dev”或依赖未满足。该问题源于系统默认仓库未启用包含Qt模块的附加源，或Qt 5.12未通过标准apt源完整提供。直接使用`apt install`命令无法自动解决依赖关系，进而阻碍项目编译。如何正确配置源并安装QtCharts 5.12的依赖包成为常见技术难题。

Answer 1

在Ubuntu 20.04中正确配置并安装QtCharts模块（基于Qt 5.12）的完整指南

1. 问题背景与常见错误分析

在Ubuntu 20.04系统中，开发者尝试使用apt install libqt5charts5-dev命令安装QtCharts开发包时，常遇到如下典型错误：

E: Unable to locate package libqt5charts5-dev
E: Package 'libqt5charts5-dev' has no installation candidate

该现象的根本原因在于：Ubuntu 20.04默认软件源并未包含Qt 5.12的所有官方扩展模块，尤其是像QtCharts、QtDataVisualization等非核心模块。这些模块虽然属于Qt 5生态系统，但被归类为“extra”或“universe”组件，需手动启用相关仓库才能访问。

此外，Qt 5.12并非Ubuntu 20.04原生捆绑版本（默认为Qt 5.12.8，但部分模块缺失），导致即使基础Qt库存在，也无法满足项目对特定开发头文件和链接库的需求。

2. 系统环境确认与依赖检查

在进行任何安装操作前，应首先确认当前系统的Qt版本及已安装组件：

dpkg -l | grep qt5

输出示例可能包括：

包名	描述	状态
libqt5core5a	Qt 5核心库	已安装
libqt5gui5	GUI模块	已安装
libqt5widgets5	Widgets支持	已安装
qtbase5-dev	基础开发包	已安装
libqt5charts5	运行时库	未安装
libqt5charts5-dev	开发头文件与静态库	未安装

3. 启用Universe与Multiverse软件源

QtCharts模块位于Ubuntu的universe仓库中。若该源未启用，则无法通过apt发现相关包。执行以下命令确保启用：

sudo add-apt-repository universe
sudo add-apt-repository multiverse
sudo apt update

此步骤是解决“无法定位软件包”问题的前提条件。许多资深开发者忽略此点，误以为APT源本身存在问题，实则为本地仓库配置缺失。

4. 安装QtCharts 5.12对应开发包

完成源更新后，可尝试直接安装目标包：

sudo apt install libqt5charts5 libqt5charts5-dev

若系统提示版本不匹配或依赖冲突，可通过apt-cache policy libqt5charts5-dev查看可用版本：

libqt5charts5-dev:
  Installed: (none)
  Candidate: 5.12.8-0ubuntu1
  Version table:
     5.12.8-0ubuntu1 500
        500 http://archive.ubuntu.com/ubuntu focal/universe amd64 Packages

结果显示Ubuntu 20.04确实在universe中提供了QtCharts 5.12.8的开发包，满足项目需求。

5. 验证安装结果与编译测试

安装完成后，验证头文件是否存在：

ls /usr/include/x86_64-linux-gnu/qt5/QtCharts/

预期输出包含QChart、QLineSeries等类头文件。接着编写一个最小化测试程序：

#include <QtCharts/QChartView>
#include <QtCharts/QLineSeries>
#include <QApplication>
#include <QMainWindow>

int main(int argc, char *argv[]) {
    QApplication app(argc, argv);
    QtCharts::QLineSeries *series = new QtCharts::QLineSeries();
    series->append(0, 6);
    series->append(2, 4);

    QtCharts::QChart *chart = new QtCharts::QChart();
    chart->addSeries(series);
    chart->createDefaultAxes();

    QtCharts::QChartView *view = new QtCharts::QChartView(chart);
    view->setRenderHint(QPainter::Antialiasing);

    QMainWindow window;
    window.setCentralWidget(view);
    window.resize(400, 300);
    window.show();

    return app.exec();
}

配合以下.pro文件即可成功编译：

QT += charts
TARGET = testcharts
TEMPLATE = app
SOURCES += main.cpp

6. 替代方案：使用Qt官方在线安装器

当APT方式受限时（如需更高版本或定制构建），推荐使用Qt官方提供的在线安装器：

1. 下载Qt Online Installer
2. 注册免费账户并登录
3. 选择安装路径（建议非/usr目录）
4. 勾选Qt 5.12.x → Desktop gcc 64-bit → Qt Charts
5. 完成安装后，在Qt Creator中配置新的Kit指向该安装路径

此方法优势在于模块完整性高、版本可控，适合复杂项目或多版本共存场景。

7. 故障排查流程图

以下是处理此类依赖问题的标准决策流程：

graph TD
            A[开始] --> B{是否启用universe源?}
            B -- 否 --> C[执行 sudo add-apt-repository universe]
            C --> D[sudo apt update]
            B -- 是 --> D
            D --> E{能否找到libqt5charts5-dev?}
            E -- 否 --> F[检查网络/镜像源可用性]
            F --> G[更换为官方镜像源]
            G --> D
            E -- 是 --> H[安装libqt5charts5-dev]
            H --> I{编译失败?}
            I -- 是 --> J[检查qmake或cmake是否链接正确Qt版本]
            J --> K[确认PKG_CONFIG_PATH或CMAKE_PREFIX_PATH设置]
            I -- 否 --> L[安装成功]

8. 进阶建议：构建私有APT仓库或Docker镜像

对于团队开发环境，建议将已配置好的Qt开发环境封装为Docker镜像，避免重复配置。示例Dockerfile片段：

FROM ubuntu:20.04
RUN apt update && \
    apt install -y software-properties-common && \
    add-apt-repository universe && \
    apt update && \
    apt install -y qtbase5-dev libqt5charts5-dev g++ make cmake
WORKDIR /app
COPY . .
RUN qmake && make
CMD ["./app"]

此举提升环境一致性，降低“在我机器上能跑”的协作成本。