# クイック CMake チュートリアル

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

このチュートリアルでは、CLion で単純な CMake プロジェクトを作成して開発する手順を案内します。 段階的に、ビルドシステムとしての [CMake(英語)](https://cmake.org/) の基本と、CMake 固有の IDE 設定とアクションを学習します。

> **Note:**
> 以下に示すサンプルプロジェクトのソースコードは、 [GitHub(英語)](https://github.com/JetBrains/CMake-Tutorial-sample) で入手できます。

> **Note:**
> 3.15 より前の CMake バージョンはサポートされていません。 同梱の CMake からカスタムインストールに切り替える場合は、バージョンが 3.15 以上であることを確認してください。

## 1。 シンプルな CMake プロジェクト

[CMake(英語)](https://cmake.org/) は、   CMakeLists   と呼ばれるスクリプトを使用して、特定の環境用のビルドファイル (Unix マシンのメイクファイルなど) を生成するメタビルドシステムです。

CLion で新しい CMake プロジェクトを作成すると、プロジェクトルートに  `CMakeLists.txt`  ファイルが自動的に生成されます。

Procedure: サンプル CMake プロジェクトを開始する

1. メインメニューから  `ファイル | 新規プロジェクト`  を選択します。

2. 左側のペインで   C++ 実行ファイル   を選択します。

この例では、プロジェクト名は  cmake_testapp  で、選択された言語標準は  C++17  です。

![新しい CMake プロジェクトの作成](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmaketutorial_create_prj.png)

作成   をクリックします。

3. CLion は、単一のソースファイル  `main.cpp`  と [CMakeLists.txt](cmakelists-txt-file.html) スクリプトを含むスタブプロジェクトをルートに生成します。

![スタブ CMake プロジェクトの CMakeLists.txt](https://resources.jetbrains.com/help/img/idea/2026.3/cl_simple_cmakeprj.png)

自動生成された  `CMakeLists.txt`  には次のコマンドが含まれています。

|  コマンド  |  説明  |
| --- | --- |
|   `cmake_minimum_required(VERSION 3.26)`   |  デフォルトの [ツールチェーン](how-to-create-toolchain-in-clion.html)で設定されているように、最低限必要な CMake のバージョンを [指定](https://cmake.org/cmake/help/latest/command/cmake_minimum_required.html)します。 ほとんどの場合、CMake 実行可能ファイルが意図的に変更されていなければ、これがバンドルされた CMake バージョンです。  |
|   `project(cmake_testapp)`   |  プロジェクト作成時に指定した内容に従ってプロジェクト名を定義します。  |
|   `set(CMAKE_CXX_STANDARD 17)`   |     プロジェクトの作成時に選択したように、  CMAKE_CXX_STANDARD  変数を  17  の値に [設定(英語)](https://cmake.org/cmake/help/latest/command/set.html)します。     |
|   `add_executable(cmake_testapp main.cpp)`   |   `main.cpp`  からビルドされる  cmake_testapp  実行可能ターゲットを [追加(英語)](https://cmake.org/cmake/help/latest/command/add_executable.html)します。 ターゲットについては [後述](#targets-configs)します。  |

4. IDE の左側のツールバーにある ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.icons.expui.CMakeToolWindow.svg) をクリックして   CMake   ツールウィンドウを開き、プロジェクトのロードの進捗とステータスを確認できます：

![CMake ツールウィンドウ](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmaketutorial_toolwindow.png)

> **Tip:**
> 読み込みに失敗した場合、CMake ツールウィンドウが自動的に開きます。

## 2。 CMake ターゲットと CLion 構成

[ターゲット(英語)](https://cmake.org/cmake/help/latest/manual/cmake-buildsystem.7.html#binary-targets)は、CMake スクリプトを使用して構築される実行可能ファイルまたはライブラリです。 1 つのスクリプトで複数のビルドターゲットを定義できます。

今のところ、テストプロジェクトには  `cmake_testapp`  という 1 つのビルドターゲットしかありません。 最初のプロジェクトのロード時に、CLion はこのターゲットに関連付けられた実行/デバッグ構成を自動的に追加します：

![新しい CMake プロジェクトのデフォルト構成](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmake_defaultconf1.png)

スイッチャーで   実行構成の編集   をクリックして詳細を表示します。 ターゲット名と実行可能ファイル名は、  `CMakeLists.txt`  で指定したものと同じです。

![新しい CMake プロジェクトのデフォルト構成の詳細](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmake_defaultconf2.png)

このダイアログの   起動前   領域に注目してください。   ビルド   は、デフォルトで起動前のステップとして設定されます。 この構成を使用してターゲットをデバッグまたは実行するだけでなく、ビルドを実行することもできます。 CLion で利用できるさまざまなビルドアクションの詳細については、 [ビルドアクション](build-actions.html)を確認してください。

## 3。 既存のターゲットへのファイルの追加

新しいソースファイル  `general.cpp`  を作成し、それを  `cmake_testapp`  ターゲットに追加しましょう。

Procedure:

1. プロジェクトツリーでルートフォルダーを右クリックし、   新規 | C/C++ ソースファイル   を選択します：

![ソースファイルの追加](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmaketutorial_addsourcefile.png)

2. ターゲットに追加   チェックボックスを設定します。

![既存のターゲットへのファイルの追加](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmake_tutorial_addfiletotarget.png)

3. OK   をクリックすると、新しいファイルが  `add_executable`  コマンドに追加されます。

![add_executable に追加されたソースファイル](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmake_tutorial_newfile_incmake.png)

> **Tip:**
> この方法でファイルをターゲットに追加すると、  `CMakeLists.txt`  スクリプトを手動で編集せずに、CLion がバックグラウンドでプロジェクトを自動的に再ロードします。

## 4。 新しいターゲットの追加

次に、さらに 2 つのファイルを追加し、それらの実行可能ファイルとライブラリターゲットを作成しましょう。

Procedure: 新しい実行可能ターゲット

1. プロジェクトツリーでルートフォルダーを右クリックし、   新規 | C/C++ ソースファイル   を再度選択します。

2. ファイル名を設定します (この例では  `calc`  )。

3. ターゲットに追加   フィールドで、   cmake_testapp   チェックボックスをオフにします。

4. 新しいターゲットの追加   リンクをクリックします。

![新しいターゲットへのファイルの追加](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmake_newfile_addtotargets.png)

5. ターゲット名（  `cmake_testapp_calc` ）を指定し、   追加   をクリックします：

![新しい実行可能ターゲットの追加](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmaketutorial_newexetarget.png)

6. 新しく作成したターゲットがリストに表示されます。

`cmake_testapp_calc`  ターゲットのみが選択されていることを確認します。

![新しいターゲットがターゲットのリストに追加されました](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmaketutorial_newtarget_added.png)

OK   をクリックします。

7. CLion は新しい  `add_executable`  コマンドを  `CMakeLists.txt`  に追加し、プロジェクトを再ロードします：

![CMakeLists.txt の新しいターゲット](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmaketutorial_newexetarget_incmakelists.png)

8. 再ロード後、新しい構成が構成スイッチャーに表示されます：

![新しく追加されたターゲットの構成](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmake_addtarget_conf.png)

> **Note:**
> これは、新しい実行可能ターゲットを追加する方法を示した例です。 この構成を実行する場合は、  `calc.cpp`  に  `int main()`  関数を追加する必要があることに注意してください。

Procedure: 新しいライブラリターゲット

1. プロジェクトツリーでルートフォルダーを右クリックし、   新規 | C/C++ ソースファイル   を再度選択します。

2. ファイル名 (  `calc_lib`  ) を指定します。

3. ターゲットに追加   フィールドのチェックボックスをオフにします。

4. 新しいターゲットの追加   をクリックします。

![新しいターゲットの追加](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmaketutorial_addlib_clicknewtargets.png)

5. ドロップダウンリストで、  `add_library`  を選択します。

![新しいライブラリターゲット](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmaketutorial_newlibtarget.png)

> **Tip:**
> このドロップダウンには、 [CUDA](cuda-projects.html) および [Qt](qt-tutorial.html) ターゲットを追加するためのコマンドがあります。

6. ターゲット名（  `cmake_testapp_lib` ）を設定し、   追加   をクリックします。

![ライブラリターゲットの追加](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmaketutorial_addlib_clicknewtargets.png)

7. 新しく作成したターゲットがリストに表示されます。

他のターゲットのチェックボックスがオフになっていることを確認してください。

![新しいライブラリターゲットが追加されました](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmaketutorial_newlibtarget_added.png)

関連するヘッダーを作成する   チェックボックスを設定して、ヘッダーファイル  `calc_lib.h`  も追加します。

OK   をクリックします。

8. CLion は  `add_library`  コマンドを  `CMakeLists.txt`  に追加し、プロジェクトを再ロードします：

![CMakeLists.txt の新しいライブラリターゲット](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmaketutorial_newlibtarget_addedtocmakelists.png)

9. 実行可能ファイルターゲットの場合と同様に、CLion はライブラリターゲットの構成も自動的に作成します：

![新しく追加されたライブラリターゲットの構成](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmake_addlibrary_conf.png)

ただし、これは実行不可能な構成であるため、実行またはデバッグしようとすると、「 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.balloonError.svg)  実行可能ファイルが指定されていません」という エラーメッセージが表示されます。

![実行ファイル未指定エラー](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmaketutorial_libtarget_exenotspecified.png)

10. ライブラリファイルを取得するには、この構成をビルドする必要があります。 スイッチャーでそれを選択し、 `Ctrl+F9` (Windows), `⌘ F9` (macOS), `⌘ F9` (IntelliJ IDEA Classic (macOS)), `⌘ ⌃ B` (macOS System Shortcuts), `Ctrl+F9` (XWin), `Ctrl+F9` (GNOME), `Ctrl+9` (KDE), `Ctrl+F9` (Emacs), `Ctrl+F9` (Sublime Text), `Ctrl+F9` (Sublime Text (macOS)), `⌘ B` (Xcode), `F7` (Visual Studio), `F7` (Visual Studio (macOS)), `F7` (ReSharper), `F7` (ReSharper (macOS)), `Ctrl+F9` (QtCreator), `⌘ F9` (QtCreator (macOS)), `F11` (NetBeans), `Ctrl+F9` (Eclipse), `⌘ B` (Eclipse (macOS)) を押すか、ビルドアイコンをクリックします。

![ライブラリターゲットのビルド](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmaketutorial_build_lib.png)

その結果、  `libcmake_testapp_lib.a`  ファイルが  `cmake-build-debug`  フォルダーに表示されます。

![ライブラリアーティファクト](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmaketutorial_libfile.png)

## 5. プロジェクトを再ロードする

`CMakeLists.txt`  にいくつかの変更を手動で導入してみましょう。 例: ライブラリターゲットの宣言に  `STATIC`  を追加します。

![CMakeLists.txt を手動で変更する](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmaketutorial_cmakelists_manualchanges.png)

`CMakeLists.txt`  に変更を加えると、CLion がプロジェクトの再ロードを提案するアイコンを表示します。 それをクリックするか、ショートカットを押します。

![CMake 再ロードアイコン](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmaketutorial_reload_icon.png)

> **Tip:**
> `CMakeLists.txt`  が変更されるたびに CLion がサイレントにプロジェクトを再ロードすることを希望する場合は、  `設定 | ビルド、実行、デプロイ | CMake`  に移動し自動再ロードを有効化してください：
>
> ![CMake 設定で自動再ロードを有効にする](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmake_autoreloadsetting.png)

## 6。 CMake プリセットと CLion CMake プロファイル

プロジェクトの CMake オプションを構成して共有するには、CMake プリセット、CLion の CMake プロファイル、またはその両方を使用できます。

[CMake プロファイル](cmake-profile.html)は [CMake プリセット](cmake-presets.html)と多くの設定を共有しており、VCS 経由での共有も可能です。 主な違いは、プロファイルが CLion の [ツールチェーン](how-to-create-toolchain-in-clion.html)を参照する点です。これには、CMake プリセットに存在せず必要のない情報（デバッガーや環境設定など）が含まれています。

Procedure: CMake プリセット

[CMake プリセット(英語)](https://cmake.org/cmake/help/latest/manual/cmake-presets.7.html)は、次の 2 つのファイルを使用して CMake オプションを構成および共有する方法です。

* プロジェクトごとのビルド用の `CMakePresets.json` 。 このファイルは VCS 経由で共有できます。

* 開発者自身のローカルビルド用の `CMakeUserPresets.json` 。 このファイルは VCS にチェックインしないでください。

これらのファイルはどちらも同じ形式で、プロジェクトのルートディレクトリに配置する必要があります。

> **Note:**
> CLion でプリセットを使う方法の詳細はこちら： [CMake プリセット](cmake-presets.html)

Procedure: CMake プロファイル

プロファイルには、 [ツールチェーン](how-to-create-toolchain-in-clion.html)と [ビルド型](cmake-profile.html#buildtypes)、および [ジェネレーター](cmake-profile.html#cmake-generators)や [環境変数](cmake-profile.html#EnvVariables)などの CMake オプションが含まれます。 たとえば、異なるコンパイラーを使用したり、異なる設定でターゲットをビルドしたりするために、プロジェクトに複数のプロファイルを構成できます。

リリースビルド用のプロファイルを追加する例については、次の章を参照してください。

## 7。 ビルドタイプ

これまで作成したすべての実行/デバッグ構成は  Debug 構成であり、これは自動的に構成された [CMake プロファイル](cmake-profile.html)のデフォルトビルド型です。

例:  デバッグビルド と  リリース ビルドを分離しましょう。 このために、新しい CMake プロファイルを  `設定 | ビルド、実行、デプロイ | CMake`  に追加 ( ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.inlineAddHover.svg)) し、そのビルドタイプを   リリース   に設定します。

![リリース CMake プロファイルの追加](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmake_addprofile.png)

ビルド結果の場所を指定する   ビルドディレクトリ   フィールドに注意してください。 デフォルトのフォルダーは、  デバッグ プロファイルの場合は  `cmake-build-debug`  、  リリース プロファイルの場合は  `cmake-build-release`  です。 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.menu-open.svg) は、他の任意の場所にいつでも設定できます。

プロファイルを保存すると、スイッチャーに表示されます。

![構成スイッチャーの CMake プロファイル](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmake_profiles_configs.png)

> **Tip:**
> 構成または CMake プロファイルを切り替えると、コードの解決に使用されるプリプロセッサー定義に影響を与える可能性があります。 詳細については、 [「コンテキストの解決」](switching-resolve-context.html)を参照してください。

## 8。 インクルードディレクトリの追加

別のディレクトリにある追加のヘッダーを使用するには、すべてのターゲットまたは一部の特定のターゲットに追加する必要があります。

Procedure:

1. 例として、プロジェクトルートの下に  `includes` 、  `includes/general` 、  `includes/math`  の３つのディレクトリを作成します。 プロジェクトツリーのコンテキストメニューで  `新規 | ディレクトリ`  オプションを使用します。

![新しいインクルードディレクトリ](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmaketutorial_includedirs.png)

2. `CMakeLists.txt`  を開き、次のコマンドを追加します。

```CMAKE
target_include_directories (cmake_testapp_lib PUBLIC includes/math)
target_include_directories (cmake_testapp_lib PUBLIC includes/general)

```

これら 2 つのコマンドにより、  `general`  および  `math`  にあるヘッダーを  `cmake_testapp_lib`  ターゲットのソースから利用できるようになります。

例:  `header_math.h`  というヘッダーを  `includes/math`  フォルダー内に配置すると、  `#include "header_math.h"`  を使用して  `calc_lib.cpp`  からヘッダーをインクルードできます。

## 9。 リンクライブラリ

### 静的ライブラリ

[ステップ 4](#new-lib-target) では、  `cmake_testapp_lib`  という静的ライブラリを作成しました (デフォルトのファイル名は  `libcmake_testapp_lib.a`  です)。

次に、このライブラリをプロジェクトにリンクする方法を見てみましょう。 便宜上、別のフォルダーを作成して使用します。

Procedure:

1. プロジェクトルートに  `lib`  ディレクトリを作成します。

2. `libcmake_testapp_lib.a`  をデフォルトの場所である  `cmake-build-debug`  から  `lib`  フォルダーにコピーします。

![lib フォルダー内のライブラリアーティファクト](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmaketutorial_libartifact_inlibfolder.png)

3. 次のコマンドを追加して、このライブラリを  cmake_testapp  ターゲットにリンクします。

```CMAKE
find_library(TEST_LIBRARY cmake_testapp_lib lib)
target_link_libraries(cmake_testapp LINK_PUBLIC ${TEST_LIBRARY})

```

* [find_library(英語)](https://cmake.org/cmake/help/latest/command/find_library.html) は、ライブラリへのフルパスを提供します。

* 次に、 `${TEST_LIBRARY}` 変数を介して [target_link_libraries(英語)](https://cmake.org/cmake/help/latest/command/target_link_libraries.html) コマンドに直接渡します。

![静的ライブラリのリンク](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmake_link_staticlib.png)

> **Note:**
> メモ   : ライブラリをリンクする前に CMake が実際にターゲットをビルドするように、  `add_executable`  コマンドの後に  `target_link_libraries`  を配置してください。

### 動的ライブラリ

共有 (動的) ライブラリのケースを説明するために、Portable Network Graphics (PNG) ファイルの読み取りおよび書き込み用の C ライブラリである [LibPNG(英語)](https://libspng.org) を使用する例を取り上げます。

Procedure: vcpkg を使用してライブラリパッケージをインストールする

CLion は、C/C++ のパッケージマネージャーである [vcpkg](package-management.html) と統合されます。 これを使用して、IDE から直接ライブラリをすばやくインストールします。

1. [この手順](package-management.html#install-vcpkg)に従って vcpkg をインストールします。

2. vcpkg ツールウィンドウで   libpng   を検索します：

![vcpkg で libpng を検索する](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmaketutorial_libpng_searchvcpkg.png)

3. 右側のペインで   インストール   をクリックし、インストールが完了するまで待ちます。

Procedure: ライブラリを CMakeLists.txt に追加する

1. `CMakeLists.txt`  ファイルを開き、次のコマンドを追加します。

```CMAKE
find_package(PNG REQUIRED)
include_directories(${PNG_INCLUDE_DIR})
target_link_libraries(cmake_testapp PRIVATE ${PNG_LIBRARY})

```

2. ライブラリが正しくリンクされているかどうかを確認するには、ライブラリヘッダーの 1 つを  `main.cpp`  に含めてみます。

![LibPNG ヘッダーをインクルードする](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmaketutorial_libpng_includeheader.png)

例:  `png.h`  を含めます。 次に、 `Ctrl+B` (Windows), `⌘ B` (macOS), `⌘ B` (IntelliJ IDEA Classic (macOS)), `⌘ B` (macOS System Shortcuts), `Ctrl+B` (XWin), `Ctrl+B` (GNOME), `Ctrl+B` (KDE), `Ctrl+Alt+G` (Emacs), `F12` (Sublime Text), `F12` (Sublime Text (macOS)), `⌘ Click` (Xcode), `F12` (Visual Studio), `F12` (Visual Studio (macOS)), `Ctrl+B` (ReSharper), `⌘ B` (ReSharper (macOS)), `F2` (QtCreator), `F2` (QtCreator (macOS)), `Ctrl+B` (NetBeans), `F3` (Eclipse), `F3` (Eclipse (macOS)) を押してこのファイルを開くことができます。

![png.h ファイルに移動する](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmaketutorial_libpng_gotoheader.png)

## 10。 CMake デバッグ

CMake の構成中にエラーや望ましくない動作が発生した場合は、プロジェクト内の他のコードと同様に CMake スクリプトをデバッグできます。

> **Note:**
> デバッガーは実際のプロジェクトビルドをデバッグせず、デバッグ中の CMake 実行後にプロジェクトモデルは [再ロード](reloading-project.html)されません。

Procedure:

1. 1 つまたは複数の  `CMakeLists.txt`  ファイルにブレークポイントを配置します。

2. 最上位の  `CMakeLists.txt`  を開き、最初のコマンドの横にあるガターアイコンをクリックして、   デバッグ   を選択します。

![ガターから CMake デバッグセッションを開始する](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmake_boost_debug_gutter.png)

> **Tip:**
> CMake の生成が失敗した場合は、CMake ツールウィンドウの   デバッグ   ヒントをクリックしてデバッグを開始できます。
>
>
>
> ![CMake ツールウィンドウのデバッグヒント](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmake_debug_tw_hint.png)

3. CLion は CMake デバッグセッションを開始します：

![CMake デバッグセッション](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmake_boost_debug_session.png)

詳細については、 [CMake デバッグ機能](cmake-debug.html#cmake-debug-features)を参照してください。

## 11。 CMakeLists.txt の編集に関するヒント

CLion は、CMake スクリプトを効果的に扱うのに役立つコードインサイト機能を提供します。 例：

* CMake の [構造](file-structure.html)ビューには、スクリプトで使用された変数、関数、マクロ、ターゲットが表示されます。 それを開くには、 `Alt+7` (Windows), `⌘ 7` (macOS), `⌘ 7` (IntelliJ IDEA Classic (macOS)), `⌘ 7` (macOS System Shortcuts), `Alt+7` (XWin), `Alt+7` (GNOME), `Alt+7` (KDE), `Alt+7` (Emacs), `Alt+7` (Sublime Text), `⌘ 7` (Sublime Text (macOS)), `⌘ 3` (Xcode), `Ctrl+Alt+F` (Visual Studio), `⌃ ⌥ F` (Visual Studio (macOS)), `Ctrl+F11` (ReSharper), `⌃ F11` (ReSharper (macOS)), `Alt+7` (QtCreator), `⌘ 7` (QtCreator (macOS)), `Ctrl+7` (NetBeans), `Alt+7` (Eclipse), `⌘ 7` (Eclipse (macOS)) (ツールウィンドウの場合) または `Ctrl+F12` (Windows), `⌘ F12` (macOS), `⌘ F12` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ 7` (macOS System Shortcuts), `Ctrl+F12` (XWin), `Ctrl+F12` (GNOME), `Ctrl+0` (KDE), `Ctrl+F12` (Emacs), `Ctrl+R` (Sublime Text), `⌘ R` (Sublime Text (macOS)), `⌃ 6` (Xcode), `Alt+\` (Visual Studio), `⌥ \` (Visual Studio (macOS)), `Ctrl+F12` (ReSharper), `⌘ F12` (ReSharper (macOS)), `Ctrl+F12` (QtCreator), `⌘ F12` (QtCreator (macOS)), `Ctrl+F12` (NetBeans), `Ctrl+F3` (Eclipse), `⌘ O` (Eclipse (macOS)) (ポップアップの場合) を押します。 ![CMake スクリプトの構造](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmake_tutorial_structure.png)

* コード補完は、 `find_package()` などのコマンドの引数を含む、 `CMakeLists.txt` のほとんどの要素に対して機能します。 ![find_package の補完](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmake_tutorial_boost_find_completion.png)

* [クイックドキュメントポップアップ](viewing-inline-documentation.html)は、コード要素に関する詳細情報を取得できます。 呼び出すには、マウスホバーを使用するか、 `Ctrl+Q` (Windows), `F1` (macOS), `⌃ J` (IntelliJ IDEA Classic (macOS)), `⌘ I` (macOS System Shortcuts), `Ctrl+Q` (XWin), `Ctrl+Q` (GNOME), `Ctrl+Q` (KDE), `Ctrl+Q` (Emacs), `Ctrl+Q` (Sublime Text), `Ctrl+Q` (Sublime Text (macOS)), `⌘ ⌃ ⇧ /` (Xcode), `Ctrl+K, I` (Visual Studio), `⌘ K, I` (Visual Studio (macOS)), `Ctrl+Q` (ReSharper), `⌃ Q` (ReSharper (macOS)), `Ctrl+Q` (QtCreator), `Ctrl+Q` (QtCreator (macOS)), `Ctrl+Q` (NetBeans), `Alt+Middle-Click` (Eclipse), `⌥ Middle-Click` (Eclipse (macOS)) を押します。 補完の提案についても簡単なドキュメントを表示できます。 ![補完候補のクイックドキュメント](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmake_tutorial_boost_completion_quickdoc.png)

* `設定 | エディター | カラースキームの切り替え | CMake` で CMake ファイルの色とフォントスキームを調整できます。 ![CMake の配色設定](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmake_codestyle_settings.png) > **Tip:** > 便利な機能のヒントについては、 [CMake でのコードインサイト](cmakelists-txt-file.html#code-insight-cmake)を参照してください。

## 12。 CTest の使用

この章では、CMake ビルドプロセスの一部としてテストをコンパイルおよび実行するためのフレームワークである [CTest(英語)](https://cmake.org/cmake/help/latest/manual/ctest.1.html) の使用方法について簡単な例を示します。 フレームワークの一般的な説明は、 [CTest のサポート](ctest-support.html)にあります。

Procedure: サンプルプロジェクトに CTest を追加する

1. プロジェクトルートに  `ctest`  ディレクトリを作成します。

2. 次のファイルを  `ctest`  ディレクトリに追加します。

* ソースファイル `addvalues_zero.cpp` 。 現時点では、このファイルを CMake ターゲットにリンクしないでください。

* ヘッダーファイル `assert_macro.h` 。 現時点では、このファイルを CMake ターゲットにリンクしないでください。

* `CMakeLists.txt` スクリプト。

![CTest 用のフォルダーの追加](https://resources.jetbrains.com/help/img/idea/2026.3/CMakeLists.txt`  に次の行を追加します。

```
cmake_minimum_required(VERSION 3.14.0 FATAL_ERROR)

add_executable(ctest_exe_addvalues_zero addvalues_zero.cpp)

target_link_libraries(ctest_exe_addvalues_zero LINK_PUBLIC cmake_testapp_lib)

add_test(NAME ctest_addvalues_zero COMMAND ctest_exe_addvalues_zero)

set_tests_properties(ctest_addvalues_zero PROPERTIES PASS 0)

```

最初の行は、CMake のバージョン 3.14 に対応する CTest のサポートされている最小バージョンを示しています。

ここでは [add_test(英語)](https://cmake.org/cmake/help/latest/command/add_test.html) コマンドを使用して、  `ctest_exe_addvalues_zero`  実行可能ファイルを CTest に登録しています。

4. 次に、CTest を有効にして、トップレベルの  `CMakeLists.txt`  でサブプロジェクトを宣言する必要があります。

```CMAKE
enable_testing()
add_subdirectory(ctest)

```

[enable_testing(英語)](https://cmake.org/cmake/help/latest/command/enable_testing.html) コマンドは、CTest を実行する組み込みのターゲット  `test`  を作成します。

5. プロジェクトを再読み込みしてください。

Procedure: テストするコードを追加する

CTest でテストするコードを準備しましょう。

1. `calc_lib.cpp`  に簡単な関数を追加します

```CPLUSPLUS
int add_values (int a, int b) { return a+b;}

```

2. 関連付けられたヘッダー  `calc_lib.h`  に、関数宣言を追加します。

```CPLUSPLUS
int add_values (int a, int b);
```

![テストする関数の追加](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmaketutorial_testfunc_upd.png)

Procedure: テストソース内にコードを追加する

1. `assert_macro.h` ：

```CPLUSPLUS
#include <iostream>
#include <sstream>


#define assertEqual( ... )               \
do {                                            \
if( !( __VA_ARGS__ ) ) {                     \
std::cerr << "Unit test assert [ " \
<< ( #__VA_ARGS__ )             \
<< " ] failed in line [ "       \
<< __LINE__                     \
<< " ] file [ "                 \
<< __FILE__ << " ]"             \
<< std::endl;                     \
err_code = 1;                           \
}                                            \
} while( false )

```

2. `addvalues_zero.cpp` ：

```CPLUSPLUS
#include "assert_macro.h"
#include "../calc_lib.h"

int test_addvalues_zero() {
int err_code = 0;
assertEqual (add_values(0, 0) == 0);
assertEqual (add_values(-5, 5) == 0);
return err_code;
}

int main() {
return test_addvalues_zero();
}

```

Procedure: CTest 構成を編集する

1. メインメニューで  `実行 | 実行構成の編集​`  へ移動します。

2. CTest アプリケーション   ノードに、自動的に作成された   すべての CTest   構成があります。

テスト対象のコードは  `ctest_exe_addvalues_zero`  実行可能ファイルにあるため、構成設定でその実行可能ファイルをビルドターゲットとして選択する必要があります。

![CTest 構成 - ターゲットの変更](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmaketutorial_ctest_config_targets_to_build_upd.png)

> **Tip:**
> これをプロジェクト内のすべての CTest 構成に適用するには、同じダイアログの左下隅にある   構成テンプレートの編集 ...   をクリックし、   CTest アプリケーション   を選択してテンプレートのターゲットを変更します：
>
> ![CTest 構成テンプレートの編集](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmaketutorial_ctest_configtemplate_upd.png)

3. 実行するテストリスト   フィールドも確認してみましょう。 ペンアイコンをクリックして   利用可能なテストのリスト   ダイアログを開くと、一連のテストを表示および調整できます：

![CTest 構成で使用可能なテストのリスト](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmaketutorial_ctest_allconfig.png)

> **Tip:**
> CTest アプリケーション   テンプレートの詳細については、「 [CTest 実行/デバッグ構成](ctest-support.html#ctest-configs)」を参照してください。

Procedure: CTest 構成を実行して結果を調べる

1. 構成スイッチャーで   すべての CTest   を選択し、 ![実行ボタン](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.execute.svg) をクリックするか、 `Shift+F10` (Windows), `⌃ R` (macOS), `⇧ F10` (IntelliJ IDEA Classic (macOS)), `⌥ ⇧ R` (macOS System Shortcuts), `Shift+F10` (XWin), `Shift+F10` (GNOME), `Shift+F10` (KDE), `Shift+F10` (Emacs), `Shift+F10` (Sublime Text), `Shift+F10` (Sublime Text (macOS)), `⌘ ⌥ ⇧ R` (Xcode), `Ctrl+F5` (Visual Studio), `⌃ F5` (Visual Studio (macOS)), `Ctrl+F5` (ReSharper), `⌃ F5` (ReSharper (macOS)), `Ctrl+R` (QtCreator), `⌘ R` (QtCreator (macOS)), `F6` (NetBeans), `Alt+Shift+X` (Eclipse), `⌘ ⇧ F11` (Eclipse (macOS)) を押します。

![CTest 構成の実行](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmaketutorial_ctestrun.png)

2. [Test Runner](viewing-and-exploring-test-results.html) ウィンドウで結果を確認します：

![C テストの結果](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmaketutorial_ctest_results.png)

## 13。 お役立ちリンク

CLion で CMake をさらに深く掘り下げるには、以下を学んでください：

* [プロジェクトルートの変更](change-project-root-directory.html)

* [CMake キャッシュをリセットする](cmake-cache.html)

* [コンパイラーフラグを指定する](cmake-profile.html#compiler-flags)

* [コンパイラーの切り替え](how-to-switch-compilers-in-clion.html)

* [Build actions](build-actions.html)と [CMake install](using-cmake-install.html)を実行する

* [環境変数](cmake-profile.html#EnvVariables)と [CLION_IDE](detecting-origin-of-cmake-invocation.html) マクロを使用します。

* 実行 [CMake プロファイリング](cmake-profiling.html)

* [CMake をデバッグする](cmake-debug.html)

* [CMake install](using-cmake-install.html)を使用

## See also

### ハウツー

[CTest support](ctest-support.html)

