.NET

すべての Qodana リンターは、特定のプログラミング言語とフレームワーク用に設計された JetBrains IDE に基づいています。.NET プロジェクトを分析するには、次の Qodana リンターを使用できます。

特性	説明
リンター名	`qodana-dotnet`
Docker イメージ	`jetbrains/qodana-dotnet:2026.1<-privileged>` *
ベースとなるもの	JetBrains Rider
ライセンスに基づいて利用可能	Ultimate および Ultimate Plus ライセンス
発送方法	ネイティブソリューションと Docker イメージ
サポートされる言語	C#、C/C++(英語)、VB.NET、JavaScript、TypeScript、F#

特性	説明
リンター名	`qodana-cdnet`
Docker イメージ	`jetbrains/qodana-cdnet:2026.1-eap<-privileged>` *
ベースとなるもの	JetBrains ReSharper
ライセンスに基づいて利用可能	コミュニティライセンス
発送方法	Docker イメージ
サポートされる言語	C#、C/C++(英語)、VB.NET

* オプションの -privileged タグを使用すると、Qodana を特権モードで実行し、ルートアクセスを必要とするコマンドを実行できます。この場合、Qodana にはデフォルトで qodana ユーザーが付属しており、このユーザーはルート権限を持ち、パスワードは不要です。

機能マトリックスに移動すると、プログラミング言語やその他のサポートされているテクノロジー別にこれらのリンターを比較できます。

始める前に

Qodana クラウド

リンターを実行するには、ライセンスの識別と検証のために Qodana が使用するプロジェクトトークンを取得する必要があります。

Qodana クラウド(英語)に移動して、そこでアカウントを作成します。
Qodana Cloud で、組織、チーム、プロジェクトを作成します。
プロジェクトカードには、このセクションで後で使用するプロジェクトトークンが記載されています。

プロジェクトトークンは、Qodana for .NET リンターでは必須ですが、Qodana Community for .NET リンターではオプションです。

SDK バージョン

プロジェクトが .NET フレームワークまたは OS 固有の TFM をターゲットとしている場合、この場合の唯一のオプションは、ネイティブモードで .NET リンター用の Qodana を実行することです。

Qodana for .NET をネイティブモードで実行する場合は、Rider がアクセスできるように、オペレーティングシステムのデフォルトの場所に SDK をインストールする必要があります。

Qodana for .NET の Dockerized バージョンでは、SDK のバージョン 8.0, 9.0, 10.0 が提供されます。

すべての SDK バージョンは、Qodana コンテナーファイルシステムの /usr/share/dotnet/sdk ディレクトリに保存されます。

プロジェクトで異なるバージョンの SDK が必要な場合は、qodana.yaml ファイルの bootstrap キーを使用して設定できます。例: このコマンドは、global.json ファイルで指定され、プロジェクトのルートにある必要なバージョンの SDK をインストールします。

    bootstrap: curl -fsSL https://dot.net/v1/dotnet-install.sh |
      bash -s -- --jsonfile /data/project/global.json -i /usr/share/dotnet

ソフトウェアを準備する

これは、このセクションのソフトウェアを Qodana 分析用に構成する方法を示しています。すべての構成サンプルはプロジェクトトークンを使用します。詳細については、Qodana クラウドセクションを参照してください。

GitHub UI の設定タブで、QODANA_TOKEN 暗号化シークレット(英語)を作成し、その値としてプロジェクトトークンを保存します。

Jenkins で、次のプラグインが稼働していることを確認します。
- Docker イメージを実行するには、Docker(英語) および Docker パイプライン(英語)が必要です
- Jenkins プロジェクトでの git 操作には git (英語) が必要です
Docker がインストールされており、Jenkins からアクセスできることを確認します。
該当する場合は、Docker ドキュメントの Docker を非 root ユーザーとして管理する(英語)セクションの説明に従って、jenkins ユーザーが Docker にアクセスできることを確認してください。
Jenkins で、qodana-token 資格情報(英語)を作成し、プロジェクトトークンをその値として保存します。
Jenkins で、Jenkins ドキュメントポータル(英語)の説明に従ってマルチブランチパイプラインプロジェクトを作成します。

プロジェクトリポジトリが GitLab CI/CD からアクセスできることを確認します。
GitLab CI/CD UI で QODANA_TOKEN 環境変数を作成し、プロジェクトトークンをその値として保存します。

Qodana for .NET リンターを実行する場合は、TeamCity でプロジェクトとビルド構成を作成します。

Qodana を実行するマシンに Docker をインストールします。

Linux を使用している場合は、現在の非 root ユーザー(英語)で Docker を実行できるはずです。

GitHub の Qodana CLI(英語) ページの指示に従ってください。

次のコマンドを実行して、Qodana for .NET または Qodana Community for .NET リンターの Docker イメージを取得します。

docker pull qodana-dotnet<-privileged>

docker pull qodana-cdnet<-privileged>

privileged タグを使用すると、ルートアクセスを必要とするコマンドを実行できます。この場合、Qodana には、ルート権限を持ち、パスワードを必要としないデフォルトの qodana ユーザーが付属しています。

プロジェクトのビルド

Qodana が分析する前にプロジェクトをビルドすることをお勧めします。ビルドするには、プロジェクトディレクトリに含まれる qodana.yaml ファイルの bootstrap キーを使用できます。これは、ソースジェネレーターを使用する場合に特に推奨されます。

プロジェクトのビルドが失敗すると、コード分析を実行できません。

Qodana Community for .NET リンターは、分析の前にデフォルトでプロジェクトをビルドします。カスタムビルドを実行する場合は、--no-build Qodana オプションを使用します。

このワークフロー構成を使用して、--no-build オプションを呼び出します。

                    name: Qodana
                    on:
                      workflow_dispatch:
                      pull_request:
                      push:
                        branches: # Specify your branches here
                          - main # The 'main' branch
                          - 'releases/*' # The release branches
                    jobs:
                      qodana:
                        runs-on: ubuntu-latest
                        permissions:
                          contents: write
                          pull-requests: write
                          checks: write
                        steps:
                          - uses: actions/checkout@v3
                            with:
                              ref: ${{ github.event.pull_request.head.sha }}  # to check out the actual pull request commit, not the merge commit
                              fetch-depth: 0  # a full history is required for pull request analysis
                          - name: 'Qodana Scan'
                            uses: JetBrains/qodana-action@v2026.1
                            with:
                                args: --no-build
                            env:
                              QODANA_TOKEN: ${{ secrets.QODANA_TOKEN }}
                

プロジェクトリポジトリのルートディレクトリで、この構成を Jenkinsfile に保存します。

                    pipeline {
                        environment {
                            QODANA_TOKEN=credentials('qodana-token')
                        }
                        agent {
                            docker {
                                args '''
                                  -v "${WORKSPACE}":/data/project
                                  --entrypoint=""
                                  '''
                                image 'qodana-cdnet<-privileged>'
                            }
                        }
                        stages {
                            stage('Qodana') {
                                steps {
                                    sh '''
                                    qodana \
                                    --no-build
                                    '''
                                }
                            }
                        }
                    }
                

                include:
                   - component: $CI_SERVER_FQDN/qodana/qodana/qodana-gitlab-ci@v2026.1
                     inputs: # Uncomment the Docker image that you would like to use
                        # image: jetbrains/qodana-dotnet:2026.1
                        # image: jetbrains/qodana-cdnet:2026.1-eap
                        args: --no-build
                

                          qodana scan \
                             -e QODANA_TOKEN="<cloud-project-token>" \
                             jetbrains/qodana-cdnet:2026.1-eap<-privileged> \
                             --no-build
                        

                          docker run \
                             -v <source-directory>/:/data/project/ \
                             -e QODANA_TOKEN="<cloud-project-token>" \
                             jetbrains/qodana-cdnet:2026.1-eap<-privileged> \
                             --no-build
                        

Qodana の実行

基本的な使用例

Qodana for .NET リンターは、次の 2 つのモードで実行できます。

ネイティブモードは、Docker コンテナーを使用せずにリンターを実行できる、.NET リンター用の Qodana を実行するための推奨方法です。
Docker モードは、.NET リンター用の Qodana の Docker コンテナーを使用する代替手段です。

--linter および --within-docker オプションを使用してネイティブモードを構成できます。

main、ブランチ、リリースブランチ、リポジトリに届くプルリクエストをネイティブモードで分析するには、GitHub UI のアクションタブで新しいワークフローを設定し、次のワークフロー構成を .github/workflows/code_quality.yml ファイルに保存します。

                                name: Qodana
                                on:
                                  workflow_dispatch:
                                  pull_request:
                                  push:
                                    branches: # Specify your branches here
                                      - main # The 'main' branch
                                      - 'releases/*' # The release branches
                                jobs:
                                  qodana:
                                    runs-on: ubuntu-latest
                                    permissions:
                                      contents: write
                                      pull-requests: write
                                      checks: write
                                    steps:
                                      - uses: actions/checkout@v3
                                        with:
                                          ref: ${{ github.event.pull_request.head.sha }}  # to check out the actual pull request commit, not the merge commit
                                          fetch-depth: 0  # a full history is required for pull request analysis
                                      - name: 'Qodana Scan'
                                        uses: JetBrains/qodana-action@v2026.1
                                        with:
                                            args: | 
                                                --linter qodana-dotnet
                                                --within-docker false
                                        env:
                                          QODANA_TOKEN: ${{ secrets.QODANA_TOKEN }}
                            

プロジェクトのルートディレクトリで次のコマンドを実行します。

                        qodana scan \
                           --linter qodana-dotnet \
                           --within-docker false
                    

Qodana for .NET リンターには Docker モードが用意されていますが、ネイティブモードを使用することをお勧めします。

                                name: Qodana
                                on:
                                  workflow_dispatch:
                                  pull_request:
                                  push:
                                    branches: # Specify your branches here
                                      - main # The 'main' branch
                                      - 'releases/*' # The release branches
                                jobs:
                                  qodana:
                                    runs-on: ubuntu-latest
                                    permissions:
                                      contents: write
                                      pull-requests: write
                                      checks: write
                                    steps:
                                      - uses: actions/checkout@v3
                                        with:
                                          ref: ${{ github.event.pull_request.head.sha }}  # to check out the actual pull request commit, not the merge commit
                                          fetch-depth: 0  # a full history is required for pull request analysis
                                      - name: 'Qodana Scan'
                                        uses: JetBrains/qodana-action@v2026.1
                                        env:
                                          QODANA_TOKEN: ${{ secrets.QODANA_TOKEN }}
                            

プロジェクトリポジトリのルートディレクトリに、次の構成を含む Jenkinsfile を保存します。

                        pipeline {
                            environment {
                                QODANA_TOKEN=credentials('qodana-token')
                            }
                            agent {
                                docker {
                                    args '''
                                      -v "${WORKSPACE}":/data/project
                                      --entrypoint=""
                                      '''
                                    image 'jetbrains/qodana-dotnet:2026.1'
                                }
                            }
                            stages {
                                stage('Qodana') {
                                    steps {
                                        sh '''qodana'''
                                    }
                                }
                            }
                        }
                    

プロジェクトのルートディレクトリに .gitlab-ci.yml を作成し、そこに次の構成を保存します。

                        include:
                           - component: $CI_SERVER_FQDN/qodana/qodana/qodana-gitlab-ci@v2026.1
                             inputs: 
                                image: jetbrains/qodana-dotnet:2026.1
                    

TeamCity UI で、Qodana を実行するビルドの構成ページに移動します。
ビルド設定ページで、ビルドステップページに移動します。
ビルドステップページで、ビルドステップを追加ボタンをクリックしてください。
開いたページで、Qodana ランナーを選択します。
新しいビルドステップ: Qodana ページで、高度なオプションを表示をクリックし、Qodana ランナーを構成します。
- ステップ名は、他のビルドステップの中でこのステップを一意に識別します。
- ステップ ID は、他のビルドステップの中でこのステップを一意に識別します。
- ステップ実行は、このビルドステップをトリガーするビルド条件を構成します。
- 作業ディレクトリはビルドプロセスのディレクトリを設定します。詳細については、TeamCity のドキュメントを参照してください。バージョン管理設定タブで Checkout directory パラメーターが指定されている場合は、このフィールドを空のままにすることができます。
- レポート ID はレポートを一意に識別し、単一のビルド内で複数の分析ステップが構成されている場合に複数のレポートを区別できるようにします。
- レポートを TeamCity テストに転送するチェックボックスは、TeamCity UI の「テスト」タブで Qodana レポートの可用性を構成します。このオプションを使用すると、検出された他の問題とともにコードベースの問題を表示できます。
- リンターは Qodana リンターを構成します。
  ここで、.NET リンターの Qodana を選択します。
- バージョンはデフォルトで Latest に設定されています。
- インスペクションプロファイル: はインスペクションプロファイルを定義します:
  - qodana.starter (default) はデフォルトプロファイルの 1 つです。
  - Profile name ではプロファイルを指定できます。詳細については、既存の Qodana プロファイルセクションを参照してください。
  - Profile path を使用すると、カスタムプロファイルへのパスを指定できます。このオプションを使用するには、 qodana.yaml ファイルでもカスタムプロファイルを構成する必要があります。
- クラウドトークンは、Qodana Cloud で生成されたプロジェクトトークンを構成します。
- 追加の Docker 引数は、Docker イメージによって受け入れられる引数を設定します。詳細については、構成オプションセクションを参照してください。
- 追加の Qodana 引数を使用すると、デフォルトの Qodana 機能を拡張できます。詳細については、オプションの種類セクションを参照してください。
- Qodana CLI バージョンでは、使用する Qodana CLI(英語) バージョンを指定できます。
保存ボタンをクリックしてください。

source-directory がプロジェクトのルートを指し、QODANA_TOKEN がプロジェクトトークンを参照して、ローカル分析を開始します。

                        docker run \
                           -v <source-directory>/:/data/project/ \
                           -e QODANA_TOKEN="<cloud-project-token>" \
                           jetbrains/qodana-dotnet:2026.1
                    

Rider で、ツール | Qodana | Qodana でコード解析を試すに移動します。
Qodana の実行ダイアログでは、次の設定を行うことができます。
- Qodana で使用され、 qodana.yaml ファイルで設定されるオプション
- プロジェクトトークンを使用した分析結果を Qodana クラウドに送信するオプション
- Qodana をベースラインで実行するための Qodana 解析ベースラインの使用オプション
実行をクリックしてコードを分析してください。
Qodana ツールウィンドウについては、Qodana レポートの概要のセクションを参照してください。

以下の例に示すように、Qodana Community for .NET リンターを Docker モードで実行できます。

                                name: Qodana
                                on:
                                  workflow_dispatch:
                                  pull_request:
                                  push:
                                    branches: # Specify your branches here
                                      - main # The 'main' branch
                                      - 'releases/*' # The release branches
                                jobs:
                                  qodana:
                                    runs-on: ubuntu-latest
                                    permissions:
                                      contents: write
                                      pull-requests: write
                                      checks: write
                                    steps:
                                      - uses: actions/checkout@v3
                                        with:
                                          ref: ${{ github.event.pull_request.head.sha }}  # to check out the actual pull request commit, not the merge commit
                                          fetch-depth: 0  # a full history is required for pull request analysis
                                      - name: 'Qodana Scan'
                                        uses: JetBrains/qodana-action@v2026.1
                                        env:
                                          QODANA_TOKEN: ${{ secrets.QODANA_TOKEN }}
                            

プロジェクトリポジトリのルートディレクトリで、このスニペットを Jenkinsfile に保存します。

                        pipeline {
                            environment {
                                QODANA_TOKEN=credentials('qodana-token')
                            }
                            agent {
                                docker {
                                    args '''
                                      -v "${WORKSPACE}":/data/project
                                      --entrypoint=""
                                      '''
                                    image 'jetbrains/qodana-cdnet:2026.1-eap'
                                }
                            }
                            stages {
                                stage('Qodana') {
                                    steps {
                                        sh '''qodana'''
                                    }
                                }
                            }
                        }
                    

プロジェクトのルートディレクトリに .gitlab-ci.yml を作成し、そこに次の構成を保存します。

                        include:
                           - component: $CI_SERVER_FQDN/qodana/qodana/qodana-gitlab-ci@v2026.1
                             inputs:
                                image: jetbrains/qodana-cdnet:2026.1-eap
                    

source-directory がプロジェクトのルートを指し、QODANA_TOKEN がプロジェクトトークンを参照して、ローカル分析を開始します。

                        docker run \
                           -v <source-directory>/:/data/project/ \
                           -e QODANA_TOKEN="<cloud-project-token>" \
                           jetbrains/qodana-cdnet:2026.1-eap
                    

Rider で、ツール | Qodana | Qodana でコード解析を試すに移動します。
Qodana の実行ダイアログでは、次の設定を行うことができます。
- Qodana によって使用され、 qodana.yaml ファイルによって構成されるオプション。
- プロジェクトトークンを使用する分析結果を Qodana クラウドに送信するオプション。
- ベースラインを使用して Qodana を実行するための Qodana 解析ベースラインの使用オプション。
コードを分析するには、実行をクリックします。
Qodana ツールウィンドウで、分析レポートを参照してください。

特定のソリューションを分析する

デフォルトでは、Qodana は単一のソリューションファイルを見つけて使用しようとしますが、ソリューションファイルが存在しない場合はプロジェクトファイルを見つけようとします。プロジェクトに複数のソリューションファイルが含まれている場合は、以下に示すように正確なファイル名を指定する必要があります。

ソリューションはさまざまな方法で指定できます。YAML 構成を使用するのが最も便利な方法です。一度構成すれば、その構成を Qodana を実行するすべてのソフトウェアで使用できるからです。あるいは、Docker オプションを使用することもできます。

プロジェクトルートからソリューションファイルへの相対パスを指定します。

                    dotnet:
                      solution: <relative-path-to-solution-file>
                

プロジェクトにソリューションファイルがなく、複数のプロジェクトファイルが含まれている場合は、プロジェクトファイルを使用する必要があります。

                    dotnet:
                      project: <relative-path-to-project-file>
                

Qodana for .NET リンターは --property オプションを使用し、Qodana Community for .NET リンターは --solution および --project オプションを使用してソリューションファイルへのパスを指定します。

                      docker run \
                         -v <source-directory>/:/data/project/ \
                         -e QODANA_TOKEN="<cloud-project-token>" \
                         jetbrains/qodana-dotnet:2026.1<-privileged> \
                         --property=qodana.net.solution=<relative-path-to-solution-file>
                    

                      docker run \
                         -v <source-directory>/:/data/project/ \
                         -e QODANA_TOKEN="<cloud-project-token>" \
                         jetbrains/qodana-cdnet:2026.1-eap<-privileged> \
                         --solution=<relative-path-to-solution-file>
                    

プロジェクトにソリューションファイルがなく、複数のプロジェクトファイルが含まれている場合は、--property および --project オプションを使用してプロジェクトファイルを使用する必要があります。

                            docker run \
                               -v <source-directory>/:/data/project/ \
                               -e QODANA_TOKEN="<cloud-project-token>" \
                               jetbrains/qodana-dotnet:2026.1<-privileged> \
                               --property=qodana.net.project=<relative-path-to-project-file>
                        

                            docker run \
                               -v <source-directory>/:/data/project/ \
                               -e QODANA_TOKEN="<cloud-project-token>" \
                               jetbrains/qodana-cdnet:2026.1-eap<-privileged> \
                               --project=<relative-path-to-project-file>
                        

ソリューション構成は、ソリューション内のどのプロジェクトをビルドするか、およびソリューション内の特定のプロジェクトにどのプロジェクト構成を使用するかを定義します。

すべてのソリューションには、以下に示すように使用できる Debug および Release 構成が含まれています。

qodana.yaml ファイルで現在のソリューションの構成を切り替えることができます。

                    dotnet:
                      configuration: Release
                

デフォルトでは、ソリューションプラットフォームは Any CPU に設定されていますが、これを上書きできます。例:

                    dotnet:
                      platform: x86
                

--property および --configuration オプションを使用して構成を適用できます。

                            docker run \
                               -v <source-directory>/:/data/project/ \
                               -e QODANA_TOKEN="<cloud-project-token>" \
                               jetbrains/qodana-dotnet:2026.1<-privileged> \
                               --property=qodana.net.configuration=Release
                        

                            docker run \
                               -v <source-directory>/:/data/project/ \
                               -e QODANA_TOKEN="<cloud-project-token>" \
                               jetbrains/qodana-cdnet:2026.1-eap<-privileged> \
                               --configuration=Release
                        

デフォルトでは、ソリューションプラットフォームは Any CPU に設定されていますが、次のようにオーバーライドできます。

                            docker run \
                               -v <source-directory>/:/data/project/ \
                               -e QODANA_TOKEN="<cloud-project-token>" \
                               jetbrains/qodana-dotnet:2026.1<-privileged> \
                               --property=qodana.net.platform=x86
                        

                            docker run \
                               -v <source-directory>/:/data/project/ \
                               -e QODANA_TOKEN="<cloud-project-token>" \
                               jetbrains/qodana-cdnet:2026.1-eap<-privileged> \
                               --platform=x86
                        

プライベート NuGet リポジトリ

リンターに応じて、以下に示すようにプライベート NuGet リポジトリを使用して Qodana を実行できます。

プライベート NuGet リポジトリを使用して Qodana for .NET を実行する場合、このリンターのネイティブモードの実行が推奨されます。この場合、依存関係は基本的に Qodana の実行前のステップで復元されます。例:

                name: Qodana
                on:
                  workflow_dispatch:
                  pull_request:
                  push:
                 
                jobs:
                    qodana:
                        runs-on: ubuntu-latest
                        permissions:
                            contents: write
                            pull-requests: write
                            checks: write
                        steps:
                            - uses: actions/checkout@v3
                              with:
                                ref: ${{ github.event.pull_request.head.sha }}
                                fetch-depth: 0
                            - name: Setup .NET
                              uses: actions/setup-dotnet@v4
                              with:
                                  dotnet-version: '8.x' # or your version
                             
                            - name: Add NuGet source
                              run: |
                                dotnet nuget add source ${{ secrets.QODANA_NUGET_URL }} \
                                  --name MyPrivateFeed \
                                  --username ${{ secrets.QODANA_NUGET_USER }} \
                                  --password ${{ secrets.QODANA_NUGET_PASSWORD }} \
                                  --store-password-in-clear-text
                             
                            - name: Restore dependencies
                              run: dotnet restore
                             
                             - name: 'Qodana Scan'
                              uses: JetBrains/qodana-action@main
                              env:
                                QODANA_TOKEN: ${{ secrets.QODANA_TOKEN }}
                              with:
                                upload-result: true
                

Docker モードで、以下の設定を qodana.yaml ファイルに保存してください。

                    bootstrap: |
                      dotnet new nugetconfig --force
                      dotnet nuget add source -u $QODANA_NUGET_USER -p $QODANA_NUGET_PASSWORD --store-password-in-clear-text -n PrivateFeed $QODANA_NUGET_URL --configfile nuget.config
                    # If you already have nuget.config in your repository, you can use instead:
                    # dotnet nuget update source &ltfeed-name> -u $QODANA_NUGET_USER -p $QODANA_NUGET_PASSWORD --store-password-in-clear-text --configfile nuget.config
                

以下は、Qodana を Docker モードで実行する方法を示す設定例です。

                name: Qodana
                    on:
                      workflow_dispatch:
                      pull_request:
                      push:
                     
                    jobs:
                      qodana:
                        runs-on: ubuntu-latest
                        permissions:
                          contents: write
                          pull-requests: write
                          checks: write
                        steps:
                          - uses: actions/checkout@v3
                            with:
                              ref: ${{ github.event.pull_request.head.sha }}
                              fetch-depth: 0
                           
                          - name: 'Qodana Scan'
                            uses: JetBrains/qodana-action@main
                            env:
                              QODANA_TOKEN: ${{ secrets.QODANA_TOKEN }}
                              QODANA_NUGET_URL: ${{ secrets.QODANA_NUGET_URL }}
                              QODANA_NUGET_USER: ${{ secrets.QODANA_NUGET_USER }}
                              QODANA_NUGET_PASSWORD: ${{ secrets.QODANA_NUGET_PASSWORD }}
                            with:
                              upload-result: true
                

プロジェクトを分析する前に、nuget.config ファイルに資格情報を追加します。これは、次のコマンドを使用して NuGet ソース更新を実行できます。

            -Name "MySourceName” -username "User" -password "Password" -configFile "pathToNugetConfigInRepo"
        

依存関係を解決できない場合は、Qodana を実行する前に次の手順を構成します。

dotnet restore コマンドを使用して依存関係を復元する
すべての依存ファイルを Qodana がアクセスできるディレクトリにコピーします。例: これはキャッシュディレクトリ内のサブディレクトリでも構いません。

分析レポートを参照する

以下に説明するように、Qodana Cloud から最新の Qodana レポートを IDE に読み込むことができます。

IDE で、ツール | Qodana | Qodana にログインに移動します。
設定ダイアログで、ログインをクリックします。
これにより、認証ページにリダイレクトされます。
ローカルプロジェクトをリンクする Qodana クラウドプロジェクトを選択します。
常に最も関連性の高い Qodana レポートをロードするオプションをチェックすると、Qodana クラウドから最も実際的で関連性の高いレポートを受け取ることができます。
この場合、IDE は、現在のリビジョン ID (HEAD) に対応するリビジョン ID を持つレポートを Qodana Cloud から検索して取得します。このレポートが見つからない場合、IDE は、現在のリビジョン ID (HEAD) に最も近いリビジョンを持つ以前のレポートを選択します。それ以外の場合、IDE は、Qodana Cloud から利用可能な最新のレポートを取得します。
問題ツールウィンドウの Qodana タブで、分析レポートを参照してください。

Qodana がプロジェクトを分析し、分析レポートを Qodana クラウドにアップロードしたら、Qodana クラウド(英語)でプロジェクトに移動して内容を確認してください。

Qodana レポート UI の詳細については、「分析レポート」セクションを参照してください。

構成を拡張する

分析範囲の調整

Qodana は、すぐに使用できる状態で、GitHub(英語) でホストされる 2 つの定義済みプロファイルを提供します。qodana.starter プロファイルはデフォルトのプロファイルであり、より包括的な qodana.recommended プロファイルのサブセットです。このプロファイルは、CI/CD パイプラインでの実行に適しており、デフォルトの Rider プロファイルをほぼ実装しています。

Qodana for .NET は、プロジェクトのルートディレクトリにある qodana.yaml ファイルから構成を読み取ります。例: qodana.recommended インスペクションプロファイルを使用してリンターを実行するには、次の構成を追加します。

                version: "1.0"
                profile:
                    name: qodana.recommended
            

Roslyn アナライザーを使用してコードを分析できます。各アナライザーは個別のインスペクションとして扱われます。これは実験的な機能であるため、自己責任で使用してください。

Roslyn アナライザーを無効にするには、qodana.yaml ファイルを使用して Qodana プロファイルを設定します。例:

                name: "Custom profile"
                 
                baseProfile: qodana.starter
                 
                groups: # List of configured groups
                - groupId: InspectionsToExclude
                  groups:
                    - "category:C#/Roslyn Analyzers"
                 
                inspections: # Group invocation
                - group: InspectionsToExclude
                  enabled: false # Disable the InspectionsToExclude group
            

設定例は GitHub (英語) で入手できます。

Rider インスペクションプロファイルを介したコード分析の構成に慣れている場合は、プロファイルをマッピングすることで既存のプロファイルへの参照を渡すことができます。

                docker run \
                   -v $(pwd):/data/project/ \
                   -v $(pwd)/.qodana/<inspection-profile.xml>:/data/project/myprofiles/<inspection-profile.xml> \
                   -e QODANA_TOKEN="<cloud-project-token>" \
                   jetbrains/qodana-dotnet:2026.1<-privileged> \
                   --profile-path /data/project/myprofiles/<inspection-profile.xml>
            

以前に ReSharper を使用してターゲットソリューションに取り組んだことがある場合は、コードインスペクション設定がすでに構成されている可能性があります。その場合、InspectCode は .DotSettings ファイルでカスタム設定を見つけて適用します。設定ファイルがない場合、すべての分析でデフォルトの重大度レベルが使用されます。コードインスペクションのカスタム重大度レベルに加えて、InspectCode は .DotSettings ファイルで次の設定を検索します。

ソリューション全体の分析が有効かどうか。
命名ルール (これは .DotSettings ファイルを使用してのみ構成できます)。
コード分析から除外されたファイル、フォルダー、ファイルマスク。
コード分析が部分的に無効になっている、生成コードを含むファイル、ファイルマスク、領域 (これは .DotSettings ファイルを使用してのみ構成できます)。
コード分析エンジンがキャッシュを保存する場所。ReSharper オプションの環境 | 一般ページで指定できます。
対象言語（ReSharper | オプション | 環境 | 製品 — 特長）。

CI サーバー上で InspectCode を構成するには、ReSharper を使用してすべての構成をローカルで行い、設定をソリューションチーム共有レイヤーに保存してから、ソリューションディレクトリ内の結果の YourSolution.sln.DotSettings ファイルを VCS にコミットします。サーバー上の InspectCode はこれらの設定を見つけて適用します。

デフォルトでは、InspectCode はターゲットソリューションで Roslyn アナライザーも実行します。Roslyn アナライザーを無効にするには、ソリューション .DotSettings ファイルに次の構成を追加します。

                <wpf:ResourceDictionary xml:space="preserve"
                     xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
                     xmlns:s="clr-namespace:System;assembly=mscorlib"
                     xmlns:ss="urn:shemas-jetbrains-com:settings-storage-xaml"
                     xmlns:wpf="http://schemas.microsoft.com/winfx/2006/xaml/presentation">
                 
                     <!-- Enable/disable Roslyn analyzers and Source Generators -->
                     <s:Boolean x:Key="/Default/CodeInspection/Roslyn/RoslynEnabled/@EntryValue">False</s:Boolean>
                 
                     <!-- Include/exclude Roslyn analyzers in Solution-Wide Analysis -->
                     <s:Boolean x:Key="/Default/CodeInspection/Roslyn/UseRoslynInSwea/@EntryValue">False</s:Boolean>
                 
                     </wpf:ResourceDictionary>
            

EditorConfig の使用

EditorConfig を使用してプロジェクトのコードスタイルを維持する場合は、.editorconfig ファイルからコードインスペクションを構成することもできます。

EditorConfig の規約が示すように、InspectCode は、ルートファイルパスに到達するか、root=true を持つ EditorConfig ファイルが見つかるまで、現在のファイルのディレクトリとそのすべての親ディレクトリにある .editorconfig という名前のファイルに定義されているインスペクション設定を適用します。.editorconfig ファイルで指定されたファイルマスク (*Test.cs など) も考慮されます。

.editorconfig ファイルのインスペクション設定は、他のプロパティと同様に構成されます。対応する行を追加します。

[inspection_property]=[error | warning | suggestion | hint | none]

例: 次の行を使用して、Possible 'System.NullReferenceException' インスペクションの重大度レベルを Error に変更できます。

resharper_possible_null_reference_exception_highlighting=error

または、次の行を使用して Redundant argument with default value インスペクションを無効にすることもできます。

resharper_redundant_argument_default_value_highlighting=none

各インスペクションの EditorConfig プロパティは、コードインスペクションインデックスセクションと EditorConfig プロパティのインデックスページのページにあります。- ブラウザー検索を使用して目的のインスペクションのプロパティを探すだけです。

ベースライン機能を有効にする

ベースライン機能を使用すると、特定の問題の分析をスキップできます。ベースラインに関する情報は、SARIF 形式のファイルに含まれています。

ベースライン機能を使用して Qodana for .NET リンターを実行する方法を選択します。

Qodana for .NET リンターをネイティブモードで実行できます。

このスニペットを .github/workflows/code_quality.yml ファイルに保存します。

                              name: Qodana
                              on:
                                workflow_dispatch:
                                pull_request:
                                push:
                                  branches: # Specify your branches here
                                    - main # The 'main' branch
                                    - master # The 'master' branch
                                    - 'releases/*' # The release branches
                              jobs:
                                qodana:
                                  runs-on: ubuntu-latest
                                  permissions:
                                    contents: write
                                    pull-requests: write
                                    checks: write
                                  steps:
                                    - uses: actions/checkout@v3
                                      with:
                                        ref: ${{ github.event.pull_request.head.sha }}  # to check out the actual pull request commit, not the merge commit
                                        fetch-depth: 0  # a full history is required for pull request analysis
                                    - name: 'Qodana Scan'
                                      uses: JetBrains/qodana-action@v2026.1
                                      with: 
                                        args: |
                                            --linter qodana-dotnet
                                            --within-docker false
                                            --baseline <path/to/qodana.sarif.json>
                                      env:
                                        QODANA_TOKEN: ${{ secrets.QODANA_TOKEN }}
                          

このスニペットには、ベースラインを含む SARIF ファイルへのパスを指定する args: --baseline,<path/to/qodana.sarif.json> 行があります。

プロジェクトのルートディレクトリで次のコマンドを実行します。

                                qodana scan \
                                   --linter qodana-dotnet \
                                   --within-docker false \
                                   --baseline <path/to/qodana.sarif.json>
                            

ここで、--baseline <path/to/qodana.sarif.json> オプションはベースライン機能を指定します。

ブラウザーで Qodana クラウド(英語)を開き、分析レポートを確認して分析を再設定してください。詳細については、ドキュメントの分析レポートのセクションを参照してください。

Docker モードでベースライン機能を実行する方法を選択してください。

このスニペットを .github/workflows/code_quality.yml ファイルに保存します。

                              name: Qodana
                              on:
                                workflow_dispatch:
                                pull_request:
                                push:
                                  branches: # Specify your branches here
                                    - main # The 'main' branch
                                    - master # The 'master' branch
                                    - 'releases/*' # The release branches
                              jobs:
                                qodana:
                                  runs-on: ubuntu-latest
                                  permissions:
                                    contents: write
                                    pull-requests: write
                                    checks: write
                                  steps:
                                    - uses: actions/checkout@v3
                                      with:
                                        ref: ${{ github.event.pull_request.head.sha }}  # to check out the actual pull request commit, not the merge commit
                                        fetch-depth: 0  # a full history is required for pull request analysis
                                    - name: 'Qodana Scan'
                                      uses: JetBrains/qodana-action@v2026.1
                                      with:
                                        args: | 
                                            --baseline <path/to/qodana.sarif.json>
                                            --linter qodana-dotnet
                                      env:
                                        QODANA_TOKEN: ${{ secrets.QODANA_TOKEN }}
                          

このスニペットには、ベースラインを含む SARIF ファイルへのパスを指定する args: --baseline,<path/to/qodana.sarif.json> 行があります。

プロジェクトリポジトリのルートディレクトリに、SARIF 形式のベースラインファイルへのパスを指定する --baseline <path/to/qodana.sarif.json> 行を含む Jenkinsfile を保存します。

                            pipeline {
                                environment {
                                    QODANA_TOKEN=credentials('qodana-token')
                                }
                                agent {
                                    docker {
                                        args '''
                                          -v "${WORKSPACE}":/data/project
                                          --entrypoint=""
                                          '''
                                        image 'jetbrains/qodana-dotnet:2026.1'
                                    }
                                }
                                stages {
                                    stage('Qodana') {
                                        steps {
                                            sh '''
                                            qodana \
                                            --baseline <path/to/qodana.sarif.json>
                                            '''
                                        }
                                    }
                                }
                            }
                          

プロジェクトのルートディレクトリで、このスニペットを .gitlab-ci.yml ファイルに保存します。

                            include:
                               - component: $CI_SERVER_FQDN/qodana/qodana/qodana-gitlab-ci@v2026.1
                                 inputs:
                                    image: jetbrains/qodana-dotnet:2026.1
                                    args: --baseline <path/to/qodana.sarif.json>
                          

script ブロックの --baseline <path/to/qodana.sarif.json> 行はベースライン機能を呼び出します。

TeamCity UI で、Qodana を実行するビルドの構成ページに移動します。
ビルド設定ページで、ビルドステップページに移動します。
ビルドステップページで、ビルドステップを追加ボタンをクリックしてください。
開いたページで、Qodana ランナーを選択します。
新しいビルドステップ: Qodana ページで、高度なオプションを表示をクリックし、Qodana ランナーを構成します。
- ステップ名は、他のビルドステップの中でこのステップを一意に識別します。
- ステップ ID は、他のビルドステップの中でこのステップを一意に識別します。
- ステップ実行は、このビルドステップをトリガーするビルド条件を構成します。
- 作業ディレクトリはビルドプロセスのディレクトリを設定します。詳細については、TeamCity のドキュメントを参照してください。バージョン管理設定タブで Checkout directory パラメーターが指定されている場合は、このフィールドを空のままにすることができます。
- レポート ID はレポートを一意に識別し、単一のビルド内で複数の分析ステップが構成されている場合に複数のレポートを区別できるようにします。
- レポートを TeamCity テストに転送するチェックボックスは、TeamCity UI の「テスト」タブで Qodana レポートの可用性を構成します。このオプションを使用すると、検出された他の問題とともにコードベースの問題を表示できます。
- リンターは Qodana リンターを構成します。
  ここで、.NET リンターの Qodana を選択します。
- バージョンはデフォルトで Latest に設定されています。
- インスペクションプロファイル: はインスペクションプロファイルを定義します:
  - qodana.starter (default) はデフォルトプロファイルの 1 つです。
  - Profile name ではプロファイルを指定できます。詳細については、既存の Qodana プロファイルセクションを参照してください。
  - Profile path を使用すると、カスタムプロファイルへのパスを指定できます。このオプションを使用するには、 qodana.yaml ファイルでもカスタムプロファイルを構成する必要があります。
- クラウドトークンは、Qodana Cloud で生成されたプロジェクトトークンを構成します。
- 追加の Docker 引数は、Docker イメージによって受け入れられる引数を設定します。詳細については、構成オプションセクションを参照してください。
- 追加の Qodana 引数を使用すると、デフォルトの Qodana 機能を拡張できます。詳細については、オプションの種類セクションを参照してください。
  このフィールドでは、--baseline <path/to/qodana.sarif.json> オプションを使用してベースラインフィーチャを指定します。
- Qodana CLI バージョンでは、使用する Qodana CLI(英語) バージョンを指定できます。
保存ボタンをクリックしてください。

コマンドラインからベースライン機能を実行する方法を選択します。

                                      qodana scan \
                                         -v <path_to_baseline>:/data/base/ \
                                         -e QODANA_TOKEN="<cloud-project-token>" \
                                         --linter qodana-dotnet \
                                         --baseline /data/base/<path-relative-to-project-dir>/qodana.sarif.json
                                  

                                      docker run \
                                         -v <source-directory>/:/data/project/ \
                                         -v <path_to_baseline>:/data/base/ \
                                         -e QODANA_TOKEN="<cloud-project-token>" \
                                         jetbrains/qodana-dotnet:2026.1 \
                                         --baseline /data/base/<path-relative-to-project-dir>/qodana.sarif.json
                                  

IDE で、問題ツールウィンドウに移動します。
問題ツールウィンドウで、Qodana タブをクリックします。
Qodana タブで、ローカルで試すボタンをクリックします。
開いたダイアログで、詳細な構成セクションを展開し、ベースラインファイルへのパスを指定して、実行をクリックします。

ベースライン機能を使用して Qodana Community for .NET リンターを実行する方法を選択します。

このスニペットを .github/workflows/code_quality.yml ファイルに保存します。

                      name: Qodana
                      on:
                        workflow_dispatch:
                        pull_request:
                        push:
                          branches: # Specify your branches here
                            - main # The 'main' branch
                            - master # The 'master' branch
                            - 'releases/*' # The release branches
                      jobs:
                        qodana:
                          runs-on: ubuntu-latest
                          permissions:
                            contents: write
                            pull-requests: write
                            checks: write
                          steps:
                            - uses: actions/checkout@v3
                              with:
                                ref: ${{ github.event.pull_request.head.sha }}  # to check out the actual pull request commit, not the merge commit
                                fetch-depth: 0  # a full history is required for pull request analysis
                            - name: 'Qodana Scan'
                              uses: JetBrains/qodana-action@v2026.1
                              with:
                                args: |
                                    --linter qodana-cdnet
                                    --baseline <path/to/qodana.sarif.json>
                              env:
                                QODANA_TOKEN: ${{ secrets.QODANA_TOKEN }}
                  

このスニペットには、ベースラインを含む SARIF ファイルへのパスを指定する args: --baseline,<path/to/qodana.sarif.json> 行があります。

                    pipeline {
                        environment {
                            QODANA_TOKEN=credentials('qodana-token')
                        }
                        agent {
                            docker {
                                args '''
                                  -v "${WORKSPACE}":/data/project
                                  --entrypoint=""
                                  '''
                                image 'jetbrains/qodana-cdnet:2026.1-eap'
                            }
                        }
                        stages {
                            stage('Qodana') {
                                steps {
                                    sh '''
                                    qodana \
                                    --baseline <path/to/qodana.sarif.json>
                                    '''
                                }
                            }
                        }
                    }
                  

プロジェクトのルートディレクトリで、このスニペットを .gitlab-ci.yml ファイルに保存します。

                            include:
                               - component: $CI_SERVER_FQDN/qodana/qodana/qodana-gitlab-ci@v2026.1
                                 inputs:
                                    image: jetbrains/qodana-cdnet:2026.1-eap
                                    args: --baseline <path/to/qodana.sarif.json> 
                        

script ブロックの --baseline <path/to/qodana.sarif.json> 行はベースライン機能を呼び出します。

コマンドラインからベースライン機能を実行する方法を選択します。

                              qodana scan \
                                 -v <path_to_baseline>:/data/base/ \
                                 -e QODANA_TOKEN="<cloud-project-token>" \
                                 --linter qodana-cdnet \
                                 --baseline /data/base/<path-relative-to-project-dir>/qodana.sarif.json
                          

                              docker run \
                                 -v <source-directory>/:/data/project/ \
                                 -v <path_to_baseline>:/data/base/ \
                                 -e QODANA_TOKEN="<cloud-project-token>" \
                                 jetbrains/qodana-cdnet:2026.1-eap \
                                 --baseline /data/base/<path-relative-to-project-dir>/qodana.sarif.json
                          

品質ゲートの有効化

次のスニペットを qodana.yaml ファイルに保存することで、プロジェクトの問題の総数、特定の問題の重大度、コードカバレッジに対して品質ゲートを構成できます。

            failureConditions:
              severityThresholds:
                any: 50 # Total number of problems in all severities
                critical: 1 # Severities
                high: 2
                moderate: 3
                low: 4
                info: 5
              testCoverageThresholds:
                fresh: 6 # Fresh code coverage
                total: 7 # Total percentage
        

次のスニペットを qodana.yaml ファイルに保存すると、プロジェクトの問題の合計数に対して品質ゲートを構成できます。

            failureConditions:
              severityThresholds:
                any: 50 # Total number of problems in all severities
        

プルリクエストの分析

Qodana for .NET リンターを使用してプルリクエストを分析できます。

Qodana Scan GitHub アクション(英語)はすべてのプルリクエストを自動的に分析するため、追加の構成を指定する必要はありません。この構成を .github/workflows/code_quality.yml ファイルに保存します。

                name: Qodana
                on:
                  workflow_dispatch:
                  pull_request:
                  push:
                    branches: # Specify your branches here
                      - main # The 'main' branch
                      - 'releases/*' # The release branches
                jobs:
                  qodana:
                    runs-on: ubuntu-latest
                    permissions:
                      contents: write
                      pull-requests: write
                      checks: write
                    steps:
                      - uses: actions/checkout@v3
                        with:
                          ref: ${{ github.event.pull_request.head.sha }}  # to check out the actual pull request commit, not the merge commit
                          fetch-depth: 0  # a full history is required for pull request analysis
                      - name: 'Qodana Scan'
                        uses: JetBrains/qodana-action@v2026.1
                        with:
                          args: --linter qodana-dotnet
                        env:
                          QODANA_TOKEN: ${{ secrets.QODANA_TOKEN }}
        

プロジェクトのルートディレクトリに、次のスニペットを含む .gitlab-ci.yml ファイルを保存します。

            include:
               - component: $CI_SERVER_FQDN/qodana/qodana/qodana-gitlab-ci@v2026.1
                 inputs:
                   image: jetbrains/qodana-dotnet:2026.1 
        

この構成により、マージリクエスト分析が可能になります。

プルリクエストとマージリクエストを分析するための TeamCity の構成に関する情報は、TeamCity ドキュメントポータルで入手できます。

コードの変更を分析するには、--diff-start オプションを使用し、比較のベースとなるコミットのハッシュを指定します。

                    qodana scan \
                       -e QODANA_TOKEN="<cloud-project-token>" \
                       --linter qodana-dotnet \
                       --diff-start=<GIT_START_HASH>
                

                  docker run \
                     -v $(pwd):/data/project/ \
                     -e QODANA_TOKEN="<cloud-project-token>" \
                     jetbrains/qodana-dotnet:2026.1 \
                     --diff-start=<GIT_START_HASH>
                

使用統計

JetBrains EAP ユーザー契約(英語)によれば、当社はユーザーエクスペリエンスをさらに向上させるために、サードパーティのサービスを使用して当社の機能の使用状況を分析することがあります。すべてのデータは匿名で収集されます。--no-statistics=true CLI オプションを使用して統計を無効にすることができます。例:

docker run \
   -v <source-directory>/:/data/project/ \
   -e QODANA_TOKEN="<cloud-project-token>" \
   jetbrains/qodana-dotnet:2026.1&lt;-privileged&gt; \
   --no-statistics=true

サポートされているテクノロジーと機能

へのサポート	名前	.NET 用 Qodana	.NET の Qodana コミュニティ
プログラミング言語	C# C++ * VB.NET ** C * JavaScript TypeScript F#	✔ ✔ ✔ ✔ ✔ ✔ ✔	✔ ✔ ✔
フレームワークおよびライブラリ	Angular ASPX Blazor ASP.NET ゴドット Handlebars/Mustache HTTP クライアント Less Node.js NUnit PostCSS Pug/Jade React Roslyn Sass/SCSS Unity Unreal Engine Vue xUnit .NET Core	✔ ✔ ✔ ✔ ✔ ✔ ✔ ✔ ✔ ✔ ✔ ✔ ✔ ✔ ✔ ✔ ✔ ✔ ✔ ✔	✔ ✔ ✔
データベースと ORM	MongoDB MySQL Oracle PostgreSQL SQL SQL サーバー	✔ ✔ ✔ ✔ ✔ ✔
マークアップ言語とファイル形式	HTML Razor 正規表現レスエックス XML XAML CSS Docker GitHub アクション JSON および JSON5 JSONPath Kubernetes Markdown OpenAPI RELAX NG ShaderLab T4 XPath XSLT YAML	✔ ✔ ✔ ✔ ✔ ✔ ✔ ✔ ✔ ✔ ✔ ✔ ✔ ✔ ✔ ✔ ✔ ✔ ✔ ✔	✔ ✔ ✔ ✔ ✔ ✔
スクリプト言語	シェルスクリプト	✔
ビルド管理	MSBuild	✔
Qodana の機能	ベースラインクオリティゲートコードカバレッジインサイト ***** ライセンス監査 *** クイックフィックスシングルサインオン *****	✔ ✔ ✔ ✔ ✔ ✔ ✔	✔ ✔

* C および C++ インスペクションは、.sln ファイルを含むプロジェクトに適用されます。

** Visual Basic インスペクションのみをサポートします。

*** Ultimate Plus ライセンスのもとでのみ利用可能です。

2026 年 6 月 12 日

Qodana 2026.1 ヘルプ

.NET

始める前に

Qodana クラウド

SDK バージョン

ソフトウェアを準備する

プロジェクトのビルド

Qodana の実行

基本的な使用例

特定のソリューションを分析する

プライベート NuGet リポジトリ

分析レポートを参照する

構成を拡張する

分析範囲の調整

EditorConfig の使用

ベースライン機能を有効にする

品質ゲートの有効化

プルリクエストの分析

使用統計

サポートされているテクノロジーと機能

関連ページ：