# Makefile プロジェクト

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

CLion での [Makefile](https://www.gnu.org/software/make/manual/make.html) プロジェクトの完全なサポートは、まだ進捗中です。 [CPP-494(英語)](https://youtrack.jetbrains.com/issue/CPP-494) にリンクされたチケットを使用して、フィードバックを残し、希望する機能に投票してください。

> **Tip:**
> Makefile プロジェクトで事前設定が必要な場合は、 [Autotools](gnu-autotools.html) を参照してください。

Procedure: Makefile プロジェクトを開く

1. メインメニューから  `ファイル | オープン`  を選択します。

2. CLion が最上位の Makefile を含むフォルダーを指すようにします。

3. プロジェクトをクリーンアップするように求められます。

![プロジェクトをロードするダイアログ](https://resources.jetbrains.com/help/img/idea/2026.3/cl_makefile_cleandialog.png)

Make ビルドはインクリメンタルであり、更新されたファイルのみがコンパイルされるため、プロジェクトのロードにはクリーニングが必要です。 クリーン化されていないプロジェクトで実行すると、再ロードはすべての変更されていないファイルを見逃し、正しく実行されない可能性があります。

クリーニングせずにロードする場合は、   プロジェクトをクリーンにする   チェックボックスをオフにします。 プロジェクトは後でクリーンアップして [再ロード](#manual-reload)できます（たとえば、必要なブートストラップを実行した後など）。

4. CLion はプロジェクトを読み込み始め、進捗やステータスを   ビルド   ツールウィンドウに表示します：

![ビルドツールウィンドウでのプロジェクトの読み込みステータス](https://resources.jetbrains.com/help/img/idea/2026.3/cl_makefile_syncwindow.png)

プロセス中に警告メッセージが表示される場合がありますが、プロジェクト名の横に緑色のチェックマーク ![Successful load indicator](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.commit.svg) が表示されてロードが終了した場合、ロードが成功したことを示しています。 プロジェクトが正しく読み込めない場合は、 [トラブルシューティング](#troubleshooting)セクションを参照してください。

Procedure: 開いたプロジェクトの Makefile をロードする

プロジェクトをフォルダーとして開き、後で  `Makefile` を読み込むこともできます。 たとえば、プロジェクトで最終的な Makefile を準備するために事前構成ステップやスクリプトの実行が必要な場合は便利です。そのため、CLion でプロジェクトを開く際にはまだ Makefile が存在しません。

準備ができたときに  `Makefile`  をロードするには、エディターで開き、通知の   Makefile プロジェクトをロードする   リンクをクリックします。

![Makefile プロジェクト通知をロードする](https://resources.jetbrains.com/help/img/idea/2026.3/cl_makefile_load_notification.png)

または、プロジェクトツリーのファイルのコンテキストメニューから   Makefile プロジェクトをロードする   アクションを使用します。

> **Note:**
> VCS で Makefile プロジェクトを操作する場合、  `.iml`  ファイルはインポート時に再生成されるため、共有しないことを検討してください。 詳細については、 [この手順](https://intellij-support.jetbrains.com/hc/en-us/articles/206544839-How-to-manage-projects-under-Version-Control-Systems)を参照してください。

## 自動再読み込みを設定する

デフォルトでは、CLion は VCS 更新などの外部イベントがあった場合を除き、プロジェクトを自動的に更新または再読み込みしません。 この動作は   ビルドツール   設定で変更できます。

Procedure:

1. `設定 | ビルド、実行、デプロイ | ビルドツール`  に進みます。

2. 自動再読み込みオプションのいずれかを選択します。

![自動再ロードの設定](https://resources.jetbrains.com/help/img/idea/2026.3/cl_autoreload_settings.png)

* 任意の変更 - プロジェクトの再ロードは、Makefile の変更時にトリガーされます。

* 外部の変更 （デフォルト）- プロジェクトは、VCS 更新などの外部イベントが発生したときにのみ再ロードされます。 その他の変更（たとえば、新しいファイルを追加する場合）の場合、Makefile で通知を受け取ります。 ![Makefile 再ロード通知](https://resources.jetbrains.com/help/img/idea/2026.3/cl_makefile_reload_message.png)

> **Tip:**
> この設定はプロジェクトごとに機能します。 自動再読み込みオプションは、Makefile、 [コンパイルデータベース](compilation-database.html)、または [Gradle](gradle-support.html) プロジェクトごとに個別に設定する必要があります。

## 手動で再読み込み

自動オプションとは別に、プロジェクトを手動で再ロードすることもできます。

* メインメニューの `ツール | Makefile` から `Makefile プロジェクトを再読み込み` または `Makefile プロジェクトのクリーンと再ロード` を呼び出します。

* または、ビルドツールウィンドウで ![リロードアイコン](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.general.refresh.svg) または ![the Clean and reload icon](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.forceRefresh.svg) をクリックします： ![ビルドツールウィンドウのプロジェクト再読み込みアイコン](https://resources.jetbrains.com/help/img/idea/2026.3/cl_makefile_reload_icon.png)

> **Note:**
> プロジェクトでは、更新された Makefile を取得するために、変更後に [./configure(英語)](https://en.wikipedia.org/wiki/Configure_script) ステップを実行する必要がある場合もあります。

## プロジェクト設定を調整する

`設定 | ビルド、実行、デプロイ | Makefile`  ダイアログを使用して、プロジェクト設定を制御します。

![Makefile の設定](https://resources.jetbrains.com/help/img/idea/2026.3/cl_makefile_settings.png)

* ツールチェーン ここで、Makefile プロジェクトのロードに使用するツールチェーンを選択できます。 [現在、NMake はサポートされて](#issues-limitations)いないため、 [Visual Studio ツールチェーン](quick-tutorial-on-configuring-clion-on-windows.html#MSVC)を直接使用することはできません。 これを使用するには、GNUMake を使用してプロジェクトを個別にビルドする必要があります。 選択したツールチェーンにデフォルト以外のコンパイラー（ C コンパイラー および C++ コンパイラー フィールドで明示的に構成されている）が含まれている場合、それらは `make` にも渡されます。 > **Note:** > Windows -specific の詳細: > > > > * Makefile には、ツールへのフルパスが含まれている場合があります。 この場合、同じパスを持つ対応するツールチェーンを選択してください。 > > * [MinGW](quick-tutorial-on-configuring-clion-on-windows.html#MinGW) ツールチェーンを使用する際は、パスにスペースが含まれていないことを確認してください。 必要に応じて、 `C:\PROGRA~1\mingw-w64\...` などの `~` 表記を使用します。

* ビルドオプション このフィールドでは、プロジェクトビルドに追加の [make オプション(英語)](https://www.gnu.org/software/make/manual/html_node/Options-Summary.html)を提供できます。 これらのオプションは、プロジェクトの再ロードには影響しません。

* コマンド このフィールドでは、事前設定パラメーターを調整できます。 [事前構成（GNU Autoconf）](gnu-autotools.html#autoconf)を参照してください。

* 引数 これらの引数は、プロジェクト情報の抽出、プロジェクトのクリーニング、ビルドターゲットの検索のステップで `make` コマンドを呼び出すときに CLion によって使用されます。

* ビルドターゲット と クリーンのターゲット これらのターゲットは、 `make` コマンドとともに使用され、プロジェクト情報を抽出します。 ビルドターゲット フィールドを空のままにすると、CLion はプロジェクトの最上位の Makefile で指定された最初のターゲットを取得します。 また、ここで指定したターゲットは、 [ビルドアクション](build-actions.html#buildactions-makefiles)メニューから プロジェクトのビルド または プロジェクトの再ビルド を呼び出すときに使用されます。

ビルド   ツールウィンドウから Makefile 設定ダイアログにすばやくアクセスできます。 コンテキストメニューから   Makefile 設定   を選択するか、 ![設定アイコン](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.settings.svg) をクリックします。

![ビルドツールウィンドウから Makefile 設定にアクセスする](https://resources.jetbrains.com/help/img/idea/2026.3/cl_makefile_settings_fromtw.png)

### 拡張設定

Makefile プロジェクトのその他の設定は、  `設定 | 詳細設定`  で利用できます。

![Makefile プロジェクトの詳細設定](https://resources.jetbrains.com/help/img/idea/2026.3/cl_makefile_advancedsettings.png)

> **Tip:**
> 詳細については、 [詳細設定](advanced-settings.html)を参照してください。

## Makefile アプリケーションの実行とデバッグ

CLion は最上位の Makefile から各ターゲットの [ネイティブアプリケーション](run-debug-configuration-makefile-application.html)構成を自動作成します：

![自動作成されたネイティブアプリケーション構成](https://resources.jetbrains.com/help/img/idea/2026.3/cl_makefile_targetconfigs_autocreated.png)

構成作成時、CLion は以下のターゲットをフィルターで除外します：

* `clean` ターゲット。

* オブジェクト（ `.o` ）ファイルに対応するターゲット。

* 不明なファイル拡張子で終わるターゲット（たとえば、 `.d` ）。

`実行構成の編集`  ダイアログで、自動的に作成された構成をカスタマイズしたり、新しい構成を作成したりできます（以下を参照）。

Procedure: ネイティブアプリケーション構成を作成する

1. メインメニューで  `実行 | 実行構成の編集​`  に移動し、 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) をクリックし、テンプレートリストから   ネイティブアプリケーション   を選択します：

![ネイティブアプリケーション構成の追加](https://resources.jetbrains.com/help/img/idea/2026.3/cl_makefile_addconfig.png)

2. ターゲット​   フィールドでは、検出されたターゲットの 1 つを選択できます。

![ネイティブアプリケーション構成のターゲットの選択](https://resources.jetbrains.com/help/img/idea/2026.3/cl_makefiles_rdconfig_targets.png)

別のオプションは、型   Make   のカスタムビルドターゲットを設定することです。   ターゲット​   フィールドの横にある ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.inlayGear.svg) をクリックし、新しい   Make   ターゲットを追加（ ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg)）して、パラメーターを入力します。

![ネイティブアプリケーション構成のカスタムターゲット](https://resources.jetbrains.com/help/img/idea/2026.3/cl_makefile_customtargets.png)

![ネイティブアプリケーション構成のカスタムターゲット](https://resources.jetbrains.com/help/img/idea/2026.3/cl_makefile_customtargets_2.png)

3. 実行可能ファイル   フィールドにバイナリへのフルパスを入力します。

> **Note:**
> アプリケーションをデバッグする場合は、バイナリにデバッグシンボルが含まれていることを確認してください。 例: Makefile で  `-g`  を  `CXXFLAGS`  に追加できます。

[リモート](remote-projects-support.html)で実行 / デバッグするには、  リモート マシン上のバイナリへのパスを指定します。 リモートパスは手動で設定する必要があることに注意してください。

4. ネイティブアプリケーション   テンプレートのその他の設定は、 [リファレンスページ](run-debug-configuration-makefile-application.html)で説明されています。

Procedure: ネイティブアプリケーション構成を実行する

スイッチャーで目的の構成を選択し、次のオプションのいずれかを使用します。

* ![実行ボタン](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)) を押す。

* メインメニューから  `実行 | 実行 'selected configuration'`  を選択します。

Procedure: ネイティブアプリケーション構成をデバッグする

デバッグセッションを開始する前に、 [構成](#create-makefile-config)で指定されたバイナリにデバッグシンボルが含まれていることを確認してください。

スイッチャーで目的の構成を選択し、次のオプションのいずれかを使用します。

* ツールバーの ![the Run button](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.startDebugger.svg) をクリックします。

* `Shift+F9` (Windows), `⌃ D` (macOS), `⇧ F9` (IntelliJ IDEA Classic (macOS)), `⌥ ⇧ D` (macOS System Shortcuts), `Shift+F9` (XWin), `Shift+F9` (GNOME), `Shift+F9` (KDE), `Shift+F9` (Emacs), `Shift+F9` (Sublime Text), `⌃ D` (Sublime Text (macOS)), `⌘ R` (Xcode), `Alt+F5` (Visual Studio), `⌥ F5` (Visual Studio (macOS)), `Alt+F5` (ReSharper), `⌥ F5` (ReSharper (macOS)), `F5` (QtCreator), `⌘ Y` (QtCreator (macOS)), `Ctrl+F5` (NetBeans), `Alt+Shift+D` (Eclipse), `⌘ F11` (Eclipse (macOS)) を押す。

* メインメニューから  `実行 | デバッグ 'selected configuration'`  を選択します。

## Makefile ターゲットを実行する

ガターメニューを使用して、特定のターゲットに対して  `make`  をすばやく呼び出すことができます。

![ターゲットを実行するためのガターメニュー](https://resources.jetbrains.com/help/img/idea/2026.3/cl_makefiles_gutter.png)

または、   Make   ツールウィンドウ（  `表示 | ツールウィンドウ | make`  ）からターゲットを実行することもできます。 ターゲットをダブルクリックするか、ターゲットを選択してから ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.execute.svg) をクリックします。

![作成ツールウィンドウから実行中のターゲット](https://resources.jetbrains.com/help/img/idea/2026.3/cl_make_tool_window.png)

これらのアクションのいずれかによって、CLion は [Makefile ターゲット](makefile-target-configuration.html)タイプの [一時構成](run-debug-configuration.html)を作成します。 これをカスタマイズしたり、  `実行構成の編集`  ダイアログで同じテンプレートから新しい構成を作成したりできます (以下を参照)。

Procedure: Makefile ターゲット構成を作成する

* メインメニューで  `実行 | 実行構成の編集​`  に移動し、 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) をクリックし、テンプレートリストから   Makefile ターゲット   を選択します：

![Makefile ターゲット構成の追加](https://resources.jetbrains.com/help/img/idea/2026.3/cl_makefile_target_config_template.png)

* 設定では、実行する複数のターゲットを設定し、追加の引数を指定し、必要に応じて他のパラメーターを調整できます。 詳細については、 [リファレンスページ](makefile-target-configuration.html)を参照してください。

![Makefile ターゲット構成](https://resources.jetbrains.com/help/img/idea/2026.3/cl_makefile_target_config.png)

* 変更を適用   をクリックして変更を保存します。

> **Note:**
> * ガターからターゲットを実行する場合や Makefile ターゲット構成経由で実行する場合、CLion は現在選択されているツールチェーンに関わらず `設定 | ビルド、実行、デプロイ | ビルドツール | メイク` の `make` へのパスを使用します。 ![ビルドツールの設定を行う](https://resources.jetbrains.com/help/img/idea/2026.3/cl_make_buildtools_settings.png)
>
> * Makefile ターゲット構成は、 [リモート](remote-projects-support.html)または [Docker](clion-toolchains-in-docker.html) ツールチェーンでは使用できません。 WSL の場合の詳細については、 [以下](#wsl-notes)を参照してください。

## WSL の詳細

### 設定を同期する

[WSL](how-to-use-wsl-development-environment-in-product.html) を使用する場合は、プロジェクトごとのツールチェーン設定とグローバル   Make   設定を同期してください。

Procedure:

1. `設定 | ビルド、実行、デプロイ | ビルドツール | メイク`  に進みます。

2. 実行可能にするためのパス   の横にあるセレクターをクリックし、WSL の  `make`  へのパスを設定します：

![WSL で作成するパスの選択](https://resources.jetbrains.com/help/img/idea/2026.3/cl_makefile_wsl.png)

### 非ルート WSL ユーザー

ルート以外の WSL ユーザーで作業している場合は、  `make`  プロセスとそれが作成する可能性のあるすべてのファイルを所有するために、このユーザーをデフォルトとして設定する必要があります。

Procedure:

1. WSL ゲスト内に  `/etc/wsl.conf`  ファイルを作成し、次の行を追加します。

```CONSOLE
[user]
default=username

```

ここで、  `username`  は WSL ゲストユーザー名です（Windows ユーザー名とは異なる場合があります）。

詳細については、 [WSL ドキュメント](https://docs.microsoft.com/en-us/windows/wsl/wsl-config#user)を参照してください。

2. WSL マシンを再起動します。

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

Makefile   プラグインと   Makefile 言語   プラグインの両方が有効になっていることを確認してください。  `設定 | プラグイン`  を確認してください。

![Makefile サポートプラグイン](https://resources.jetbrains.com/help/img/idea/2026.3/cl_makefile_plugins.png)

プロジェクトが正しく読み込めない場合は、次のヒントを試してください。

* [Makefile の設定](#makefile-settings)を確認します。 1. 適切なツールチェーンを選択してください。 選択した環境でプロジェクトが正常にビルドされるはずです。 2. 引数 と ビルドターゲット は、プロジェクトの場合に合わせて調整する必要がある場合があります。

* メインメニューから `ツール | Makefile | Makefile プロジェクトのクリーンと再ロード` を呼び出すか、ビルドツールウィンドウで ![the Clean and reload icon](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.forceRefresh.svg) をクリックします。

* プロジェクトの Makefile が [プレメイク(英語)](https://premake.github.io/)によって生成された場合は、ルート Makefile から `--no-print-directory` 引数を削除してみてください。

* 上記のいずれも役に立たない場合は、システムディレクトリ（たとえば、 `~/Library/Caches/JetBrains/CLion2020.2/makefiles/postgrtipes.dc29ef09` ）の `/makefiles` からプロジェクトキャッシュをクリーンアップしてから、プロジェクトを [再ロード](#manual-reload)してみてください。

## 現在の限界と今後の計画

* CLion は [ccache](https://ccache.dev/) および [libtool](https://www.gnu.org/software/libtool/)（また、その代替実装である [Dolt](https://dolt.freedesktop.org/)、 [slibtool](https://dev.midipix.org/cross/slibtool)、 [jlibtool](https://github.com/alandekok/jlibtool) など）を使用する Makefile プロジェクトを処理しますが、 [distcc](https://github.com/distcc/distcc) にはまだ対応していません（ [CPP-19305](https://youtrack.jetbrains.com/issue/CPP-19305)）。

* [NMake(英語)](https://docs.microsoft.com/cpp/build/reference/nmake-reference?view=vs-2019) や BSD Make などの非 GNU メイクは、現時点ではサポートされていません（ [CPP-18723(英語)](https://youtrack.jetbrains.com/issue/CPP-18723)）。

* [単体テストの構成](unit-testing-tutorial.html#test-configurations)は、まだ Makefile プロジェクトでは使用できません（ [CPP-20718(英語)](https://youtrack.jetbrains.com/issue/CPP-20718)）。

## See also

### 外部リンク

[Dealing with Makefile Projects in CLion: Status Update](https://blog.jetbrains.com/clion/2020/02/dealing-with-makefiles/)

### プロシージャ

[Autotools](gnu-autotools.html)

