Visual Studio での Clang-Tidy の使用
Clang-Tidy のサポートには、2019 バージョン 16.4 以降 Visual Studio が必要です。 このバージョンのドキュメントを表示するには、この記事の Visual Studio の [バージョン] セレクター コントロールを Visual Studio 2019 以降に設定してください。 このページの目次の一番上にあります。
Code Analysis では、Clang または MSVC ツールセットを使用しているかどうかにかかわらず、MSBuild と CMake の両方のプロジェクトに対して Clang-Tidy をネイティブにサポートします。 Clang-Tidy チェックは、バックグラウンド コード分析の一部として実行できます。 これらは、エディター内の警告 (波線) として表示され、エラー一覧に表示されます。
Clang-Tidy のサポートは、Visual Studio 2019 バージョン 16.4 以降で使用できます。 Visual Studio インストーラーで C++ ワークロードを選択すると、自動的に追加されます。
Clang-Tidy は、MSBuild と CMake の両方で使用できる llvm/clang-cl ツールセットを使用する場合の既定の分析ツールです。 MSVC ツールセットを使用して、標準の Code Analysis エクスペリエンスと一緒に実行するか、置き換えるかを設定できます。 clang-cl ツールセットを使用する場合、Microsoft Code Analysis は使用できません。
コンパイルが成功すると Clang-Tidy が実行されます。 Clang-Tidy の結果を取得するには、ソース コード エラーの解決が必要になる場合があります。
MSBuild
両方の Code Analysis の一部として実行するように Clang-Tidy を構成し、Project プロパティ ウィンドウの [コード分析]>[全般] ページでビルドできます。 ツールを構成するオプションは、[Clang-Tidy] サブメニューにあります。
詳細については、「方法: C/C++ プロジェクトのコード分析プロパティを設定する」を参照してください。
CMake
CMake プロジェクトでは、CMakeSettings.json 内の Clang-Tidy チェックを構成できます。 開いたら、CMake プロジェクト設定エディターの右上隅にある [JSON の編集] を選択します。 次のキーが認識されます。
enableMicrosoftCodeAnalysis: Microsoft Code Analysis の有効化enableClangTidyCodeAnalysis: Clang-Tidy 分析を有効にしますclangTidyChecks: Clang-Tidy 構成、コンマ区切りのリスト、つまり、有効または無効にするかどうかを指定します
"enable" オプションが指定されていない場合、Visual Studio は、使用するプラットフォーム ツールセットと一致する分析ツールを選択します。
警告の表示
Clang-Tidy を実行すると、エラー一覧に警告が表示されます。また、コードの関連するセクションの下にエディター上の波線が表示されます。 Clang-Tidy 警告を並べ替えて整理するには、エラー一覧の [カテゴリ] 列を使用します。 エディター内の警告を構成するには、[ツール] > [オプション] の下にある [コード分析破線を無効にする] 設定を切り替えます。
Clang-Tidy 構成
既定では、Clang-Tidy は有効にされても、何もチェックは設定されません。 コマンド ライン バージョンのチェック一覧を表示するには、開発者コマンド プロンプトで clang-tidy -list-checks を実行します。 Visual Studio 内で Clang-Tidy によって実行されるチェックを構成できます。 [プロジェクト プロパティ ページ] ダイアログで、[構成プロパティ]>[Code Analysis]>[Clang-Tidy] ページを開きます。 [Clang-Tidy チェック] プロパティで実行するチェックを入力します。 適切な既定のセットは clang-analyzer-* です。 このプロパティ値は、ツールの --checks 引数に指定されます。 その他の構成は、カスタム .clang-tidy ファイルに含めることができます。 詳細については、「LLVM.org の Clang-Tidy ドキュメント」を参照してください。