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

Clang-Tidy インスペクション

Clang-Tidy チェックと JetBrains Rider のインスペクションを区別するには、インスペクションメッセージに追加された角括弧内のチェックの名前を確認できます。

Clang-Tidy チェックからの診断に加えて、JetBrains Rider は、Clang Static Analyzer からの診断と、Clang コンパイラー自体によって提供される警告も発行します。それらすべてに対応する構成可能な重大度レベルがあり、ニーズに合わせて調整できます。

JetBrains Rider の組み込みインスペクションを複製する Clang-Tidy チェックの一部は、デフォルトでオフになっています。さらに、すべての静的アナライザーチェックは無効になっています。これを有効にすると、Clang-Tidy の速度が大幅に低下するためです。

ビルトインインスペクションと同様に、インスペクションコンテキストメニューを使用して迅速に Clang-Tidy チェックの重大度を変更するにしたり、コメントを介して（特定のスコープまたはグローバルに）抑制したり、すべての同様の問題を見つけて調査したりできます。特定のチェックのオンラインドキュメントページを開く追加のアクションもあります。

Clang-Tidy の修正

JetBrains Rider を使用すると、Clang-Tidy によって提供される修正を、独自の組み込みクイックフィックスと同様に適用できます。他の一括修正と同様に、Clang-Tidy 修正は個別に適用することも、特定のスコープ (ファイル、フォルダー、プロジェクト、ソリューション) 内で適用することもできます。

デフォルトでは、JetBrains Rider は Clang-Tidy 修正によって変更されたコードを再フォーマットして、コードスタイルを維持します。この動作は、JetBrains Rider 設定 Ctrl+Alt+S の言語 & フレームワーク | C++ | Clang-Tidy ページの Clang-Tidy 修正を適用した後に変更されたコードを再フォーマットする設定で無効にすることができます。この設定を無効にすると、Clang-Tidy 修正の実行が高速化されます。

コードのクリーンアップによる Clang-Tidy 修正の適用

Clang-Tidy の修正は、コードのクリーンアップでも適用できます。組み込みのコードクリーンアッププロファイルには、利用可能なすべての Clang-Tidy 修正が含まれているわけではないため、構成するには、リストから Clang-Tidy プロファイルを選択し、その横にあるオプションボタンをクリックして、必要なすべてのチェックを選択する必要があります。このプロファイルでコードのクリーンアップを実行すると実行されます。

選択した修正は、対応するインスペクションが JetBrains Rider 設定 Ctrl+Alt+S のエディター | インスペクション設定 | インスペクション重大度ページでオフになっている場合でも適用されます。一度に多くのチェックを有効にする場合は注意してください — コードのクリーンアップは、特定のファイルに対して Clang-Tidy を 1 回だけ実行するため、複数の修正が同じコードブロックに触れると、変更が互いに競合する可能性があります。

Clang-Tidy の設定

JetBrains Rider は独自の Clang-Tidy 構成を作成しないため、ユーザー提供の構成を選択できます。Clang-Tidy は、ソースファイルの最も近い親ディレクトリにある .clang-tidy ファイルから各ソースファイルの構成を読み取ろうとします。ここでのソースファイル (残りの JetBrains Rider インスペクションと同様) は、分析が実行される場合は .cpp ファイル自体であり、ヘッダーファイルで分析が実行される場合はヘッダーを含むランダムな .cpp ファイルです。または、JetBrains Rider 設定 Ctrl+Alt+S の言語 & フレームワーク | C++ | Clang-Tidy ページで特定の clang-tidy 構成ファイルを使用する設定を選択して、構成ファイルの場所を指定することもできます。

Clang-Tidy バイナリの -checks コマンドラインオプションは、有効なチェックのリストを渡すために使用されます。このリストは、Clang-Tidy 構成から読み取られたチェックオプションの値に追加されます。-checks 引数を作成するために、JetBrains Rider は JetBrains Rider 設定 Ctrl+Alt+S の言語 & フレームワーク | C++ | Clang-Tidy ページで有効 / 無効な Clang-Tidy チェックのリスト設定の値を取得し、エディター | インスペクション設定 | インスペクション重大度オプションページでオフになっているチェックの名前をそれに追加します。

デフォルトでは、JetBrains Rider は Clang-Tidy 15.0.0 の組み込みバイナリを使用します。JetBrains Rider に他の Clang-Tidy バイナリ (バージョン 7 以降) を使用させることができます。これを行うには、JetBrains Rider 設定 Ctrl+Alt+S の言語 & フレームワーク | C++ | Clang-Tidy ページに 2 つの追加オプションがあります。

• %PATH% で検索 - %PATH% 環境変数で指定された場所にある Clang-Tidy を使用します。

• カスタム - 特定の Clang-Tidy 実行可能ファイルを使用します。

必要に応じて、ステータスインジケーターのコンテキストメニューの Clang-Tidy 分析を有効にする () トグルを使用して、現在のドキュメントで Clang-Tidy 分析を無効にすることもできます。

Clang-Tidy 統合の制限

• UTF-16 または UTF-32 エンコーディングを使用するファイルは Clang によって読み取られないため、現時点では Clang-Tidy ではサポートされていません。

• Clang-Tidy がコードでクラッシュする場合があり、Windows は「プロセスが動作を停止しました」というメッセージを表示します。この場合、JetBrains Rider 設定 Ctrl+Alt+S の言語 & フレームワーク | C++ | Clang-Tidy ページで、現在のソリューションの Clang-Tidy 統合を無効にします。

• カスタム Clang-tidy バイナリ ( JetBrains Rider 設定 Ctrl+Alt+S の言語 & フレームワーク | C++ | Clang-Tidy ページの %PATH% で検索およびカスタム ) を使用している場合は、バージョン 7 以降のみを使用できます。