Ubuntu 21.04中qt5-default失效后如何安装Qt 5开发包
2026-10-22
Ubuntu 21.04及以上版本Qt5开发环境安装方案
旧版Ubuntu中可通过
sudo apt install qt5-default一键部署常用Qt5开发环境，但该聚合元包已从Ubuntu 21.04及后续版本的官方软件源中移除。这一调整是Debian系发行版为了减少冗余安装，将原聚合元包拆分为按功能细分的独立开发包导致的，目前不存在功能完全对等的同名元包，需拆分安装对应组件实现同等效果。
基础核心环境安装
原qt5-default元包的核心作用是聚合Qt5基础运行库、qmake构建工具、核心模块开发头文件，直接安装对应拆分后的官方包即可实现同等基础功能：
- 先更新本地软件源索引：
sudo apt update
- 安装Qt5开发核心套件：
sudo apt install qtbase5-dev qtchooser qt5-qmake qtbase5-dev-tools
安装完成后即可获得Qt5 Core、Gui、Widgets核心模块的编译能力，与旧版qt5-default覆盖的基础功能完全一致。
按需补充扩展功能模块
由于原元包不会自动拉取全量Qt5组件，遇到编译时提示缺失对应头文件、依赖的情况，可根据项目实际用到的功能安装对应扩展包：
- 多媒体系列功能：
sudo apt install libqt5multimedia5-plugins libqt5multimediawidgets5 libqt5multimedia5-dev - 网络、辅助工具模块：
sudo apt install qttools5-dev libqt5network5-dev - SQL数据库模块：
sudo apt install libqt5sql5-dev libqt5sql5-sqlite - 可视化设计工具（Qt Designer、UI文件自动编译工具）：
sudo apt install qttools5-dev-tools - QML/Quick场景开发支持：
sudo apt install qtdeclarative5-dev - 完整IDE环境（Qt Creator）：
sudo apt install qtcreator
常见配置问题处理
- 若执行
qmake --version发现默认指向Qt4版本或路径异常，可通过qtchooser工具将Qt5设为默认版本：
sudo qtchooser -install qt5 /usr/lib/qt5/bin/qmake export QT_SELECT=qt5
- 编译时找不到对应Qt模块头文件时，可通过
apt search qt5 | grep 模块关键词检索对应开发包，官方Qt5开发包的通用命名规则为libqt5<模块名>-dev。
内容的提问来源于stack exchange，提问作者ramon
相关产品推荐
相关产品推荐
