Clangd

Clangプロジェクトには、C言語ファミリーのソースファイルを解析し、詳細な診断を提供するライブラリがあります。clangdインデックスは、コード補完などのサービスに対して正確で完全な結果を提供します。

clangdのプリファレンスを設定するには

1. Preferences>C++ >Clangd >Use clangd を選択します。

   

2. Path to executable に、clangd バージョン 14 以降へのパスを入力します。
3. Background indexing フィールドで、Off を選択して、デフォルトで使用されているものよりも高速だが精度の低い組み込みインデクサを使用します。グローバル・シンボル検索において、結果の正確さとスピードのどちらを重視するかによって、インデックスの優先順位を設定します。
4. Per-project index location で、各プロジェクトのインデックスファイルを保存するフォルダを選択します。compile-commands.json ファイルもこのフォルダに保存されます。
5. Per-session index location で、各セッションのインデックスファイルを保存するフォルダを選択します。
6. Header/source switch mode で、ヘッダー・ファイルとソース・ファイルを切り替える C/C++ バックエンドを選択します。clangdの実装は組み込みコード・モデルよりも多くの機能を持っていますが、誤検出する傾向があります。Try Both は、組み込みコード・モデルが何も見つからなかった場合にclangdを使用します。
7. デフォルトでは、clangdはすべての未使用コアを使おうとします。Worker thread count で使用する固定コア数を設定することができます。 バックグラウンド・インデックスもこの数のワーカースレッドを使用します。
8. シンボルを完成させるときにヘッダーファイルを挿入するにはInsert header files on completion を選択してください。
9. Update dependent sources を選択すると、ヘッダー・ファイルを編集するときに、ヘッダー・ファイルを含むすべてのソース・ファイルを再パースします。ヘッダー・ファイルが多くのソース・ファイルに含まれている場合、CPU負荷が高くなることがあります。このオプションをオフにすると、ヘッダー・ファイルを保存するときにソース・ファイルのみをリパースします。
10. コード補完中に重要な結果を定期的に見逃す場合は、Completion results の数を設定します。0 に設定すると、補完結果の数の制限がなくなります。この値を 0 に設定したり、非常に大きな値に設定すると、コード補完が遅くなることがあります。
11. Completion ranking model で、補完候補の順位付けに使用するクラングド・モデルを選択します。これにより、選択リストでの順序が決まります。Decision Forest モデル (Default) は事前に学習された機械学習によるもので、通常は手作業で作成されたHeuristic モデルよりも優れた結果を提供します。補完候補がコード・ベースに対する期待値から大きく外れている場合は、後者を選択してください。
12. Document update threshold では、Qt Creator がドキュメントの変更をサーバーに送信するまでの待ち時間を指定します。待っている間にドキュメントが再び変更された場合、このタイムアウトはリセットされます。
13. Ignore files greater than を選択すると、大きなファイルを無視して解析が速くなります。解析するファイルの最大サイズをチェックボックスの隣のフィールドに指定します。
14. Diagnostic configuration フィールドには、実行する Clang チェックが表示されます。実行するチェックを選択して編集するには、フィールドの値を選択します。
15. Add を選択すると、インデックス作成に単一の clangd プロセスを使用するセッションを選択できます。

Clangチェック

Diagnostic configuration フィールドの値を選択すると、Diagnostic Configurations ダイアログが開き、実行するチェックを選択および編集できます。

組み込みのチェックを使用するだけでなく、Copy を選択してコピーを作成し、ニーズに合わせてコピーを編集することもできます。

• Build-system warnings ビルド・システムによって指定された警告を表示します。
• Checks for questionable constructs は、-Wall と-Wextra のチェックを組み合わせて、簡単に回避できる疑問のある構文といくつかの追加問題をチェックします。

Clangのチェックは-W で始まります。各チェックには、-Wno で始まる否定バージョンもあります。

いくつかのオプションは他のオプションをオンにすることに注意してください。詳細については、警告を要求または抑制するオプション、またはGCCやClangのマニュアル・ページを参照してください。