安装前准备
-
更新系统
sudo apt update && sudo apt upgrade # Debian/Ubuntu sudo dnf update # Fedora
-
安装编译工具链
sudo apt install build-essential libgl1-mesa-dev # OpenGL支持 sudo apt install libxcb-xinerama0-dev # X11依赖
安装Qt核心组件
方法1：官方在线安装器（推荐）
- 下载安装器
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账户（无账户需注册）
- 选择安装目录（建议
/opt/Qt） - 勾选组件：
- Qt 6.x.x（最新稳定版）
- Qt Creator（IDE）
- Qt Debugging Tools
- 对应桌面环境的组件（如Linux Desktop）
方法2：包管理器安装（简易版）
sudo apt install qt6-base-dev qt6-tools-dev qtcreator # Ubuntu 22.04+ sudo dnf install qt6-qtbase-devel qt6-qttools qt-creator # Fedora
环境变量配置
-
添加Qt路径到PATH
编辑~/.bashrc：echo 'export PATH="/opt/Qt/6.x.x/gcc_64/bin:$PATH"' >> ~/.bashrc source ~/.bashrc
替换
x.x为实际安装版本 -
验证安装
qmake --version # 显示Qt版本 qtcreator --version # 检查IDE
创建测试项目
- 启动Qt Creator
qtcreator
- 新建项目
- 选择 File > New Project > Qt Widgets Application
- 设置项目名称和路径
- 选择Kit：Desktop Qt 6.x.x GCC
- 构建并运行
点击左下角 运行按钮，自动生成带按钮的窗口程序
常见问题解决
| 问题现象 | 解决方案 |
|---|---|
| 无法打开GL渲染 | 安装libgl1-mesa-dev并检查显卡驱动 |
| 缺少xcb依赖 | 安装libxcb*开发包：sudo apt install libxcb-xinerama0-dev |
| qmake命令未找到 | 检查.bashrc路径配置，确认安装目录存在bin/qmake |
| Qt Creator无Kit | 打开 Tools > Kits，手动添加Qt版本路径 |
高级配置建议
- 多版本管理
在安装器中勾选多个Qt版本，通过Qt Creator的Kits切换 - 自定义构建套件
在 Tools > Options > Kits 中配置交叉编译工具链 - 插件扩展
安装Qt Design Studio插件增强UI设计能力
关键提示：
- 优先使用官方安装器获取完整组件和更新支持
- 开发商业应用需注意LGPLv3/GPL许可证合规性
- 定期通过
MaintenanceTool更新组件（位于安装目录）
引用资源
- Qt官方安装指南
- Qt在线安装器下载页
- Linux依赖项文档
- Qt论坛技术支持
通过上述步骤,您将获得完整的Qt开发环境，建议首次安装后重启系统确保环境变量生效，复杂项目需检查CMakeList.txt中的Qt路径配置。
原创文章，发布者：酷番叔，转转请注明出处：https://cloud.kd.cn/ask/9154.html
