linux中怎么用Qt Creator工具编译Qt工程

发布时间：2021-11-30 09:07:09 作者：iii
来源：亿速云阅读：611

# Linux中怎么用Qt Creator工具编译Qt工程

## 前言

Qt Creator是Qt官方提供的跨平台集成开发环境(IDE)，专门用于Qt应用程序的开发。在Linux系统中，Qt Creator提供了强大的项目管理、代码编辑、调试和编译功能。本文将详细介绍如何在Linux环境下使用Qt Creator工具编译Qt工程，涵盖从环境配置到实际操作的完整流程。

---

## 目录

1. [环境准备](#环境准备)
2. [安装Qt Creator](#安装qt-creator)
3. [创建Qt工程](#创建qt工程)
4. [配置构建套件](#配置构建套件)
5. [编译与运行](#编译与运行)
6. [常见问题解决](#常见问题解决)
7. [高级配置技巧](#高级配置技巧)
8. [总结](#总结)

---

## 环境准备

在开始之前，请确保您的Linux系统满足以下要求：

- **操作系统**：Ubuntu/Debian、Fedora、CentOS等主流发行版（本文以Ubuntu为例）
- **依赖工具**：
  ```bash
  sudo apt update
  sudo apt install build-essential cmake git

Qt库：建议通过Qt官方安装器或系统包管理器安装（如sudo apt install qt5-default）

安装Qt Creator

方法1：通过包管理器安装（推荐）

# Ubuntu/Debian
sudo apt install qtcreator

# Fedora
sudo dnf install qt-creator

方法2：从Qt官网下载

访问Qt下载页面
选择开源版本并下载Linux安装包

执行安装脚本：


chmod +x qt-unified-linux-x64-*.run
./qt-unified-linux-x64-*.run

安装完成后，在终端输入qtcreator或通过应用菜单启动。

创建Qt工程

启动Qt Creator后点击”New Project”
选择项目类型：
- Qt Widgets Application（传统桌面UI）
- Qt Quick Application（QML界面）
- Console Application（命令行程序）
设置项目名称和路径（建议避免使用空格和特殊字符）
选择构建套件（后续可修改）
完成向导后自动生成基础代码结构

![项目结构示例]

MyProject/
├── CMakeLists.txt  # 或.pro文件
├── main.cpp
├── mainwindow.cpp
└── mainwindow.h

配置构建套件

检查工具链

通过菜单栏进入Tools > Options > Kits： - 编译器：确保检测到GCC或Clang - Qt版本：显示已安装的Qt路径（如/usr/lib/x86_64-linux-gnu/qt5） - 调试器：通常自动配置GDB

添加自定义套件（如需）

手动指定qmake路径（如/opt/Qt/5.15.2/gcc_64/bin/qmake）
选择交叉编译工具链（针对嵌入式开发）

编译与运行

基本流程

点击左下角的Build按钮（或按Ctrl+B）
查看Compile Output面板的实时日志
成功编译后点击Run（绿色三角图标）

构建模式切换

Debug：包含调试符号，无优化
Release：启用优化，去除调试信息
Profile：介于两者之间

常用快捷键

操作	快捷键
构建	Ctrl+B
运行	Ctrl+R
调试	F5
清理项目	Ctrl+Shift+B

常见问题解决

1. 找不到Qt库

错误示例：

cannot find -lQt5Core

解决方案：

sudo apt install qtbase5-dev libqt5svg5-dev

2. 构建目录权限问题

sudo chown -R $USER:$USER /path/to/build/directory

3. 中文乱码

在main.cpp中添加：

#include <QTextCodec>
QTextCodec::setCodecForLocale(QTextCodec::codecForName("UTF-8"));

4. 插件加载失败

检查环境变量：

export QT_PLUGIN_PATH=/path/to/qt/plugins

高级配置技巧

1. 自定义构建步骤

在.pro文件中添加：

# 添加预处理定义
DEFINES += USE_CUSTOM_FEATURE

# 链接外部库
LIBS += -L/path/to/lib -lmylib

2. 使用CMake管理项目

现代Qt项目推荐使用CMake：

cmake_minimum_required(VERSION 3.5)
project(MyApp LANGUAGES CXX)

find_package(Qt5 REQUIRED COMPONENTS Widgets)

add_executable(MyApp main.cpp)
target_link_libraries(MyApp Qt5::Widgets)

3. 集成版本控制

Qt Creator原生支持Git： - 通过Tools > Git > Create Repository初始化 - 提交时自动忽略构建目录

4. 性能优化

启用并行编译：在Projects > Build Settings中设置-j$(nproc)
使用预编译头（PCH）：
```
PRECOMPILED_HEADER = stable.h
```

总结

通过本文的指导，您应该已经掌握： 1. Qt Creator在Linux下的安装与配置 2. 创建和管理Qt项目的基本方法 3. 构建套件的关键配置项 4. 常见问题的诊断与解决 5. 高级开发技巧的应用

建议进一步探索： - Qt官方文档：doc.qt.io - 学习QML开发现代UI界面 - 研究Qt的跨平台部署方法

注意：本文基于Qt 5.15和Ubuntu 22.04编写，不同版本可能存在细微差异。

![Qt Creator界面示意图]（可选配图说明）

最后更新：2023年10月 “`

注：实际使用时需要： 1. 补充图片路径（如![描述](path/to/image.png)） 2. 根据具体Linux发行版调整包管理命令 3. 检查代码片段中的Qt版本路径是否与实际安装一致 4. 扩展每个章节的细节（如添加更多截图示例）以达到完整字数要求