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

Как устроена установка в курсе

Qt Creator ставится по инструкции курса: https://lms.crafted.su/tech-notes/2026-09-02-install-mingw-and-qt-creator/

Схема отличается от «обычной» установки Qt из интернета. Ставится три части по отдельности:

  1. MSYS2 — из него берётся компилятор mingw-w64 (gcc, g++, gdb), а также CMake и Ninja;
  2. Qt Creator 19 — отдельным архивом qtcreator.7z с зеркала (Qt Online Installer не используется);
  3. вспомогательное: Visual C++ Redistributable (нужен для запуска Qt Creator) и 7-Zip (распаковать архив).

Библиотека Qt (framework) не устанавливается — она нам не нужна. Программы консольные, на языке C, поэтому в мастере выбираем «Проект без Qt» → «Приложение на языке C».

Шаг 1. Установка MSYS2

  1. Откройте https://www.msys2.org/ и скачайте установщик msys2-x86_64…exe.
  2. Запустите его от имени администратора и пройдите шаги.
  3. Путь оставьте по умолчанию — C:\msys64 (если меняете, запомните путь: он нужен в .bat).
Рис. 1. Скачивание установщика MSYS2
Рис. 1. Скачивание установщика MSYS2
Рис. 2. Путь установки по умолчанию — C:\msys64
Рис. 2. Путь установки по умолчанию — C:\msys64
Рис. 3. Завершение установки MSYS2
Рис. 3. Завершение установки MSYS2

Шаг 2. Компилятор, CMake и Ninja

  1. Запустите MSYS2 MSYS от имени администратора.
  2. Вставьте команду (правая кнопка мыши → Paste) и нажмите Enter:
pacman -S --needed base-devel mingw-w64-ucrt-x86_64-toolchain mingw-w64-ucrt-x86_64-cmake mingw-w64-x86_64-ninja
  1. Установщик дважды попросит подтверждение — нажмите Enter (ничего вводить не нужно).
  2. Дождитесь завершения и закройте окно.
Рис. 4. Запуск MSYS2 MSYS от имени администратора
Рис. 4. Запуск MSYS2 MSYS от имени администратора
Рис. 5. Команда установки пакетов введена
Рис. 5. Команда установки пакетов введена
Рис. 6. Подтверждение установки — Enter
Рис. 6. Подтверждение установки — Enter
Рис. 7. Пакеты установлены
Рис. 7. Пакеты установлены

После этого компилятор и отладчик лежат в C:\msys64\ucrt64\bin (gcc.exe, g++.exe, gdb.exe), CMake — там же.

В команде курса Ninja ставится из репозитория mingw64 (не ucrt), поэтому ninja.exe может оказаться в C:\msys64\mingw64\bin, а его нет в PATH из ярлыка. Если CMake не находит Ninja — см. диагностику, случай B.

Шаг 3. Qt Creator из архива

  1. Поставьте Visual C++ Redistributable: https://aka.ms/vc14/vc_redist.x64.exe (от имени администратора).
  2. Поставьте 7-Zip: https://www.7-zip.org/.
  3. Скачайте qtcreator.7z (Qt Creator 19.0.2) из зеркала: https://mirror.yandex.ru/mirrors/qt.io/official_releases/qtcreator/19.0/19.0.2/installer_source/windows_x64/ Нужен именно файл qtcreator.7z из каталога installer_source/windows_x64, а не установщик.
  4. Распакуйте архив (7-Zip → «Распаковать в “qtcreator\”») и переместите каталог qtcreator в корень диска C:, чтобы получился C:\qtcreator — внутри должны быть bin, lib, share.
Рис. 8. Visual C++ Redistributable
Рис. 8. Visual C++ Redistributable
Рис. 9. 7-Zip для распаковки архива
Рис. 9. 7-Zip для распаковки архива
Рис. 10. Распаковка qtcreator.7z
Рис. 10. Распаковка qtcreator.7z
Рис. 11. Каталог qtcreator в корне диска C:
Рис. 11. Каталог qtcreator в корне диска C:

Шаг 4. Файл запуска и ярлык — обязательный шаг

Qt Creator запускается не напрямую, а через .bat, который добавляет в PATH каталог MSYS2 с компилятором.

  1. В Блокноте создайте файл C:\qtcreator\qcreator.bat (тип файла — «Все файлы»):
set PATH=C:\msys64\ucrt64\bin;%PATH%
start "" "%~dp0\bin\qtcreator.exe"
  1. Сделайте ярлык этого файла на рабочем столе и запускайте Qt Creator только через него.
  2. Если MSYS2 установлен в другой каталог — исправьте первую строку.
Рис. 12. Сохранение qcreator.bat
Рис. 12. Сохранение qcreator.bat
Рис. 13. Ярлык для запуска Qt Creator
Рис. 13. Ярлык для запуска Qt Creator

Самая частая причина «компилятор не запускается»: если открыть bin\qtcreator.exe напрямую, PATH не задан, MinGW не находится и в комплекте появляется жёлтый треугольник.

Шаг 5. Первый запуск Qt Creator

При первом запуске будут подсказки:

  • Link with an Installed Qt → «Больше не показывать» (Qt framework мы не ставили);
  • Crash Reporting → «Больше не показывать»;
  • Take a UI Tour → «Знакомство» (кратко покажет элементы интерфейса среды).
Рис. 14. Первоначальная настройка Qt Creator
Рис. 14. Первоначальная настройка Qt Creator

Шаг 6. Проверка комплекта сборки

Откройте Параметры → Комплекты → Desktop и проверьте:

  • значок комплекта серый (жёлтый — чего-то не хватает, см. диагностику);
  • компилятор — MinGW;
  • отладчик — GDB;
  • путь к CMake заполнен.
Рис. 15. Раздел «Комплекты»
Рис. 15. Раздел «Комплекты»
Рис. 16. Пример рабочей конфигурации комплекта
Рис. 16. Пример рабочей конфигурации комплекта

Шаг 7. Первая программа

  1. Файл → New Project.
  2. «Проект без Qt» → в центре «Приложение на языке C» → Выбрать….
  3. Имя проекта — латиницей, папка — без кириллицы.
  4. Система сборки — CMake.
  5. Комплекты: Desktop, типы сборки — Debug и Release.
  6. Завершить, дождитесь импорта проекта.
  7. Запуск — кнопкой внизу слева (или Ctrl+R).
#include <stdio.h>

int main(void)
{
    printf("Hello, world!\n");
    return 0;
}
Рис. 17. Файл → New Project
Рис. 17. Файл → New Project
Рис. 18. «Проект без Qt» → «Приложение на языке C»
Рис. 18. «Проект без Qt» → «Приложение на языке C»
Рис. 19. Имя и расположение проекта
Рис. 19. Имя и расположение проекта
Рис. 20. Система сборки CMake
Рис. 20. Система сборки CMake
Рис. 21. Комплект Desktop, Debug и Release
Рис. 21. Комплект Desktop, Debug и Release
Рис. 22. Проект создан
Рис. 22. Проект создан
Рис. 23. Успешный запуск приложения
Рис. 23. Успешный запуск приложения

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

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

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

  1. Закройте Qt Creator и откройте его через ярлык qcreator.bat.
  2. Проверьте компилятор из командной строки:
set PATH=C:\msys64\ucrt64\bin;%PATH%
gcc.exe --version
where gcc
  1. Нет gcc.exe — вернитесь к шагу 2 и установите пакеты MSYS2.
  2. Пакеты есть — укажите пути вручную: Параметры → Комплекты → Desktop: C: C:\msys64\ucrt64\bin\gcc.exe, C++: g++.exe, Отладчик: gdb.exe, CMake: C:\msys64\ucrt64\bin\cmake.exe.

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

  1. Проверьте:
set PATH=C:\msys64\ucrt64\bin;%PATH%
where cmake
where ninja
  1. CMake — C:\msys64\ucrt64\bin\cmake.exe. Ninja в команде курса ставится из репозитория mingw64 (не ucrt), поэтому он может быть в C:\msys64\mingw64\bin\ninja.exe. Нет — установите: pacman -S mingw-w64-ucrt-x86_64-ninja.
  2. Укажите пути в Параметры → CMake, затем правой кнопкой по проекту → Run CMake.
  3. Проект — в локальной папке без кириллицы.

Случай C. Qt Creator не запускается или падает при старте

  1. Установлен ли Visual C++ Redistributable (vc_redist.x64.exe) — без него Qt Creator не стартует.
  2. Запускайте через ярлык/.bat, а не через bin\qtcreator.exe.
  3. Внутри C:\qtcreator должны быть каталоги bin, lib, share.

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

  1. Запускайте из Qt Creator и смотрите Application Output.
  2. При запуске exe вне среды появляется ошибка о DLL (libgcc_s_seh-1.dll, libwinpthread-1.dll) — запускайте через ярлык (там задан PATH), добавьте C:\msys64\ucrt64\bin в системный PATH или включите статическую линковку в CMakeLists.txt: set(CMAKE_EXE_LINKER_FLAGS "-static").
  3. Окно мгновенно закрывается — добавьте ожидание клавиши в конец main или включите Run in terminal (Проекты → Запуск).

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

  • Нет прав администратора: MSYS2, VC++ Redist и 7-Zip ставятся от администратора; если прав нет — сообщите преподавателю и временно используйте VS Code/Visual Studio 2022.
  • Антивирус блокирует gcc.exe/g++.exe: добавьте C:\msys64 и папку проекта в исключения.
  • Кириллица в пути или сетевой диск: перенесите проект в локальную папку с латинским путём.

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

  1. Help → About Qt Creator (версия);
  2. скриншот Параметры → Комплекты → Desktop;
  3. вывод where gcc и gcc.exe --version;
  4. текст Compile Output и General Messages после Ctrl+B;
  5. содержимое вашего qcreator.bat.

Горячие клавиши

КлавишиДействие
Ctrl+Bсобрать
Ctrl+Rсобрать и запустить
F5запуск под отладчиком
F9точка останова
F10 / F11шаг с обходом / с заходом

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

  • Кодировка UTF-8: Параметры → Text Editor → Behavior → File Encodings → UTF-8.
  • Отступы 4 пробела: Параметры → Text Editor → Behavior.
  • Тёмная тема: Параметры → Environment → Theme.
  • Запуск в терминале: Проекты → Запуск → Run in terminal — удобно для scanf.

Частые проблемы (сводная таблица)

СимптомПричина и решение
Жёлтый треугольник у комплектазапущен не через ярлык / нет пакетов MSYS2 — случай A
«No compiler found»не найден gcc.exe — укажите путь в комплекте, случай A
«CMake configuration failed»нет CMake/Ninja или путь с кириллицей — случай B
Qt Creator не стартуетне установлен VC++ Redist — случай C
exe не запускается вне средыPATH без C:\msys64\ucrt64\bin — случай D
Подсказка «Link with an Installed Qt»Qt framework не ставили — «Больше не показывать»
'printf' was not declaredзабыли #include <stdio.h>
Ничего не помогаетпришлите данные из «Что собрать для преподавателя»

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

MSYS2 даёт компилятор и CMake, Qt Creator ставится отдельным архивом, а запускается через qcreator.bat/ярлык, который добавляет C:\msys64\ucrt64\bin в PATH. Если сборка не идёт — проверьте запуск через ярлык и посмотрите Compile Output/General Messages.

Иллюстрации в этом гайде — скриншоты из инструкции курса.

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

—