CLion+Qt开发环境在Archlinux上的部署

写在前面的话

  Qt是一个跨平台的C++应用程序开发框架，常被前端程序员用于设计和开发GUI程序。而CLion则是由JetBrains开发的一款功能强大的跨平台IDE，用于开发C/C++程序。

  Qt集成开发环境中自带QtCreator作为用于编写程序的IDE是相当不错的，但笔者作为多平台用户，已经习惯了CLion的C++开发环境，因此尝试使用CLion作为开发Qt程序的平台。CLion本身就支持创建Qt程序项目，也支持使用QtDesigner（Qt集成开发环境中的可视化图形设计界面）作为外部工具，因此其部署操作其实并不复杂。但是由于网络上的教程普遍是基于windows系统的，而Linux系统基本照搬windows系统的部署方式在理论上也没有问题（毕竟都是跨平台应用，基代码完全可以移植）。但实际过程中笔者还是踩了不少坑，发现了一些可能不会在windows上发生但在Linux上却会的问题。本文将会简单描述Qt+CLion环境在Archlinux上的部署方法和对于可能碰到问题的解决方案。

部署过程

安装Qt5.15.x

  Qt在Linux上的安装方法在网络上有许多，这里以笔者使用的ArchLinux为例（不同系的Linux安装方法大同小异，网上基本都能找的到，这里就不赘述了）。Qt5.x和6.x版本可以从Arch的官方仓库中安装，较早版本则可以从Aur仓库中安装。这里笔者推荐安装的是5.15版本，Qt5是较为稳定并长期支持的版本。打开终端并输入以下指令：

1
2
3

sudo pacman -Syyu
sudo pacman -S qt5-base
sudo pacman -S qt5-doc

如果需要使用Qt自带的IDE，则可以也安装Qtcreator:

1

sudo pacman -S qtcreator

因为要使用CLion作为开发环境，因此不安装Qtcreator也可以。关于Qt的安装与配置，可以查看官方wiki关于Qt的说明。

  如果你使用的是KDE桌面系统，那么大概率你已经在安装桌面系统的时候也已经安装了了Qt的相关开发组件了（毕竟KDE就是基于Qt的GUI工具开发的）。可以通过以下指令查看系统中安装的qmake以及Qt组件的版本，也能获得Qt安装位置的信息：

1

qmake -v

如果输入后系统报错找不到该指令，说明你的系统中并没有安装Qt基础组件，或者你的qmake程序不能在/usr/bin/这个目录下找到。qmake不在该目录的情况有可能是因为没有通过系统的软件包管理器进行下载，而是通过官方的下载器或者离线包手动安装Qt。那么可以尝试以下指令来qmake程序连接到指定目录：

1

ln -s /你的Qt路径/Qt版本号/gcc_64/bin/qmake /usr/bin

如果输入qmake版本查询指令后Qmake显示没有指定Qmake路径和版本，或者你安装了多个版本的Qt，想要指定某个版本使用，那么需要更改Qtchooser相关设置，这是可以让你指定Qt以及Qmake版本的package。关于Qtchooser的使用方法，相关文档有很多，可以自行网上查找。一般情况下Qtchooser会默认指定一个版本，不需要手动更改操作。

CLion配置Qt环境

  首先当然是要安装CLion，进入JetBrains的CLion官方下载页面下载相关包并安装，当然Arch的aur库中也有CLion的软件包，可以使用yay或者paru等管理包直接安装：

1

paru -S clion #或者yay -S clion

下载后打开CLion并创建一个QtWidgets项目，如下所示：

语言标准和Qt版本按照自己的安装情况来选。版本为5就是版本号为5.x.x，其他同理。这里笔者安装的是5.15版本，那么就选择5。

  Qt Cmake prefix path是让Cmake文件在编译时查找到你的Qt组件。正常使用官方库安装一般不需要填写这一栏。如果你是手动安装，或者在之后项目编译时报错找不到Qt，那么需要在这一栏添加你的Qt路径，或者在项目的CMakeLists.txt中，在find_package()这个函数之前添加如下代码：

1

set(cmake_prefix_path "你的Qt安装路径")

当然还有方法，那就是将这个前置路径添加到你的环境变量里。在终端中输入以下指令：

1

export CMAKE_PREFIX_PATH = 你的Qt安装路径

以上两种设置方法是笔者在网上搜到的，因每个人安装的环境系统不同不能保证其可行性。关于Cmake编译Qt的相关事项可以查看这里的Qt官方文档。

  项目创建完毕后该项目会自带示例代码。我们直接编译运行main.cpp文件看是否能成功运行：

成功运行后就可以看到示例程序，是一个被"Hello world!"的按钮填充的窗口，窗口名就是项目名称。

  当然，到现在为止你已经可以使用CLion编写Qt相关程序了。但是我们还需要配置Qt的GUI设计工具，这样就可以在设计窗口样式时使用可视化界面，而不是对着代码慢慢调了。Qt的可视化图形设计界面工具是Qtdesigner，一般包含在我们安装好的qt-base软件包中，不需要单独安装。现在我们需要在CLion中导入这个工具。在CLion的设置菜单中选择工具外部工具，并将designer(或者是designer-qt5)程序添加到外部工具中，如下图：

程序栏中输入Qtdesigner程序的目录，可以参考笔者这里填写的路径，目标程序名可以是designer 或者 designer-qt5。参数栏和工作路径参考上图中笔者输入的信息，这样可以保证只要你创建的文件在项目的子目录中都可以被找到。

  创建完成后，在项目目录下创建一个Qt .ui类文件(你可以在项目目录下把它创建在你想要的地方)。创建这个文件时会自动创建同名的.h头文件和.cpp。然后右键你的.ui文件，使用外部工具Designer打开：

打开后就可以在该界面下可视化设计窗口组建了：

设计好窗口后，保存退出该界面。此时如果需要使用刚刚保存的那个窗口，就可以在main.cpp中引入与刚刚ui类一起被创建的头文件（在笔者的例子中是testui.h），在这个头文件中被声明的类就是之前所保存的那个窗口类。我们通过这个类声明一个变量，并通过.show()函数将他显示出来。以下是示例代码：

1
2
3
4
5
6
7
8
9

#include <QApplication>
#include "testui.h"
int main(int argc, char *argv[])
{
    QApplication a(argc, argv);
    testui w;
    w.show();
    return a.exec();
}

  在运行之前，我们需要检查Cmake的配置，保证新增的三个文件也能被编译。在项目下CMakeLists.txt中的add_executable()一行修改参数，加入所有需要编译的文件：

1

add_executable(qt_test main.cpp testui.cpp testui.h testui.ui)

通常情况下，CLion会自动将新增文件加入到编译文件列表中，不需要手动加入。

  随后我们编译并运行该项目，成功显示该窗口：

  可能出现的问题：AutoUic error

1
2
3
4
5
6
7
8
9

AutoUic error
-------------
"SRC:/testui.cpp"
includes the uic file "ui_testUi.h",
but the user interface file "testUi.ui"
could not be found in the following directories
  "SRC:"

ninja: build stopped: subcommand failed.

Uic是将你的.ui类文件转化为.h头文件的用户界面编译器，CLion会默认在CMakeList.txt中将其设置为自动编译。出现自动编译错误的情况往往是在创建ui类时其名称中带有大写字符（AutoUic的一个奇怪的特性，你创建的时候输入大写，但是实际生成的.ui文件和相应头文件都是小写，头文件里的类又是大写，这很可能导致uic编译时参数错误无法生产正确的头文件或是头文件名）。

  想要避免这个错误，在创建.ui类时请将其名称设置为全小写字母。如果你需要使用大写名作为ui类的名称，那么也可以手动来使用uic编译.ui文件。在你的.ui文件所在目录下输入如下简单的命令:

1

uic 你的ui类文件名.ui -o ui_你的ui类文件名.h

这样就会在.ui文件的同目录下生产ui_开头的头文件。

  如果你经常会使用上述方法手动使用uic,那么笔者这里推荐可以吧uic也加入到外部工具中，添加和使用方法与Qtdesigner一致，添加时的各参数如下：

注意参数栏请按照笔者上面的写法，使用效果与命令行使用的方法一致。程序一栏根据uic程序所在目录调整。

  至此CLion+Qt的开发环境基本配置完成。

后话

  兴趣使然发的第一篇博客，没啥技术含量。CLion本身对Qt的支持就很好，本篇主要记录笔者在CLion配置Qt工具的过程和碰到问题的一些解决方法。一些问题在第一次配置时碰到真的很令人头大，因为网上检索的资料的解决方法部分没有具体说明针对的错误情况，这导致需要对这些方法一个个尝试（有一些问题甚至能检索到的资料很少TAT）。本篇提到了某些问题的具体解决方案，至少在笔者遇到这些问题时能够解决，也有一些并未尝试的方法是考虑到可能出现的状况而提出的，其部分来源于网上检索到的资料，也有来源于官方文档。

  文章篇幅有限，可能有疏漏或错误之处，欢迎指出。