Qodana 2026.2 ヘルプ

ベースライン

ベースラインは、特定の Qodana 分析時点で取得されたコードベースの問題点のスナップショットです。

ベースライン機能を使用すると、現在のコードをベースラインの状態と比較し、新規の問題、変更されていない問題、解決済みの問題を確認できます。例: プルリクエストまたはマージリクエストのマージ後に変更を監視するために、main ブランチのベースラインを設定および更新できます。

ベースラインはすべてのリンターでサポートされており、Community、Ultimate、Ultimate Plus ライセンスおよびそれぞれの試用版で利用可能です。ライセンスの詳細については、サブスクリプションのオプションと価格のページを参照してください。デモ版のリクエストも可能です。

ベースラインの仕組み

ベースライン機能はデフォルトで有効になっており、追加の設定は不要です。プロジェクトのベースラインに関する情報は、Qodana クラウドに保存され、更新されます。

プロジェクトの最初の分析時に、Qodana は発見されたすべての問題を収集し、ベースラインに移動させ、ベースラインをレビューおよび後続の Qodana 分析に利用できるようにします。ベースラインには問題を追加したり削除したりできます。

一般的に、基本機能は問題を以下のグループに分類します。

  • 変更なし – 最初の分析時にベースラインに追加され、それ以降変更されていない問題。

  • 新規 – ベースラインのどの問題とも一致しなかった問題。これらは通常、最近の変更によって発生した問題です。ただし、リファクタリングやファイル更新後に Qodana が認識できない場合、既存の問題も新規として報告されることがあります。

  • 該当なし – ベースライン作成以降に解決された問題。

このダイアグラムは、これらのグループがどのように機能するかを説明しています。

Enabling the baseline
  1. 例: 最初の Qodana 分析で検出された 2 つの問題がベースラインに追加されます。

  2. 2 回目の Qodana 分析では 3 つの問題が検出されます。幸いなことに、今回は Qodana によってそのうちの 1 つが新規問題としてマークされます。残りの 2 つは変更されていない問題であり、すでにベースラインレポートに反映されています。

  3. ベースライン上の問題が 1 つ解決された後、プロジェクトは再度分析されました。今回のレポートには 3 つの問題が記載されます。新しい問題は、ステップ 2 で検出された問題であり、依然として新しい問題として扱われています。また、ステップ 1 以降変更されていない問題が 1 つあります。最後に、ベースライン上の問題が 1 つ解決されたため、現在は「存在しない」とマークすることができます。

    ご覧のとおり、新しい問題は Qodana 分析全体で自動的にステータスが変更されるわけではありません。ステータスを「変更なし」に変更するには、これらの問題をベースラインに追加してから、プロジェクトを再度分析する必要があります。

  4. 新しい問題は、その問題を基準値に追加することで、変更なしのグループに移動されました。

Qodana Cloud で Editor または Admin ロールのユーザーである場合は、基本的な問題点タブの適用 ... ドロップダウンリストを使用してベースラインを設定できます。

分析結果を調べる

ベースラインデータは基本的な問題点タブで確認できます。

Baseline problems tab

基本的な問題点タブでは、後の解析で使用されるベースラインを表示できます。

分析レポートのセクションに従って、問題を昇格または降格することで、ベースラインを更新できます。

Qodana Cloud で Editor または Admin ロールのユーザーである場合は、基本的な問題点タブの適用 ... ドロップダウンリストを使用してベースラインを設定できます。

The Apply ... dropdown list

ファイルベースライン

ベースライン管理とバージョン管理が必要な場合は、プロジェクトのベースラインをバージョン管理システムに保存されたファイルで管理できます。コード分析を実行する際にベースラインファイルを指定すると、プロジェクトの既存のベースラインが上書きされます。

ファイルベースラインから始めるには、Qodana Cloud UI の基本的な問題点タブに移動し、qodana.sarif.json ファイルに保存されているベースラインをダウンロードします。以下に示すように、 --baseline オプションを設定してファイルベースラインを構成します。

qodana scan \ -e QODANA_TOKEN="<cloud-project-token>" \ --baseline .qodana/baseline.sarif.json

ここで、QODANA_TOKEN 変数は、Ultimate と Ultimate Plus リンターが必要とするプロジェクトトークンを指します。

docker run \ -v $(pwd):/data/project/ \ -e QODANA_TOKEN="<cloud-project-token>" \ jetbrains/qodana-<image> \ --baseline .qodana/baseline.sarif.json

このコードスニペットでは、--baseline オプションは Docker ファイルシステム上のベースラインファイルへのパスを指定します。QODANA_TOKEN 変数は、Ultimate と Ultimate Plus リンターが必要とするプロジェクトトークンを参照します。

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.2 with: args: --baseline .qodana/baseline.sarif.json env: QODANA_TOKEN: ${{ secrets.QODANA_TOKEN }}

このコードスニペットでは、--baseline オプションはベースラインを含む baseline.sarif.json ファイルへのパスを指定しています。

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

このスニペットでは、--baseline オプションはベースラインを含む baseline.sarif.json ファイルへのパスを指定します。

include: - component: $CI_SERVER_FQDN/qodana/qodana/qodana-gitlab-ci@v2026.2 inputs: args: | --baseline .qodana/baseline.sarif.json --image <image>

このスニペットでは、--baseline オプションはベースラインを含む baseline.sarif.json ファイルへのパスを指定します。

ランナー設定で、追加の Qodana 引数フィールドを見つけて、ベースラインを含む baseline.sarif.json ファイルへのパスを指定します。

--baseline .qodana/baseline.sarif.json

この機能をサポートする IDE のリストは、JetBrains IDE セクションにあります。

このアニメーションは、ベースラインを使用してコードを分析する方法を示しています。

Running the baseline in the IDE

アニメーションの各ステップの説明は次のとおりです。

  1. IDE で、問題ツールウィンドウに移動します。

  2. 問題ツールウィンドウで、Qodana タブをクリックします。

  3. Qodana タブで、ローカルで試すボタンをクリックします。

  4. 開いたダイアログで、詳細な構成セクションを展開し、ベースラインファイルを選択して、実行をクリックします。

報告書に欠落している問題を含める

レポートに欠落している問題を含めるには、Qodana を --baseline-include-absent オプション付きで実行する必要があります。

qodana scan \ -e QODANA_TOKEN="<cloud-project-token>" \ --baseline .qodana/baseline.sarif.json \ --baseline-include-absent
docker run \ -v $(pwd):/data/project/ \ -e QODANA_TOKEN="<cloud-project-token>" \ jetbrains/qodana-<image> \ --baseline .qodana/baseline.sarif.json \ --baseline-include-absent
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.2 with: args: | --baseline .qodana/baseline.sarif.json --baseline-include-absent env: QODANA_TOKEN: ${{ secrets.QODANA_TOKEN }}
pipeline { environment { QODANA_TOKEN=credentials('qodana-token') } agent { docker { args ''' -v "${WORKSPACE}":/data/project --entrypoint="" ''' image 'jetbrains/qodana-<image>' } } stages { stage('Qodana') { steps { sh ''' qodana \ --baseline .qodana/baseline.sarif.json \ --baseline-include-absent ''' } } } }
include: - component: $CI_SERVER_FQDN/qodana/qodana/qodana-gitlab-ci@v2026.2 inputs: args: | --baseline .qodana/baseline.sarif.json --baseline-include-absent --image <image>

ランナー設定で、追加の Qodana 引数フィールドを見つけて、--baseline-include-absent オプションを追加します。

--baseline .qodana/baseline.sarif.json --baseline-include-absent

ベースラインパスのカスタマイズ

デフォルトでは、Qodana はベースラインファイルがプロジェクトルートの .qodana/baseline.sarif.json にあることを想定しています。これを上書きするには、次のようにします。

  • プロジェクトディレクトリ内の別のパスにベースラインファイルを保存する場合は、--baseline オプションを使用して、プロジェクトルートからの相対的な場所を指定します。例: --baseline path/to/your/baseline.sarif.json

  • ベースラインファイルがプロジェクトディレクトリの外にある場合は、それをコンテナーにマウントし(Docker ベースの実行の場合)、マウントしたパスを使用して --baseline オプションで参照する必要があります。

ファイルベースのベースラインを要求する

Qodana Cloud で Editor または Admin ロールのユーザーである場合、プロジェクトをファイルベースラインのみを使用するように構成できます。

  1. Qodana クラウド UI の基本的な問題点タブで、ベースラインを含む baseline.sarif.json ファイルをダウンロードします。

  2. Qodana クラウド UI の基本的な問題点タブで、適用 ... ドロップダウンリストを無効にします。

  3. ファイルベースラインの章で推奨されている方法に従って、ファイルベースラインを設定してください。

  4. Qodana の実行。

  1. Qodana クラウド UI の基本的な問題点タブで、適用 ... ドロップダウンリストを有効にします。

  2. Qodana の設定で、 --baseline オプションを設定してください。

  3. デフォルトのベースラインを更新するには、--baseline オプションを指定して Qodana を実行してください。

2026 年 11 月 11 日

関連ページ:

Qodana のエディション

ニーズに応じて、次の表に示す適切なライセンスを選択できます。Community フリー孤立した問題の解決に最適 Ultimate 詳細については、サブスクリプションのオプションと価格を参照してくださいさまざまなビジネスタスクを解決するために設計されています。試用版をご利用いただけます。Ultimate Plus 詳細については、サブスクリプションのオプションと価格を参照してください Ultimate ライセンスと同じ機能がすべて含まれていますが、追加機能と無制限の履歴データストレージも含まれています。試用...

分析レポート

Qodana を使用すると、ローカルまたは Qodana クラウドでインタラクティブかつユーザーフレンドリーな形式で分析レポートを確認できます。レポート UI の概要:各レポートには次のタブが含まれています。現在の問題点は、Qodana が最新の分析で検出した問題点を明らかにします。基本的な問題点は、ベースラインとしてマークされ、それ以降修正されていない問題点を一覧にしたものです。インスペクションを使用すると、Qodana を将来使用するために設定できます。

JetBrains IDE

JetBrains Toolbox アプリ経由でインストールされた JetBrains IDE 製品(IntelliJ IDEA、PhpStorm、WebStorm、GoLand、PyCharm、Rider、CLion など)を使用して、Qodana を実行できます。IDE に応じて、利用可能な機能は以下のとおりです。Qodana をローカルで実行し、レポートを Qodana クラウドにアップロードする (CLion では利用できません)、Qodana クラウドに接続してレポートをダウンロードする...

コードカバレッジ

コードカバレッジは、生成されたレポートを使用して、メソッド、クラス、ファイル内の全体的なコードカバレッジを計算します。また、これらのエンティティのカバレッジ不足に関連する問題についてもレポートします。コードカバレッジレポートは、Qodana Ultimate および Qodana Ultimate Plus ライセンスでご利用いただけます。Qodana ライセンスの詳細については、サブスクリプションのオプションと価格ページを参照してください。デモのご依頼も承っております。この機能は以下のリンターで...