CLion 2026.2 Help

Clang-Tidy インテグレーション

Clang-Tidy(英語) は、静的コード分析用の Clang ベースのツールです。 CLion は、Clang-Tidy が独自のコードインスペクションと同じ方法でチェックし、 黄色の電球アイコン-button または Alt+Enter を介してクイックフィックスを利用できることを示しています。

Clang-Tidy working on-the-fly

Clang-Tidy の一般的な設定

Clang-Tidy チェックはデフォルトで有効になっており、エディターで警告 (または別の重大度レベルのメッセージ) として表示できます。

すべてのチェックがデフォルトで有効になっているわけではないことに注意してください。 ここで CLion の Clang-Tidy デフォルト構成の詳細を確認できます。

Clang-Tidy 構成を調整するには、 設定 | エディター | インスペクション | C/C++ | 静的分析ツール | Clang-Tidy に移動します。

Clang-Tidy チェックの設定

チェックのリストを構成する

  • をクリックして、チェックのリストを編集できるダイアログを開きます。

    Clang-tidy チェックツリービュー

    特定のチェックをすばやく見つけるには、ダイアログにフォーカスがあるときにその名前の入力を開始します。

    左側には、 Clang-Tidy の公式ドキュメント Web サイト(英語)からの各チェックの詳細な説明が表示されます。 エディターから簡単な概要を確認することもできます。 ハイライトされたコードの上にマウスを置き、表示されるツールチップで the More button をクリックし、 インスペクションの説明を表示 を選択します。

    Clang-Tidy ツールチップ
  • Clang-Tidy コマンドライン形式(英語)を使用して、特定のチェックを手動で有効 / 無効にすることもできます。

    カンマ区切りの正と負のグロブのリストを指定してください。正のグロブはチェックのサブセットを追加し、負のグロブ("-" で始まる)はチェックを削除します。

    例: 次のコマンドラインは、すべてのデフォルトチェック -* を無効にし、 clang-analyzer-cplusplus* チェックを除くすべての clang-analyzer-* チェックを有効にします。

    -*,clang-analyzer-*,-clang-analyzer-cplusplus*

特定のチェックのオプションを構成する

一部の Clang-Tidy チェックにはオプションがあり、チェックに追加または実質的なオプションがあります (readability-identifier-naming(英語) の場合のように)。

  • Clang-Tidy チェックオプションの構成 をクリックして、オプションダイアログを開きます。

  • オプションは、定義済みのデフォルト値とともに表示されます。 オプションを変更すると、青色でハイライトされます。

    リストをすばやく検索するには、ダイアログにフォーカスを合わせて入力を開始します。

    チェックのオプション

エディターでのチェックのチューニング

インスペクション設定 ダイアログに加えて、単一のチェック、チェックのグループ、エディターから Clang-Tidy インスペクション全体を無効にすることができます。 これらのアクションはそれぞれ、Clang-Tidy コマンドラインを更新します。

コンテキストメニューからチェックを設定する

特定の行の Clang-Tidy チェックを 抑制するには、 行の「check_name」を抑制 オプションを使用します。 CLion は、選択した行の最後に // NOLINT コメントを追加します。

構成ファイル

.clang-tidy ファイルでディレクトリごとに構成を設定できます。各ソースファイルに対し、Clang-Tidy は最も近い親ディレクトリ内の .clang-tidy から構成を読み込もうとします。

現在のソースファイルで使用されている .clang-tidy 構成ファイルを開くには、ステータスバーのウィジェットで <current file> の clang-tidy ファイルを編集 を選択します。

.clang-tidy ファイルを編集する

現在開いているソースファイルで使用できる .clang-tidy 構成がない場合は、ウィジェットで .clang-tidy ファイルを作成する を選択して作成できます。

.clang-tidy ファイルを作成する

新しいファイルには、 設定 | エディター | インスペクション | C/C++ - 静的分析ツール - Clang-Tidy で構成された設定が含まれます。

.clang-tidy ファイルは YAML(英語) 形式です。 構文の例として、すべての Clang-Tidy チェックを有効にして、追加のオプションを modernize-use-nullptr に提供してみましょう。

Checks: '*' CheckOptions: - key: modernize-use-nullptr.NullMacros value: NULL,CUSTOM_NULL

デフォルトでは、 .clang-tidy(英語) ファイルは IDE 設定よりも優先されます。 ソースファイルを分析する際、CLion は到達可能な構成ファイル(現在のディレクトリまたは親ディレクトリのいずれかにある)の設定を使用します。 そのようなファイルがない場合、CLion は自身の設定を使用します。

この動作を変更するには、 設定 | エディター | インスペクション - C/C++、静的解析ツール、Clang-TidyIDE 設定よりも .clang-tidy ファイルを優先する チェックボックスをオフにします。

カスタム Clang-Tidy 実行可能ファイル

バンドルされているものではなく、独自の Clang-Tidy 実行可能ファイルを使用できます (たとえば、 カスタムチェック(英語)を作成して CLion で使用する場合)。

設定 | 言語 & フレームワーク | C/C++ でカスタム Clang-Tidy バイナリへのパスを指定します (または インスペクション設定 ダイアログで 実行可能な Clang-Tidy を指定する をクリックします)。

カスタム Clang-Tidy バイナリ

この設定は IDE ワイド です。すべてのプロジェクトでカスタム Clang-Tidy バイナリが使用されます。

Clang-Tidy アップデートのお知らせ

CLion は対応する LLVM リビジョンに基づいた Clang-Tidy をバンドルしているため、CLion が Clang のアップデートをリリースすると、バンドルされている Clang-Tidy 実行可能ファイルも新しいバージョンに更新され、IDE に通知が表示されます:

Clang-Tidy アップデートのお知らせ

レビュー をクリックして、Clang-Tidy インスペクション設定に従って、使用可能な新しいチェックとそれらのアクティブ化状態のリストを開きます。 このダイアログでチェックを有効または無効にすることができ、それに応じて Clang-Tidy 設定が変更されます。

新しい Clang-Tidy チェックのリスト

IDE 設定の代わりに カスタム構成ファイルを使用する場合、この通知は clang-tidy ファイルが IDE 設定を上書きする可能性がありますについても警告します。

2026 年 7 月 15 日