上一篇
Linux如何安装Qt?
- Linux
- 2025-06-14
- 4515
在Linux安装Qt,推荐下载官方在线安装器,运行后选择所需组件(如Qt版本、开发工具)并指定安装路径即可,安装器会自动处理常见依赖项。
安装前的准备
-
更新系统
确保系统处于最新状态(适用于Debian/Ubuntu、Fedora等):sudo apt update && sudo apt upgrade # Debian/Ubuntu sudo dnf update # Fedora/CentOS
-
安装基础依赖
编译和运行Qt需要以下工具:sudo apt install build-essential libgl1-mesa-dev libxkbcommon-x11-dev # Debian/Ubuntu sudo dnf groupinstall "Development Tools" # Fedora/CentOS
安装Qt的三种主流方法
方法1:使用官方在线安装器(推荐)
适用场景:需要最新版本、多版本共存或商业版。
- 下载安装器
访问 Qt官方下载页面,选择开源版(Open Source):wget https://download.qt.io/official_releases/online_installers/qt-unified-linux-x64-online.run
- 赋予执行权限
chmod +x qt-unified-linux-x64-online.run
- 运行安装器
./qt-unified-linux-x64-online.run
- 安装向导步骤:
- 登录或注册Qt账户(开源用户勾选”Use for Open Source”)。
- 选择安装目录(默认
~/Qt
)。 - 勾选需要的组件:
- Qt版本:如Qt 6.5.0。
- 开发工具:必选Qt Creator(IDE)。
- 附加库:如Qt Multimedia、Qt WebEngine。
- 等待下载完成(约5-20分钟,取决于网络和组件)。
方法2:通过包管理器安装
适用场景:快速安装稳定版(版本可能较旧)。
- Debian/Ubuntu:
sudo apt install qt6-base-dev qt6-creator # Qt6 sudo apt install qt5-default qtcreator # Qt5
- Fedora/CentOS:
sudo dnf install qt6-qtbase-devel qt-creator # Qt6 sudo dnf install qt5-qtbase-devel qt-creator # Qt5
方法3:源码编译安装
适用场景:自定义功能或调试源码(耗时长)。
- 下载源码(以Qt 6.5.0为例):
wget https://download.qt.io/official_releases/qt/6.5/6.5.0/single/qt-everywhere-src-6.5.0.tar.xz tar -xvf qt-everywhere-src-6.5.0.tar.xz cd qt-everywhere-src-6.5.0
- 配置编译选项:
./configure -prefix /opt/qt6 -opensource -confirm-license -nomake examples # 跳过示例节省时间
- 编译并安装:
cmake --build . --parallel $(nproc) # 使用所有CPU核心 sudo cmake --install .
安装后配置
- 环境变量设置
编辑~/.bashrc
或~/.zshrc
:echo 'export PATH="$PATH:~/Qt/Tools/QtCreator/bin"' >> ~/.bashrc # 如果使用官方安装器 echo 'export PATH="$PATH:/opt/qt6/bin"' >> ~/.bashrc # 如果源码安装到/opt/qt6 source ~/.bashrc
- 验证安装
qmake --version # 查看Qt5版本 qmake6 --version # 查看Qt6版本 qtcreator & # 启动Qt Creator
常见问题解决
- 安装器无法启动:
检查执行权限或尝试图形界面双击运行,若报错cannot execute binary file
,确认下载的是64位版本。 - Qt Creator无法识别Kit:
打开Qt Creator > Tools > Options > Kits,手动指定编译器路径(如/usr/bin/g++
)。 - 缺少OpenGL库:
安装Mesa驱动:sudo apt install mesa-common-dev libglu1-mesa-dev
。 - 商业版许可:
在安装器登录时选择商业许可证,或联系Qt销售团队获取激活码。
卸载Qt
- 官方安装器安装:
重新运行安装器,选择 Remove Component。 - 包管理器安装:
sudo apt remove qt6-* qt5-* qtcreator # Debian/Ubuntu sudo dnf remove qt6-* qt5-* qtcreator # Fedora
- 推荐新手:使用官方在线安装器,图形化操作简单且能灵活选择组件。
- 追求便捷:通过系统包管理器安装,但版本可能滞后。
- 高级用户:源码编译可深度定制,但需较长时间。
引用说明:
- Qt官方安装指南:Qt Documentation
- 依赖库参考:Ubuntu Packages, Fedora Packages
- 开源许可协议:Qt Open Source Licensing
通过以上步骤,你可以在大多数Linux发行版上成功安装并配置Qt开发环境,建议定期访问Qt官网获取更新和安全补丁。