安装前的准备
-
系统更新
打开终端执行：sudo apt update && sudo apt upgrade # Debian/Ubuntu sudo dnf update # Fedora
-
安装基础依赖
sudo apt install build-essential libgl1-mesa-dev # Debian/Ubuntu sudo dnf groupinstall "Development Tools" # Fedora
安装Qt的三种主流方法
方法1：使用官方在线安装器（推荐）
-
下载安装器
访问 Qt官方下载页面 获取安装脚本：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账户（选择”Skip”可跳过）
- 选择安装目录（默认
~/Qt） - 勾选所需组件（如最新版 Qt 6.x、Qt Creator、对应平台的开发套件）
- 建议勾选 Qt Debugging Tools 和 Qt Documentation
-
配置环境变量
编辑~/.bashrc或~/.zshrc，添加：export PATH="$HOME/Qt/Tools/QtCreator/bin:$PATH" export PATH="$HOME/Qt/6.x.x/gcc_64/bin:$PATH" # 替换6.x.x为实际版本
生效配置：
source ~/.bashrc
方法2：通过包管理器安装（适合快速部署）
-
Debian/Ubuntu：
sudo apt install qt6-base-dev qt6-tools-dev qtcreator
-
Fedora：
sudo dnf install qt6-qtbase-devel qt6-qttools-devel qt-creator
⚠️ 注意：仓库版本可能滞后于官方最新版。
方法3：源码编译安装（适合定制化需求）
- 下载源码包（如 qt-everywhere-src-6.x.x.tar.xz）
- 解压并编译：
tar -xvf qt-everywhere-src-6.x.x.tar.xz cd qt-everywhere-src-6.x.x ./configure -prefix /opt/qt6 # 指定安装路径 cmake --build . --parallel 4 # 根据CPU核心数调整并行编译数 sudo cmake --install .
验证安装
-
检查Qt版本
qmake --version # 显示Qt版本及qmake路径
-
启动Qt Creator
终端输入qtcreator或通过应用菜单打开IDE。 -
创建测试项目
- 在Qt Creator中新建 Qt Widgets Application
- 编译运行默认模板,出现窗口即表示成功。
常见问题解决
-
报错 “GL/gl.h: No such file”：
安装OpenGL库：sudo apt install mesa-common-dev -
Qt Creator无法识别编译器：
在菜单栏选择 Tools > Options > Kits，手动指定编译器和Qt版本路径。 -
权限问题：
使用sudo运行安装器可能导致用户目录权限错误，建议以普通用户身份执行。
最佳实践建议
- 多版本共存：通过Qt安装器管理不同版本（如5.15和6.2），在项目中灵活切换。
- 空间优化：安装时仅勾选必要组件（如Android开发需额外勾选Android套件）。
- 文档集成：在Qt Creator中通过 Help > Index 直接查看离线API文档。
引用说明：
- Qt官方安装指南：doc.qt.io/qt-6/linux.html
- 依赖项参考：Ubuntu Packages Search
- 安全建议：仅从官方域名
download.qt.io下载安装器 更新于2025年10月，适用于Qt 5.15及以上版本。*
原创文章，发布者：酷番叔，转转请注明出处：https://cloud.kd.cn/ask/8513.html
