Clangの診断設定

Clang-Tidy および Clazy を使用して、C、C++、および Objective-C プログラムの問題を検出します。

実行する Clang チェックの選択と編集を行うには：

1. 「Preferences 」＞「Analyzer 」＞「Clang Tools 」を選択します。

   

2. 「Diagnostic configuration 」フィールドには、実行するチェックが表示されます。このフィールドの値を選択すると、「Diagnostic Configurations 」ダイアログが開き、そこで実行するチェックを選択・編集できます。

   

   代わりに Clang-Tidy 設定ファイルに基づいてチェックを実行するには、「Clang Tools 」タブで「Prefer .clang-tidy file, if present 」を選択してください。

3. 「Copy 」を選択すると、選択した診断項目が編集用にコピーされます。

   

4. [Diagnostic configuration name ] フィールドで設定に名前を付け、[OK] を選択します。
5. [Clang Warnings ] タブで、[Use diagnostic flags from the build system ] を選択して、ビルドシステムからの警告フラグなどの診断フラグを Clang コードモデルに転送し、コードエディタに注釈を表示します。
6. [Clang-Tidy Checks ] タブで、[Select Checks ] を選択して、実行するチェックを指定します。チェックを絞り込むには、[Filter by name ] フィールドに文字列を入力します。

   

   利用可能なチェッカーの詳細については、Clang Static Analyzer のドキュメントを参照してください。

7. 選択したチェックをプレーンテキストで編集するには、[Edit Checks as String] を選択します。
8. 「Clazy Checks 」タブで、実行する Clazy チェックのレベルを選択します。

   

9. 選択したチェックをプレーンテキストで編集するには、[Edit Checks as String] を選択します。
10. [Filters ] フィールドでトピックを選択すると、[Checks ] フィールドに、その領域に関連するチェックのみが表示されます。選択した領域のチェックをフィルタリングするには、[Filter by name ] フィールドに文字列を入力します。
11. すべてのチェックを再度表示するには、「Reset Topic Filter 」を選択します。
12. チェックに関する詳細情報をオンラインで表示するには、各チェックの横にある「Web Page 」リンクを選択してください。

Clazy チェックレベルの選択

Clazy チェックは 0 から 3 までのレベルに分かれています。レベル 0 のチェックは非常に安定しており、誤検知はほとんど発生しませんが、レベル 3 のチェックは実験的なものです。各レベルで実行するチェックを選択できます。下位のレベルのチェックを自動的に含めるには、[Enable lower levels automatically] を選択します。

Clang-Tidy 設定ファイルの作成

Clang-Tidy は、各ソースファイルの最も近い親ディレクトリにある .clang-tidy ファイルから、そのソースファイルの設定を読み込みます。設定オプションに対応するコマンドラインオプションがある場合、コマンドラインオプションが優先されます。有効な設定は、-dump-config を使用して確認できます。

Qt Creator は、選択したチェックに基づいて設定を自動的に生成します。チェックをファイル形式で保存するには、次のように .clang-tidy ファイルを作成します。

1. Edit Checks as String を選択し、フィールドの内容をコピーします。
2. clang-tidy -dump-config の出力を、.clang-tidy という名前のファイルにパイプで転送します。例：clang-tidy -checks=-*,bugprone-*,cppcoreguidelines-avoid-* -dump-config > .clang-tidy
3. .clang-tidy ファイルをソースコードの親ディレクトリに移動します。

後でQt Creator を使用してチェックを追加するには、.clang-tidyファイルからチェック項目をEdit Checks as String フィールドにコピーし、追加のチェック項目を選択して、そのフィールドの内容を.clang-tidyファイルにコピー＆ペーストします。