CLion 2026.2 Help

Makefile プロジェクト

CLion での Makefile プロジェクトの完全なサポートは、まだ進捗中です。 CPP-494(英語) にリンクされたチケットを使用して、フィードバックを残し、希望する機能に投票してください。

Makefile プロジェクトを開く

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

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

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

    プロジェクトをロードするダイアログ

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

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

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

    ビルドツールウィンドウでのプロジェクトの読み込みステータス

    プロセス中に警告メッセージが表示される場合がありますが、プロジェクト名の横に緑色のチェックマーク Successful load indicator が表示されてロードが終了した場合、ロードが成功したことを示しています。 プロジェクトが正しく読み込めない場合は、 トラブルシューティングセクションを参照してください。

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

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

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

Makefile プロジェクト通知をロードする

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

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

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

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

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

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

      • 外部の変更 (デフォルト)- プロジェクトは、VCS 更新などの外部イベントが発生したときにのみ再ロードされます。 その他の変更(たとえば、新しいファイルを追加する場合)の場合、Makefile で通知を受け取ります。

        Makefile 再ロード通知

    手動で再読み込み

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

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

    • または、ビルドツールウィンドウで リロードアイコン または the Clean and reload icon をクリックします:

      ビルドツールウィンドウのプロジェクト再読み込みアイコン

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

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

    Makefile の設定
    • ツールチェーン

      ここで、Makefile プロジェクトのロードに使用するツールチェーンを選択できます。

      現在、NMake はサポートされていないため、 Visual Studio ツールチェーンを直接使用することはできません。 これを使用するには、GNUMake を使用してプロジェクトを個別にビルドする必要があります。

      選択したツールチェーンにデフォルト以外のコンパイラー(C コンパイラー および C++ コンパイラー フィールドで明示的に構成されている)が含まれている場合、それらは make にも渡されます。

    • ビルドオプション

      このフィールドでは、プロジェクトビルドに追加の make オプション(英語)を提供できます。 これらのオプションは、プロジェクトの再ロードには影響しません。

    • コマンド

      このフィールドでは、事前設定パラメーターを調整できます。 事前構成(GNU Autoconf)を参照してください。

    • 引数

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

    • ビルドターゲットクリーンのターゲット

      これらのターゲットは、 make コマンドとともに使用され、プロジェクト情報を抽出します。 ビルドターゲット フィールドを空のままにすると、CLion はプロジェクトの最上位の Makefile で指定された最初のターゲットを取得します。

      また、ここで指定したターゲットは、 ビルドアクションメニューから プロジェクトのビルド または プロジェクトの再ビルド を呼び出すときに使用されます。

    ビルド ツールウィンドウから Makefile 設定ダイアログにすばやくアクセスできます。 コンテキストメニューから Makefile 設定 を選択するか、 設定アイコン をクリックします。

    ビルドツールウィンドウから Makefile 設定にアクセスする

    拡張設定

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

    Makefile プロジェクトの詳細設定

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

    CLion は最上位の Makefile から各ターゲットの ネイティブアプリケーション構成を自動作成します:

    自動作成されたネイティブアプリケーション構成

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

    • クリーン ターゲット。

    • オブジェクト( .o )ファイルに対応するターゲット。

    • 不明なファイル拡張子で終わるターゲット(たとえば、 .d )。

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

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

    1. メインメニューで 実行 | 実行構成の編集​ に移動し、 をクリックし、テンプレートリストから ネイティブアプリケーション を選択します:

      ネイティブアプリケーション構成の追加
    2. ターゲット​ フィールドでは、検出されたターゲットの 1 つを選択できます。

      ネイティブアプリケーション構成のターゲットの選択

      別のオプションは、型 Make のカスタムビルドターゲットを設定することです。 ターゲット​ フィールドの横にある をクリックし、新しい Make ターゲットを追加( )して、パラメーターを入力します。

      ネイティブアプリケーション構成のカスタムターゲット
      ネイティブアプリケーション構成のカスタムターゲット
    3. 実行可能ファイル フィールドにバイナリへのフルパスを入力します。

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

    4. ネイティブアプリケーション テンプレートのその他の設定は、 リファレンスページで説明されています。

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

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

    • 実行ボタン をクリックします。

    • Shift+F10 を押す。

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

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

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

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

    • ツールバーの the Run button をクリックします。

    • Shift+F9 を押す。

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

    Makefile ターゲットを実行する

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

    ターゲットを実行するためのガターメニュー

    または、 Make ツールウィンドウ(表示 | ツールウィンドウ | make )からターゲットを実行することもできます。 ターゲットをダブルクリックするか、ターゲットを選択してから をクリックします。

    作成ツールウィンドウから実行中のターゲット

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

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

    • メインメニューで 実行 | 実行構成の編集​ に移動し、 をクリックし、テンプレートリストから Makefile ターゲット を選択します:

      Makefile ターゲット構成の追加
    • 設定では、実行する複数のターゲットを設定し、追加の引数を指定し、必要に応じて他のパラメーターを調整できます。 詳細については、 リファレンスページを参照してください。

      Makefile ターゲット構成
    • 変更を適用 をクリックして変更を保存します。

    WSL の詳細

    設定を同期する

    WSL を使用する場合は、プロジェクトごとのツールチェーン設定とグローバル Make 設定を同期してください。

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

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

      WSL で作成するパスの選択

    非ルート WSL ユーザー

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

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

      [user] default=username

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

      詳細については、 WSL ドキュメントを参照してください。

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

    トラブルシューティング

    Makefile プラグインと Makefile 言語 プラグインの両方が有効になっていることを確認してください。 設定 | プラグインインストール済み タブを確認してください。

    Makefile サポートプラグイン

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

    • Makefile の設定を確認します。

      1. 適切なツールチェーンを選択してください。 選択した環境でプロジェクトが正常にビルドされるはずです。

      2. 引数ビルドターゲット は、プロジェクトの場合に合わせて調整する必要がある場合があります。

    • メインメニューから ツール | Makefile | Makefile プロジェクトのクリーンと再ロード を呼び出すか、ビルドツールウィンドウで the Clean and reload icon をクリックします。

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

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

    現在の限界と今後の計画

    2026 年 7 月 15 日