# Qt プロジェクト

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/ja-jp/help/clion/llms.txt).

[Qt(英語)](https://www.qt.io/) は、GUI アプリケーションを作成するためのクロスプラットフォームの C++ フレームワークです。 Qt は独自のビルドシステム [qmake(英語)](https://wiki.qt.io/Qmake) を使用し、バージョン Qt4 以降の [CMake(英語)](https://doc.qt.io/qt-5/cmake-manual.html) でのビルドもサポートしています。

純粋な Qmake プロジェクトを CLion に直接インポートすることはできません。 ただし、CMake に変換すると、通常の [CMake アプリケーション](quick-cmake-tutorial.html)として開いて管理できます。 新規プロジェクトウィザードを使用して、CLion で [CMake ベースの Qt プロジェクトを作成する](#qt-template)を実行することもできます。

> **Tip:**
> Qt プロジェクトを開く別のオプションは、 [compilation database](compilation-database.html) を使用することです。 [scan-build(英語)](https://github.com/rizsotto/scan-build) を使用するか、Qt Creator の  `ビルド | Compilation Database を生成`  アクションを使用して、qmake プロジェクトの  `compile_commands.json`  を生成し、このファイルを CLion のプロジェクトとして開いて、 [カスタムビルドターゲットとカスタム実行 / デバッグ構成](custom-build-targets.html)を追加できます。

## CMake ベースの Qt プロジェクト

CMake バージョン 3.0 以降の場合、Qt には、CMake が Qt4 および Qt5 ライブラリを見つけて使用できるようにするモジュールが含まれています。 Qt プロジェクト用に [CMakeLists.txt](cmakelists-txt-file.html) を構成するには、次の手順を実行します。

Procedure: Qt プロジェクトの CMakeLists.txt

1. `find_package`  コマンドを追加して、必要なライブラリとヘッダーファイルを見つけます。 例：

```CMAKE
find_package(Qt5Widgets REQUIRED)
                
```

次に、  `target_link_libraries`  を使用して、ターゲットをこれらのライブラリとヘッダーに依存させます。

```CMAKE
target_link_libraries(helloworld Qt5::Widgets)
```

2. `find_package`  を正常に実行するには、Qt のインストール場所を CMake に指示する必要があります。

これを行う方法の 1 つは、  `CMAKE_PREFIX_PATH`  変数を設定することです。  `-D`  を [CMake 設定](#cmake-settings)ダイアログで渡すか、  `find_package`  の前に  `設定​タイトル​`  コマンドで渡すことができます。

例: Windows 上の MinGW の場合:

```CMAKE
set(CMAKE_PREFIX_PATH "C:\\Qt\\Qt5.14.0\\5.14.0\\mingw73_32\\")
```

または

```CMAKE
set(CMAKE_PREFIX_PATH "C:\\Qt\\Qt5.14.0\\5.14.0\\mingw73_32\\lib\\cmake\\")
```

3. プロジェクトで [MOC(英語)](https://doc.qt.io/archives/qt-4.8/moc.html)、 [UIC(英語)](https://doc.qt.io/archives/qt-4.8/uic.html)、 [RCC(英語)](https://doc.qt.io/qt-5/rcc.html) を使用する場合、次の行を追加して、対応するコンパイラーの自動呼び出しを有効にします。

```CMAKE
set(CMAKE_AUTOMOC ON)
set(CMAKE_AUTOUIC ON)
set(CMAKE_AUTORCC ON)

```

4. `add_executable()`  コマンドのすべての  `.ui`  および  `.qrc`  ファイルを、  `.cpp`  ソースとともにリストします。

```CMAKE
add_executable(
    helloworld
    main.cpp mainwindow.cpp
    application.qrc
)
                
```

以下に、単純な「Hello、world」アプリケーション用の完全な  `CMakeLists.txt`  スクリプトを示します。

```CMAKE
cmake_minimum_required(VERSION 3.10)
project(Qt-CMake-HelloWorld)

set(CMAKE_CXX_STANDARD 17)
set(CMAKE_INCLUDE_CURRENT_DIR ON)
set(CMAKE_PREFIX_PATH "C:\\Qt\\Qt5.14.0\\5.14.0\\mingw73_32\\")

find_package(Qt5Widgets REQUIRED)

set(CMAKE_AUTOMOC ON)
set(CMAKE_AUTOUIC ON)
set(CMAKE_AUTORCC ON)

add_executable(helloworld main.cpp mainwindow.cpp application.qrc)
target_link_libraries(helloworld Qt5::Widgets)
        
```

## CLion で Qt プロジェクトをセットアップする

Procedure: Windows のツールチェーン

1. Windows に Qt をインストールするときは、CLion、MinGW、MSVC で使用している環境に一致するディストリビューションを選択してください。

MinGW の場合、バージョンとビットネス（32 ビット MinGW または MinGW-w64）の両方がツールチェーンのセットアップと一致する必要があります。

![Qt インストーラー](https://resources.jetbrains.com/help/img/idea/2026.3/cl_qt_installer.png)

2. CLion で、  `設定`  （ `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) ）に移動し、  `ビルド、実行、デプロイ | ツールチェーン`  に移動して、Qt インストールに一致するツールチェーンを選択します。

複数の Qt インストールがある場合は、必ず  `CMAKE_PREFIX_PATH`  で [指定](#configure-cmakelists)したものと同じツールチェーンを選択してください。

例として、MinGW の場合:

![MinGW ツールチェーン](https://resources.jetbrains.com/help/img/idea/2026.3/cl_qt_mingw_toolchain.png)

> **Tip:**
> Windows ツールチェーンの詳細については、Windows チュートリアルの [MinGW](quick-tutorial-on-configuring-clion-on-windows.html#MinGW) または [MSVC](quick-tutorial-on-configuring-clion-on-windows.html#MSVC) セクションを参照してください。

Procedure: CMake 設定

* Qt プロジェクトは CLion では通常の CMake プロジェクトとして処理されるため、必要に応じて  `設定 | ビルド、実行、デプロイ | CMake`  で CMake 設定を構成できます。

例えば、異なる [ビルドタイプ](cmake-profile.html#buildtypes) の CMake プロファイルを作成し、好みの CMake [ジェネレーター](cmake-profile.html#cmake-generators)をセットアップできます。

このダイアログでは、  `CMakeLists.txt`  で設定する代わりに、  `CMAKE_PREFIX_PATH`  などの CMake オプションを指定することもできます。

![Qt プロジェクトの CMake オプション](https://resources.jetbrains.com/help/img/idea/2026.3/cl_qt_cmake_options.png)

Procedure: デバッガーレンダラー

CLion は、使用するプラットフォームとツールチェーンに応じて、Qt プロジェクト向けにさまざまな種類のデバッガーレンダラーを提供しています。

Windows MinGW、macOS、Linux では、IDE に Qt デバッガーレンダラー（Qt プリティプリンター、Qt デバッグヘルパーとも呼ばれる）が用意されています。 これらを使用すると、  `QString`  や  `QByteArray`  などの Qt 型を人間が読みやすい形式で表示できます。

[Windows と MSVC ツールチェーン](quick-tutorial-on-configuring-clion-on-windows.html#msvc-debugger)を使用している場合、IDE で Natvis レンダラーが提供され、Visual Studio のネイティブビジュアライザーフォーマットが利用されます。

CLion では、どちらのレンダラー型もデフォルトで有効になっています。  `設定 | ビルド、実行、デプロイ | デバッガー | データビュー | C/C++ | レンダラー`  では無効にすることができます。

> **Note:**
> Qt レンダラーはまだリモートおよび WSL ツールチェーンでは動作しません。

Procedure: Qt デザイナーで UI ファイルを開く

デフォルトで、CLion は  `.ui`  ファイルを [Qt Designer](https://doc.qt.io/qt-5/qtdesigner-manual.html) で開きます。

IDE は、  `設定 | 言語 & フレームワーク | QML`  で指定された  `Qt binaries`  フォルダーで Qt Designer へのパスを検索します。

Qt Designer を Qt とは別にインストールした場合、CLion ではそれを認識せず、エディターで  `.ui`  ファイルを開く場合があります。 この場合、次の手順を実行して Qt デザイナーで開きます。

1. `設定 | エディター | ファイルタイプ`  に進みます。

2. 認識されたファイルタイプ   リストから  Qt UI デザイナーフォーム を選択し、関連するファイル拡張機能：

![.ui ファイルの関連付けの削除](https://resources.jetbrains.com/help/img/idea/2026.3/cl_qt_ui_removeassoc.png) を削除します。

3. 関連アプリケーションで開かれたファイル を選択し、  `.ui`  拡張機能：

![.ui を外部アプリケーションに再割り当てする](https://resources.jetbrains.com/help/img/idea/2026.3/cl_qt_ui_externalapp.png) を追加します。

4. ワイルドカードを再割り当て   をクリックします。

5. 変更を適用   をクリックし、ダイアログを閉じます。

次回プロジェクトツリーで  `.ui`  ファイルをダブルクリックすると、そのファイルが Qt デザイナーで開かれます。

## CMake ベースの Qt プロジェクトの作成

CLion は、Qt 用に Qt ConsoleExecutable と QtWidgetsExecutable の 2 つのプロジェクトテンプレートを提供します。

`ファイル | 新規プロジェクト`  を呼び出し、左側のペインでプロジェクトタイプを選択します。 場所、言語標準、Qt バージョンを指定します。  `CMAKE_PREFIX_PATH`  で使用するパスを指定することもできます。 準備ができたら   作成   をクリックします。

![Qt プロジェクトテンプレート](https://resources.jetbrains.com/help/img/idea/2026.3/cl_qt_projectwizard.png)

CLion は、  `CMAKE_PREFIX_PATH`  変数を含む  `CMakeLists.txt`  が自動的に入力された、すぐに使用できるスタブプロジェクトを生成します。

![Qt コンソール実行可能テンプレートプロジェクト](https://resources.jetbrains.com/help/img/idea/2026.3/cl_qt_consoleexe_addprefixpath.png)

> **Tip:**
> Qt プロジェクトの  `CMakeLists.txt`  テンプレートは、  `設定 | エディター | ファイルおよびコードテンプレート`  の   その他   タブで編集できます。 詳細については、 [CMakeLists.txt ファイルテンプレート](cmakelists-txt-file.html#cmakelist-template)を参照してください。

## QtUI クラステンプレート

対応する  `.ui`  、  `.cpp`  、  `.h`  ファイルを使用して Qt クラスをすばやく作成できます。

Procedure:

1. プロジェクトビューで、コンテキストメニューから   新規   を選択するか、 `Alt+Insert` (Windows), `⌘ N` (macOS), `⌃ N` (IntelliJ IDEA Classic (macOS)), `⌘ N` (macOS System Shortcuts), `Alt+Insert` (XWin), `Alt+Insert` (GNOME), `Alt+Insert` (KDE), `Alt+Insert` (Emacs), `Ctrl+N` (Sublime Text), `⌘ N` (Sublime Text (macOS)), `⌘ N` (Xcode), `Ctrl+N` (Visual Studio), `⌘ N` (Visual Studio (macOS)), `Alt+Insert` (ReSharper), `⌥ Insert` (ReSharper (macOS)), `Alt+Insert` (QtCreator), `Alt+Insert` (QtCreator (macOS)), `Alt+Insert` (NetBeans), `Alt+Insert` (Eclipse), `⌘ N` (Eclipse (macOS)) を押します。   Qt UI クラス   を選択してください:

![新しい QtUI クラスメニューオプション](https://resources.jetbrains.com/help/img/idea/2026.3/cl_qt_new_uiclass.png)

2. 開いたダイアログで、クラス名を入力し、次の設定を構成します。

* ファイル名ベース - 生成する `.ui` / `.cpp` / `.h` ファイルの名前を指定します。

* 親クラス - `QWidget` 、 `QMainWindow` 、 `QDialog` 、またはカスタム親クラスを選択します。

* 名前空間 - 必要に応じて、囲んでいる名前空間を指定します。

* ターゲットに追加 - このチェックボックスを設定すると、選択したターゲットのソースのリストに新しいファイルが自動的に追加されます。

![新しい QtUI クラスダイアログ](https://resources.jetbrains.com/help/img/idea/2026.3/cl_qt_new_uiclass_dialog.png)

3. CLion は  `.ui` 、  `.cpp` 、  `.h`  ファイルを、  `設定 | エディター | ファイルおよびコードテンプレート`  で定義された [テンプレート](using-file-and-code-templates.html)に従って生成します：それぞれ Qt Designer フォーム、Qt クラス、および Qt クラスヘッダーです。 必要に応じて、これらのテンプレートを調整できます。

![新しい QtUI クラス用に生成されたファイル](https://resources.jetbrains.com/help/img/idea/2026.3/cl_qt_ui_generated.png)

## Qt 固有のコードインサイト

* CLion は [コード補完](auto-completing-code.html)を [Qt シグナルとスロット](https://doc.qt.io/qt-5/signalsandslots.html)向けに提供し、候補リストをフィルターして対応するメンバーのみを表示します： ![Qt シグナルの補完](https://resources.jetbrains.com/help/img/idea/2026.3/cl_qt_completion_signals.png) 補完は、 `SIGNAL()` および `SLOT()` マクロでも機能します。 ![SLOT マクロの補完](https://resources.jetbrains.com/help/img/idea/2026.3/cl_qt_completion_slots.png)

* CLion の自動インポートは Qt スタイルのヘッダーファイルをサポートしており、可能な限り最短の `#include` を提供します： ![Qt スタイルの自動インポート](https://resources.jetbrains.com/help/img/idea/2026.3/cl_qt_import.png)

## QtCreator キーマップ

CLion には [QtCreator キーマップ](https://doc.qt.io/qtcreator/creator-keyboard-shortcuts.html)が同梱されています。  `設定 | キーマップ`  で切り替えるか、メインメニュー（ `Ctrl+`` (Windows), `⌃ `` (macOS), `⌃ `` (IntelliJ IDEA Classic (macOS)), `⌃ `` (macOS System Shortcuts), `Ctrl+`` (XWin), `Ctrl+`` (GNOME), `Ctrl+`` (KDE), `Ctrl+`` (Emacs), `Ctrl+`` (Sublime Text), `⌃ `` (Sublime Text (macOS)), `⌃ `` (Xcode), `Ctrl+`` (Visual Studio), `Ctrl+`` (Visual Studio (macOS)), `Ctrl+`` (ReSharper), `Ctrl+`` (ReSharper (macOS)), `Ctrl+`` (QtCreator), `⌃ `` (QtCreator (macOS)), `Ctrl+`` (NetBeans), `Ctrl+`` (Eclipse), `⌃ `` (Eclipse (macOS)) ）から  `表示 | スキームのクイック切り替え`  を呼び出すことで切り替えることができます。

![Qt キーマップへの切り替え](https://resources.jetbrains.com/help/img/idea/2026.3/cl_qt_switch_keymap.png)

## 現在の制限

* CLion トラッカーの 2 つのチケット: [Qt プロジェクトのサポート (CPP-318)(英語)](https://youtrack.jetbrains.com/issue/CPP-318) および [Qt の問題 (CPP-1897)(英語)](https://youtrack.jetbrains.com/issue/CPP-1897)。

* CLion のコード生成機能の一部は、 `Q_PROPERTY` 、 `Q_SIGNAL` 、 `Q_SLOT` などの Qt マクロでは機能しない場合があります。

## トラブルシューティング

MinGW 上で実行時に  Process finished with exit code -1073741515 (0xC0000135)  というエラーメッセージが表示される場合、問題は [Windows 上の Qt デプロイ](https://doc.qt.io/qt-5/windows-deployment.html) に関連しているかもしれません。動的ライブラリと Qt プラグインは、実行するバイナリのディレクトリから検出される必要があります。 下記の回避策のいずれかを試してください。

Procedure: オプション 1

1. Qt インストールの   MinGW   ディレクトリ（たとえば、  `C:\Qt\5.15.1\mingw81_64\bin`  ）にある  `bin`  へのパスを、システム  `PATH`  または構成設定の   環境変数   フィールドに追加します。

これでプロジェクトの問題が解決しない場合は、   オプション 2   を試してください。

Procedure: オプション 2

1. Qt インストールの   MinGW   ディレクトリの  `bin`  にある  `.dll`  -s を、プロジェクトの生成フォルダー（デフォルトでは  `cmake-build-debug`  または  `cmake-build-release`  ）にコピーします。

必要になる可能性が最も高いライブラリは  `libstdc++-6.dll`  、  `Qt5Widgets.dll`  、  `Qt5Gui.dll`  、  `Qt5Core.dll`  ですが、セットアップには他のライブラリも必要になる場合があります。

2. 実行に使用する構成の設定で、  `QT_QPA_PLATFORM_PLUGIN_PATH`  環境変数を   MinGW   ディレクトリの  `plugins\platforms`  に設定します。

![Qt プラグインパスの環境変数](https://resources.jetbrains.com/help/img/idea/2026.3/cl_qt_envvar_plugins_config.png)

> **Tip:**
> 別のオプションは、  `plugins\platforms`  の内容を  `cmake-build-debug(release)/platforms`  にコピーすることです（  `platforms`  ディレクトリを必ず作成してください）。

詳細は、 [Qt プラグイン(英語)](https://doc.qt.io/qt-5/windows-deployment.html#qt-plugins)を参照してください。

## See also

### オンラインドキュメント

[クイック CMake チュートリアル](quick-cmake-tutorial.html) [Quick Tutorial on Configuring CLion on Windows](quick-tutorial-on-configuring-clion-on-windows.html)

