ReSharper 2020.2 ヘルプ

コードインスペクション

ReSharper はサポートされているすべての言語で 2500 以上のインスペクションを提供します。これらのインスペクションは、開いているすべてのファイルで設計時にコードの課題を検出してハイライトするため、および / または特定の範囲内ですべてのコードの課題を見つけるために使用されます。

インスペクション ReSharper が提供するコードの種類を調べるには、異なる言語の ReSharper コードインスペクションの全リストをご覧ください。

コードインスペクションは、以下のグループに分類できます。

  • ReSharper 独自のコードインスペクションには以下が含まれます。

    • インスペクションは固定重大度 'Error' です。これらのインスペクションはコンパイラのエラーを検出し、無効化または設定する方法はありません。

    • 残りのコードの課題(たとえば、コンパイラの警告、ランタイムエラーと論理エラー、コードのにおい、冗長性、改善の提案など)を検出する、構成可能な重大度レベルを持つインスペクション。これらの構成可能なインスペクションは、ReSharper オプション(Alt+R O)のコードインスペクション | インスペクション重大度ページにあります。これらのインスペクションは、いくつかの方法で構成できます。コメントや属性で検出された課題を抑制したり、無効にしたり、設定または .editorconfig ファイルで重大度を変更したりできます。

  • カスタムコードインスペクションは、構造的検索および置換パターンとして定義され、構成可能な重大度レベルもあります。

コードインスペクションの重大度レベル

各 ReSharper コードインスペクションと構造検索および置換パターンには、次の重大度レベルのいずれかがあります。

エラー

デフォルトで「エラー」重大度レベルのコードインスペクションは、コードのコンパイルを妨げるか、実行時エラーを引き起こすコードの課題を対象としています。これらのインスペクションのほとんどは構成できません。つまり、無効にしたり、重大度レベルを変更したりすることはできません。

デザインタイムインスペクションでは、ReSharper は未解決シンボルを赤で表示します。

ReSharper: Design-time code inspection
間違ったステートメントやその一部に赤い波線の下線をハイライトします。
ReSharper: Design-time code inspection
現在のファイルに少なくとも 1 つのエラーがある場合、ステータスインジケーターエラー ThemedIcon ErrorStripeError Screen Gray png アイコンが表示され、マーカーバーにエラーごとに赤いマーカーが表示されます。

「エラー」重大度レベルのインスペクションで検出されたコードの課題は、ソリューション全体の分析が有効な場合はソリューションウィンドウのエラー / 警告に表示されます。

警告

この重大度レベルは、コンパイラの警告、およびコードのコンパイルを妨げないが、それでも深刻なコーディングの非効率性を表す可能性があるその他の課題に対応しています。例:ReSharper は、冗長な型キャストまたは名前空間インポートディレクティブ、誤ったフォーマット文字列、宣言されているが使用されていないローカル変数またはプライベートフィールド、未使用のプライベートメソッドなどについて通知します。

デザインタイムインスペクションでは、ReSharper は灰色のテキストで冗長記号を表示します。

ReSharper: Design-time code inspection
文またはその一部を青い波の下線でハイライト表示します。
ReSharper: Design-time code inspection
現在のファイルに少なくとも 1 つの警告がある場合、ステータスインジケータには警告 ThemedIcon ErrorStripeWarning Screen Gray png アイコンが表示され、マーカーバーには警告ごとに黄色のマーカーが表示されます。

警告付きのソリューション全体の分析が有効になっていると、ソリューションウィンドウのエラー / 警告にも警告が表示されます

提案

この重大度レベルのコードの課題は、コード構造のインサイトを提供し、必ずしも悪いことではないが間違っていることに注意を喚起しますが、おそらく知っておくと便利です。

たとえば、' パラメーターは基本型で宣言できます。' ということは、パラメーターの基本型のメンバーのみを使用することを意味します。これは、実際のパラメータータイプの詳細を考慮しなかったなど、異なるエラーを示す可能性があります。この知識に基づいて、パラメーターのタイプを変更したい場合もあれば、そうでない場合もあります。

デザインタイムインスペクションでは、ReSharper は緑色の波線の下線付きの提案をハイライトしています。

ReSharper: Design-time code inspection
マーカーバーに各警告の緑のマーカーを追加します。

ヒント

これは最も低い重大度です。この重大度のコードの課題は、特定のコードの詳細に注意を促し、改善方法を推奨します。

デザインタイムインスペクションでは、ReSharper は対応するシンボルの最初の 2 文字に点線の緑の下線を追加してヒントをハイライトします。

ReSharper: Design-time code inspection
エラー、警告、提案とは異なり、エディターコードの課題間移動するときのヒントは考慮されず、マーカーバーにも表示されません。

ハイライトされたヒントにキャレットを設定すると、ポップアップは表示されず、対応するメッセージがステータスバーにのみ表示されることに注意してください。

ほとんどのコードインスペクション(コンパイラエラーを検出するものを除く)の重大度レベルは変更できます。つまり、必要に応じて各コードインスペクションの重大度レベルを定義できます。

特定の範囲のコードをインスペクションすると、ReSharper は検出された課題に対応するアイコンを追加し、インスペクション結果ウィンドウの重要度レベルで課題を分類することを許可します。

コードインスペクションのカテゴリ

ReSharper は、構成可能なコードインスペクションをいくつかのカテゴリ別にグループ化します。これらのカテゴリは、インスペクションの目的とそれらが検出するコードの課題の種類を大まかに定義します。カテゴリは、ReSharper オプション(Alt+R O)のコードインスペクション | インスペクション重大度ページでコードインスペクションをグループ化し、特定のスコープで検出されてインスペクション結果ウィンドウに表示されるコードの課題をグループ化するために使用されます。

  • 潜在的なコード品質課題
    このカテゴリには、主にエラーまたは警告レベルで重大な課題(コードのにおい)を検出するインスペクションが含まれます。このカテゴリには、ローカライゼーションの支援を確実にするインスペクションも含まれます。

  • 一般的なプラクティスとコードの改善
    このカテゴリは、主にコードの可読性に影響する中程度の重大度の課題を探すインスペクションをグループ化します。

  • コードの冗長性
    このカテゴリのコードインスペクションは、コードの可読性とスタイルに影響を与える冗長性とデッドコードを探し、安全に削除できます。一部のコードの冗長性は自動的に修正できず、それらのクイックフィックスはインタラクティブモードで実行され、ユーザー入力が必要です。ただし、冗長性の大部分は、スコープ内の修正またはコードのクリーンアップを使用して、ユーザーの操作なしで修正できます。

  • 言語使用の機会
    このカテゴリにはコードインスペクションが含まれており、そのほとんどが提案の重大度レベルを持ちます。これは、より高度な言語構造を使用できる場合に通知します。これらのインスペクションは古い言語バージョンの構文を検出し、より新しい言語バージョンの機能の使用を提案します。サポートされているほとんどの言語では、言語バージョンを自動的に検出するか、手動で設定できます

  • コード通知
    このカテゴリは、マイナーな重大度レベルのコードインスペクションをグループ化します。

  • コードスタイル
    このカテゴリのインスペクションは、コード構文スタイルの違反を検出します。他のほとんどのコードインスペクションとは対照的に、これらのインスペクションは、ReSharper オプション(Alt+R O)のコード編集 | [ 言語 ] | 構文スタイルページで構成された対応するコードスタイルルールに応じて、コードの課題と同じコード構造を検出するか、検出しません。コードクリーンアップを使用して、これらのインスペクションが検出した課題を修正することもできます。

  • 制約違反
    このカテゴリにはコードインスペクションが含まれ、主に警告の重大度レベルがあり、ReSharper のコード注釈などのシンボル属性に関連する違反やその他の同様の課題が検出されます。

  • シンボル宣言の冗長性
    このカテゴリにはコードインスペクションが含まれ、ほとんどが警告の重大度レベルを持ち、空の未使用のシンボル宣言を検出します。

  • コンパイラの警告
    このカテゴリのインスペクションは、コンパイルする前にコンパイラの警告を検出します。

  • スペルの課題
    これらのインスペクションは、さまざまな状況でタイプミスを検出します。

  • 実行不可能なテスト
    これらのインスペクションは、実行できないテストを検出します。

  • NUnit
    これらのインスペクションは、NUnit テストに関連するコードの課題を検出します。

  • Xunit
    これらのインスペクションは、xUnit.Net テストに関連するコードの課題を検出します。

  • フォーマット
    このカテゴリのインスペクションは、コードコードのフォーマットの問題を検出します。

  • Clang-Tidy チェック
    このカテゴリのインスペクションは、ReSharper と統合された強力なオープンソースコード分析ツールである Clang-Tidy(英語) によって提供されます。

  • Clang
    このカテゴリのインスペクションは、ReSharper に統合された Clang コンパイラの警告に対応しています。

  • Clang スタティックアナライザチェック
    このカテゴリのインスペクションは、ReSharper と統合された Clang Static Analyzer からの診断です。
    静的アナライザーのチェックはすべて有効にすると Clang-Tidy の速度が大幅に低下するため、デフォルトでは無効になっています。

  • Unreal Engine
    このカテゴリのインスペクションは、Unreal Engine(英語) プロジェクトの C++ コードに固有です。

構成可能コードインスペクションの識別子

構成可能な各コードインスペクションには、構成に使用できる 2 つの固有の識別子があります。例として可能性のある 'System.NullReferenceException' インスペクションを考えてみましょう:

  • インスペクション ID は、コメントでインスペクションを抑制するために使用されます。

    // ReSharper disable once PossibleNullReferenceException
    単一の課題または
    // ReSharper disable PossibleNullReferenceException
    ファイルの終わりまで
    または属性付き —
    [SuppressMessage("ReSharper", "PossibleNullReferenceException")]
    .

  • インスペクション EditorConfig プロパティを使用してインスペクション .editorconfig ファイルからを構成することができます。例:インスペクションの重大度レベルをエラーに変更するには、次の行を使用します。

    resharper_possible_null_reference_exception_highlighting=error

コードインスペクション索引の中で各々の構成可能なインスペクションのための識別子を見つけることができます - ただ言語ページを選んで、それから望ましいインスペクションの詳細を見つけるためにブラウザ検索を使うこと。

構成可能なコードインスペクションのリスト

最終更新日 :

関連ページ:

設計時にコードの課題を検出する

ReSharper は、エディターでコードファイルを開くとすぐに分析を開始し、最後まで編集を続けます。検出されたすべてのコードの課題は、重大度に従ってエディターでハイライトされます。課題のマップは、エディターウィンドウの右側のマーカーバーにも表示されます。ここでは、ファイルのステータスを即座に確認し...

特定の範囲でコードの課題を見つける

設計時コードインスペクションは、エディターでコーディングしたり、特定のファイルを見直したりするときに役立ちます。ただし、ReSharper を使用すると、ソリューション全体または狭い範囲でスタティックコード分析を実行し、結果をフレンドリーな視点で調べることもできます。必要に応じてインスペクション結果...

コードインスペクション索引

このセクションでは、ReSharper のすべてのプロプライエタリコードインスペクションを確認できます。これらのコードのいずれかを無効にしたり、重大度を変更したりできます。これらのコードインスペクションは、開いているすべてのファイルの設計時にコードの課題を検出できます。さらに、特定のスコープでコード...

アクションインジケータとアクションリスト

ReSharper が Visual Studio テキストエディターに追加する最も注目すべきものには、アクションインジケータとアクションリストがあります。これらは、ReSharper でサポートされるすべてのファイル(C#、VB.NET、XML、CSS、JavaScript、ASP.NET など)...

コードインスペクション設定の構成

コード注釈を使用して、ReSharper がコードをインスペクションする方法をカスタマイズすることもできます。設計時コードインスペクションを構成する :デフォルトでは、ReSharper は、サポートされている言語に対応するすべてのファイルで設計時コードインスペクションを有効にします。必要に応じて、...

カスタムコードインスペクションとクイックフィックスを作成する

コードに課題または悪い習慣があるが、ReSharper がそれを検出しない場合は、カスタムコードインスペクションを作成することができます。さらに、課題のあるコードを置き換えるコード、つまりカスタムクイックフィックスを指定することができます。カスタムインスペクションが正しく作成されていれば、コードベー...