Qt Creator: установка и настройка в Linux

Два способа установки

  1. Из репозитория дистрибутива — быстрее и проще, рекомендуется.
  2. Онлайн-установщик с qt.io — если нужна конкретная версия Qt.

Способ 1: репозиторий дистрибутива

ДистрибутивКоманда
Ubuntu / Debiansudo apt update && sudo apt install qtcreator qt6-base-dev cmake ninja-build g++ gdb
Fedorasudo dnf install qt-creator qt6-qtbase-devel cmake ninja-build gcc gcc-c++ gdb
Arch / Manjarosudo pacman -S qtcreator qt6-base cmake ninja gcc gdb
openSUSEsudo zypper install qt6-creator qt6-base-devel cmake ninja gcc gdb

Если пакет не найден, уточните имя: apt search qtcreator, dnf search qt-creator, pacman -Ss qtcreator. В разных выпусках имена немного отличаются.

Способ 2: онлайн-установщик

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

Выберите Custom installation → Qt 6.x → Desktop gcc 64-bit, Developer and Designer Tools → Qt Creator, CMake, Ninja. Если установщик ругается на библиотеки:

sudo apt install libxcb-xinerama0 libxcb-cursor0 libgl1-mesa-dev libxkbcommon-x11-0

Проверка после установки

gcc --version
gdb --version
cmake --version

В Qt Creator: Tools → Options → Kits — у набора Desktop Qt 6.x GCC 64-bit не должно быть жёлтого треугольника. Затем File → New Project → Non-Qt Project → Plain C Application, Ctrl+B — сборка, Ctrl+R — запуск.

Рис. 1. Окно Qt Creator: комплект, проект и запуск
Рис. 1. Окно Qt Creator: комплект, проект и запуск
#include <stdio.h>

int main(void)
{
    printf("Hello from Linux!\n");
    return 0;
}

Компилятор не запускается: диагностика

Нажмите Ctrl+B и откройте вкладки Compile Output и General Messages — дальше по случаю.

Случай A. Жёлтый треугольник у kit, «No compiler found»

  1. Установите компилятор: sudo apt install build-essential gcc g++ (Fedora — gcc gcc-c++, Arch — base-devel).
  2. Tools → Options → Kits → Desktop (default):
    • Compiler / C: /usr/bin/gcc, C++: /usr/bin/g++;
    • Debugger: /usr/bin/gdb;
    • CMake Tool: /usr/bin/cmake;
    • Qt version: установленный Qt 6.
  3. Re-detect → Apply → перезапуск Qt Creator.

Случай B. «CMake configuration failed», нет CMake или Ninja

sudo apt install cmake ninja-build     # Fedora: sudo dnf install cmake ninja-build

Затем Tools → Options → CMake — проверьте путь к cmake, и в проекте выполните Run CMake (правой кнопкой по проекту).

Случай C. Сборка не стартует

  1. Проверьте, что у проекта выбран kit.
  2. Build → Clean All, затем Build → Run CMake, снова Ctrl+B.
  3. Посмотрите General Messages — там часто написана настоящая причина.

Случай D. Собралось, но не запускается

  1. Запускайте из Qt Creator (Ctrl+R) и смотрите Application Output.
  2. В терминале проверьте вручную:
cd build
./имя_программы
  1. Если не хватает прав — chmod +x на исполняемый файл; если «No such file» — проверьте путь к собранному файлу в Projects → Run.

Случай E. Особенности Linux

  • Wayland: окна Qt Creator могут вести себя странно — запустите QT_QPA_PLATFORM=xcb qtcreator.
  • Snap-версия: ограничена домашним каталогом — держите проекты в ~.
  • Права: не работайте под root; при необходимости sudo chown -R "$USER":"$USER" ~/проект.

Что собрать для преподавателя

Версию Qt Creator (Help → About), скриншот Tools → Options → Kits, вывод gcc --version и текст Compile Output / General Messages.

Отладка

F9 — точка останова, F5 — запуск под отладчиком, F10/F11 — шаги. Нужен пакет gdb.

Настройка под курс

  • Кодировка в Linux — UTF-8 по умолчанию.
  • Отступы: Tools → Options → Text Editor → Behavior → Tab size = 4, Insert spaces.
  • Сборка из терминала (для проверки):
gcc -Wall -Wextra -g main.c -o main && ./main

Частые проблемы

СимптомРешение
cannot find -lGLsudo apt install libgl1-mesa-dev
could not load the Qt platform plugin "xcb"libxcb-xinerama0 libxcb-cursor0 libxkbcommon-x11-0
Компилятор не найден в kitbuild-essential + настроить kit (случай A)
CMake не найденcmake ninja-build (случай B)
Отладчик не стартуетустановите gdb и перезапустите Qt Creator

Что запомнить

Qt Creator — основная среда курса и на Linux: ставится из репозитория одной командой. Порядок диагностики тот же, что в Windows: Compile Output → kit → компилятор/CMake.

Подтверждение

—