# CMakeLists.txt

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

`CMakeLists.txt`  ファイルには、プロジェクトのソースファイルとターゲット（実行可能ファイル、ライブラリ、その両方）を記述する指示文と命令のセットが含まれています。

[新しいプロジェクトを作成する](creating-new-project-from-scratch.html)と、CLion は自動的に  `CMakeLists.txt`  ファイルを生成してプロジェクトのルートディレクトリに配置します。 プロジェクトを [開く](creating-new-project-from-scratch.html#open-prj)には、CLion を最上位の  `CMakeLists.txt`  にポイントして   プロジェクトとして開く​   を選択します。

以下の例は、単純な「Hello, World」プロジェクトの  `CMakeLists.txt`  ファイルを示しています。

```CMAKE
cmake_minimum_required(VERSION 3.20)  # CMake version check
project(simple_example)               # Create project "simple_example"
set(CMAKE_CXX_STANDARD 14)            # Enable c++14 standard

# Add main.cpp file of the project root directory as a source file
set(SOURCE_FILES main.cpp)

# Add executable target with source files listed in SOURCE_FILES variable
add_executable(simple_example ${SOURCE_FILES})

```

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

`CMakeLists.txt`  ファイルはエディターで直接編集できます。 編集後は必ずプロジェクトを [再ロードして](reloading-project.html)ください。 自動再ロード機能はデフォルトでは無効になっていますが、  `設定 | ビルド、実行、デプロイ | CMake`  の   編集時に CMake プロジェクトを自動的に再ロードする   チェックボックスを設定することで有効にできます。

## サブディレクトリ CMakeLists.txt ファイル

複雑な構造のプロジェクトの場合は、サブディレクトリ  `CMakeList.txt`  ファイルを作成して、サブプロジェクトのビルド、コンテンツ、ターゲットルールを記述することができます。

サブディレクトリ  `CMakeLists.txt`  によって追加されるターゲットのタイプは、モジュールのロールに応じて異なります。

![サブディレクトリ内の CMakeLists.txt ファイル](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmakeListsFiles.png)

## CMakeLists.txt ファイルテンプレート

When you create a CMake or CMake-based ( [CUDA](cuda-projects.html), [Qt](qt-tutorial.html)) project via the New Project wizard, CLion uses different templates to generate  `CMakeLists.txt`  depending on the project type and settings. これらのテンプレートは、  `設定 | エディター | ファイルおよびコードテンプレート`  の   その他   タブで微調整できます。

![新しい CMake プロジェクトのファイルテンプレート](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmake_templates_newprj.png)

テンプレートテキストを編集するときは、一般的な [定義済み変数](file-template-variables.html)と次の CMake 固有の変数を使用できます。

|  ${CMAKE_DEFAULT_PROJECT_FILE}  |  プロジェクトの  `main.cpp`  /  `main.c`  /  `libary.cpp`  /  `library.c`  ファイル。  |
|  ${CMAKE_LANGUAGE_VERSION}  |  選択した言語標準。  |
|  ${CMAKE_MAJOR_VERSION}  |  サポートされている CMake の最小バージョンのメジャー番号。 例: バージョンが  `3.20`  の場合、この変数は  `3`  に対応します。  |
|  ${CMAKE_MINOR_VERSION}  |  サポートされている CMake の最小バージョンのマイナー番号。 例: バージョンが  `3.20`  の場合、この変数は  `20`  に対応します。  |
|  ${CMAKE_LIBRARY_TYPE}  |  共有ライブラリの  `SHARED`   |
|  ${QT_VERSION}  |  選択した Qt バージョン。  |
|  ${REQUIRED_LIBS}  |  選択したプロジェクトタイプに必要な Qt ライブラリ。 デフォルトでは、Qt Console Executable の場合は  `Core`  、Qt Widgets Executable の場合は  `Core`  、  `Gui`  、  `Widgets`  です。  |

プロジェクトビューのコンテキストメニューに、  `新規 | CMakeLists.txt`  を介して既存のプロジェクトに追加できる CMake スクリプトのテンプレートもあります。 デフォルトでは、このテンプレートは空です。  `設定 | エディター | ファイルおよびコードテンプレート`  の   ファイル   タブで同じ変数を使用して編集できます。

![新しい CMakeLists.txt ファイルのファイルテンプレート](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmake_template_newcmakelists.png)

## CMakeLists.txt でのコーディング支援

### コード補完

CLion provides code completion for most of the elements in your  `CMakeLists.txt` . 例:  `find_package()`  コマンドを記述すると、CMake にバンドルされているパッケージのリストを取得できます。

![CMake での完成](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmake_findpackage_completion.png)

### CMake の最小バージョン用のクイックフィックス

CMake の必要最小限のバージョンをすばやく調整できます。 CMake 出力で警告を見つけて、   修正   をクリックします。

![CMake の最小バージョン用のクイックフィックス](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmake_version_quickfix.png)

CLion will change the version in the  `cmake_minimum_required()`  command:

![CMake の最小バージョンが変更されました](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmake_version_fixed.png)

### 生成メニューからターゲットを追加する

Procedure:

1. Press `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), `Alt+Insert` (Sublime Text), `⌘ N` (Sublime Text (macOS)), `⌘ N` (Xcode), `Alt+Insert` (Visual Studio), `⌘ ⌃ N` (Visual Studio (macOS)), `Alt+Insert` (ReSharper), `⌘ ⌃ N` (ReSharper (macOS)), `Alt+Insert` (QtCreator), `Alt+Insert` (QtCreator (macOS)), `Alt+Insert` (NetBeans), `Alt+Insert` (Eclipse), `⌘ N` (Eclipse (macOS)) and select the target type:

![CMake の生成メニュー](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmake_generatemenu.png)

2. Choose the files to be added to the new target:

![ターゲットファイルの選択](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmake_generate_choosefiles.png)

3. CLion will add an  `add_executable`  or  `add_library`  command:

![生成メニューからライブラリターゲットを追加した結果](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmake_generate_lib_result.png)

### CMake のライブテンプレート

[ライブテンプレート](using-live-templates.html)を使用して、構造またはコマンドをすばやく挿入します。 例:  `exe`  と入力し、 `Tab` (Windows), `⇥` (macOS), `⇥` (IntelliJ IDEA Classic (macOS)), `⇥` (macOS System Shortcuts), `Tab` (XWin), `Tab` (GNOME), `Tab` (KDE), `Tab` (Emacs), `Tab` (Sublime Text), `⇥` (Sublime Text (macOS)), `⇥` (Xcode), `Tab` (Visual Studio), `⇥` (Visual Studio (macOS)), `Tab` (ReSharper), `⇥` (ReSharper (macOS)), `Tab` (QtCreator), `⇥` (QtCreator (macOS)), `Tab` (NetBeans), `Tab` (Eclipse), `⇥` (Eclipse (macOS)) を押して実行可能なターゲットを追加します。

![add_executable の CMake ライブテンプレート](https://resources.jetbrains.com/help/img/idea/2026.3/cl_livetemplates_cmake_exe.png)

![add_executable テンプレートが挿入されました](https://resources.jetbrains.com/help/img/idea/2026.3/cl_livetemplates_cmake_exe_result.png)

CMake ライブテンプレートの完全なリストは  `設定 | エディター | ライブテンプレート | CMake`  で見つかります。

### パラメーター情報ポップアップ

パラメーター情報ポップアップには、入力時に CMake コマンドの署名バリアントが表示されます。

![CMake のパラメーター情報](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmake_paraminfo.png)

デフォルトでは、最初の括弧を入力してから 1 秒 (1000 ミリ秒) 以内にポップアップが表示されます。 これは [パラメーター情報の設定](viewing-method-parameter-information.html#configure-parameter-info-popup)で変更できます。

パラメーター情報を手動で呼び出すには、 `Ctrl+P` (Windows), `⌘ P` (macOS), `⌘ P` (IntelliJ IDEA Classic (macOS)), `⌘ P` (macOS System Shortcuts), `Ctrl+P` (XWin), `Ctrl+P` (GNOME), `Ctrl+P` (KDE), `Alt+Shift+P` (Emacs), `Ctrl+P` (Sublime Text), `Ctrl+P` (Sublime Text (macOS)), `⌘ ⇧ P` (Xcode), `Ctrl+Shift+Space` (Visual Studio), `⌘ P` (Visual Studio (macOS)), `Ctrl+P` (ReSharper), `⌘ P` (ReSharper (macOS)), `Ctrl+P` (QtCreator), `Ctrl+P` (QtCreator (macOS)), `Ctrl+P` (NetBeans), `Ctrl+P` (Eclipse), `⌃ ⇧ Space` (Eclipse (macOS)) を押します。

### クイックドキュメントポップアップ

[クイックドキュメントポップアップ](viewing-inline-documentation.html)は、CMake コード内の要素に関する詳細情報を取得できます。 呼び出すには、マウスホバーを使用するか、 `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)) を押します。

例: 補完候補のクイックドキュメントを表示できます。

![CMake 補完のクイックドキュメント](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmake_quickdoc_completion.png)

### コードの折りたたみ​​

CMake スクリプトでの折りたたみ / 展開は、マクロと関数、if-else 句、ブロック、コメント、任意のコード選択で使用できます (これを機能させるには、  `設定 | エディター | 一般 | コードの折りたたみ`  で   カスタム折りたたみ領域   を必ず有効にしてください)。

![CMake コードの折りたたみ](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmake_folding.png)

> **Tip:**
> `Ctrl+NumPad -` (Windows), `⌘ NumPad -` (macOS), `⌘ NumPad -` (IntelliJ IDEA Classic (macOS)), `⌘ NumPad -` (macOS System Shortcuts), `Ctrl+NumPad -` (XWin), `Ctrl+NumPad -` (GNOME), `Ctrl+NumPad -` (KDE), `Ctrl+NumPad -` (Emacs), `Ctrl+Shift+[` (Sublime Text), `⌘ ⌥ [` (Sublime Text (macOS)), `⌘ ⌥ ←` (Xcode), `Ctrl+M, S` (Visual Studio), `⌃ M, S` (Visual Studio (macOS)), `Ctrl+M, S` (ReSharper), `⌃ M, S` (ReSharper (macOS)), `Ctrl+Shift+Comma` (QtCreator), `⌘ ⇧ Comma` (QtCreator (macOS)), `Ctrl+NumPad -` (NetBeans), `Ctrl+NumPad -` (Eclipse), `⌘ NumPad -` (Eclipse (macOS)) / `Ctrl+NumPad +` (Windows), `⌘ NumPad +` (macOS), `⌘ NumPad +` (IntelliJ IDEA Classic (macOS)), `⌘ NumPad +` (macOS System Shortcuts), `Ctrl+NumPad +` (XWin), `Ctrl+NumPad +` (GNOME), `Ctrl+NumPad +` (KDE), `Ctrl+NumPad +` (Emacs), `Ctrl+Shift+]` (Sublime Text), `⌘ ⌥ ]` (Sublime Text (macOS)), `⌘ ⌥ →` (Xcode), `Ctrl+M, E` (Visual Studio), `⌃ M, E` (Visual Studio (macOS)), `Ctrl+M, E` (ReSharper), `⌃ M, E` (ReSharper (macOS)), `Ctrl+Shift+.` (QtCreator), `⌘ ⇧ .` (QtCreator (macOS)), `Ctrl+NumPad +` (NetBeans), `Ctrl+NumPad +` (Eclipse), `⌘ NumPad +` (Eclipse (macOS)) を押して、コードフラグメントを折りたたんだり展開したりします

### 構造ビュー​

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_structureview.png)

### カスタマイズ可能な構文のハイライト

`設定 | エディター | カラースキームの切り替え | CMake`  で CMake ファイルの色とフォントスキームを調整できます。

![CMake の配色設定](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmake_codestyle_settings.png)

## CMake ファイルのコードスタイル

`設定 | エディター | コードスタイル | CMake`  では、CMake ファイルに適用されるコードスタイルを調整できます。 特定の設定を変更すると、それがコードに与える影響がプレビューペインに表示されます。

![CMake コードスタイルの設定](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmake_codestyle_settings_format.png)

> **Tip:**
> For general information about code style options in CLion, refer to [コードスタイル](settings-code-style.html).

## See also

### リファレンス

[CMake Tool Window](cmake.html) [CMake Settings](cmake0.html)

### 外部リンク

[CMake Official Page](http://www.cmake.org/)

### プロシージャ

[クイック CMake チュートリアル](quick-cmake-tutorial.html) [Load/Reload CMake](reloading-project.html) [CMake プロファイリング](cmake-profiling.html) [Working with source code](working-with-source-code.html)

