Qodana 2026.1 ヘルプ

Visual Studio Code

Visual Studio Code は Microsoft によって開発されたソースコードエディターで、Windows、macOS、Linux で利用可能です。このセクションでは、Visual Studio Code で Qodana を使用する方法を説明します。

始める前に

Qodana クラウドプロジェクトがあり、このプロジェクトに Visual Studio Code によって開かれたプロジェクトに関連する分析レポートが少なくとも 1 つあることを確認します。また、java -version コマンドを実行して、マシンに Java 11 以降がインストールされているかどうかを確認します。必要に応じて、ローカルマシンに Java をインストールします。

Visual Studio マーケットプレイス (英語) Web サイトから、または Visual Studio Code の拡張ビューに移動して、Qodana 拡張機能をダウンロードしてインストールします。

UI の概要

コマンドパレットで「View: Show Qodana 」と入力し、Qodana ビューを選択します。

Navigating to Qodana

これにより、Visual Studio Code UI の左側に Qodana ビューが開きます。

The Qodana view

このビューには、Visual Studio Code の Qodana 機能につながるボタンが含まれています。

または、コマンドパレットで Qodana と入力して、Qodana ビューにあるオプションのリストを表示します。

Navigating to Qodana through a command palette

Qodana をローカルで実行する

Qodana をローカルで実行し、分析レポートを保存および分析するために Qodana クラウド(英語)に転送することができます。

  1. Visual Studio Code で、Qodana ビューに移動し、ローカルで実行をクリックします。

    Clicking the Run Locally button in the Qodana view
  2. 開いたダイアログで、Qodana Cloud によって生成されたプロジェクトトークンを入力します。

    Specifying the Qodana Cloud project token
  3. 以前に qodana.yaml ファイルでリンターを指定していない場合は、開いたリンターを選択リストでリンターを選択します。

    Specifying a linter

Qodana がプロジェクトの分析を完了すると、Visual Studio Code の PROBLEMS タブで分析レポートを確認できます。

ローカルの Qodana 分析および負荷分析レポートの履歴を表示するには、Qodana ビューで履歴を表示ボタンをクリックし、確認したいレポートを選択してください。

PROBLEMS タブをデフォルト状態に戻すには、Qodana ビューで分析をオフにするボタンをクリックします。

Qodana クラウドに接続する

Qodana レポートを Qodana Cloud に転送し、最新の Qodana レポートを取得するには、Qodana Cloud にログインし、IDE で開いたプロジェクトを以下に示すように特定の Qodana Cloud プロジェクトに接続します。

  1. Visual Studio Code で、Qodana ビューに移動し、クラウドにログインボタンをクリックして、認証ページにリダイレクトするための手順に従います。

    Logging in to Qodana Cloud
  2. Qodana ビューで、ローカルプロジェクトをリンクする Qodana Cloud のプロジェクトを選択し、リンクをクリックします。プロジェクトがリストにない場合は、Other project をクリックし、開いたダイアログでプロジェクト ID を指定します。

    Selecting a project for linking
  3. PROBLEMS タブに移動するか、Qodana ビューでレポートを開くボタンをクリックして分析レポートを確認してください。

分析レポートを参照する

Visual Studio Code の PROBLEMS タブを使用して、Qodana の分析レポートを調べることができます。

このタブでは、問題のある項目をクリックして、Qodana が問題を検出したコードフラグメントに移動できます。

The PROBLEMS in VS Code

Qodana ビュー履歴を表示ボタンを使用すると、ローカル Qodana 分析後に生成された分析レポートを表示することもできます。

Qodana の設定

Qodana 構成ページの概要は次のとおりです。

Qodana settings in VS Code

次の設定を使用して拡張機能を構成できます。

設定

説明

パス接頭辞

必要に応じて、プロジェクトパスの接頭辞をオーバーライドできます。プロジェクトファイルへのフルパスがどのように構成されるかというルールは次のとおりです。

フルパス = ワークスペース + パスの接頭辞 + SARIF ファイル内のパス

正しいパス接頭辞を定義する方法の例を次に示します。

絶対パス

SARIF のパス

ワークスペース

パス接頭辞

/foo/bar/baz/file

baz/file

/foo/bar

(空、値なし)

/foo/bar/baz/file

baz/file

/foo/bar/baz

..

/foo/bar/baz/file

file

/foo/bar

baz

Qodana クラウドレポートでは、ファイルセクションを確認して、SARIF ファイル内のパスがどのように設定されているかを確認できます。

.vscode/settings.json をリポジトリに自由にコミットして、Qodana 設定をチームと共有してください。

プロジェクト ID

プロジェクト ID 値を取得するには、... でファイルを開きますボタンを使用して Qodana クラウドレポートからプロジェクトを開き、開くツールとして Visual Studio Code を選択します。

あるいは、プロジェクト ID の値は、Qodana Cloud プロジェクト URL に含まれています。この URL の構造は、https://qodana.cloud/projects/PROJECT_ID/reports/REPORT_ID です。この URL からは、PROJECT_ID のみを使用します。たとえば、URL https://qodana.cloud/projects/AGvmx/reports/EDKYd からは、AGvmx が必要になります。

Visual Studio Code UI のステータスバーに、Qodana アイコンがあります。このアイコンには次の状態があります。

  • 設定が無効ですは、拡張機能を構成する必要があることを意味します。これを行うには、このアイコンをクリックすると、拡張機能の構成ページにリダイレクトされます。

  • レポートには添付されませんは、拡張機能を構成したが、レポートがまだダウンロードされていないことを意味します。レポートをダウンロードするには、アイコンをクリックします。

  • レポートに添付は、レポートが Qodana クラウドからダウンロードされ、Visual Studio Code を使用して表示できることを意味します。

トラブルシューティング

別の Qodana Cloud アカウントに切り替える必要があります

Qodana: 認証をリセットするコマンドを使用すると、設定をクリアせずに Qodana クラウドアカウントを切り替えることができます。これは、異なる Qodana Cloud アカウントに複数の組織がある場合に役立ちます。

現在の設定では Qodana レポートを取得できません

Qodana: すべての設定をリセットするコマンドを使用して、すべての設定と資格情報をリセットし、拡張機能を再度構成するか、他の設定を使用することができます。

2026 年 6 月 02 日

関連ページ:

プロジェクト

プロジェクトは Qodana レポートを蓄積します。各プロジェクトはプロジェクトトークンによって一意に識別されます。プロジェクトの作成:新しい組織を作成する際、Qodana Cloud は最初のプロジェクトの設定を支援するため、これらの手順は追加のプロジェクトを作成する場合にのみ関連します。チームページで、ボタンをクリックします。プロジェクトのセットアップ段階を完了します。この段階の詳細については、前提条件セクションを参照してください。プロジェクトを管理する:プロジェクトが作成された後、その...

レポート

プロジェクトレポートからの情報が集約され、このイメージでマークされているいくつかのセクションに表示されます。各セクションの説明は次のとおりです。プロジェクト名、ブランチ名、前回の分析からの経過時間、検出された問題の数、その深刻度。コードカバレッジとライセンス監査機能を利用した分析レポート。コンテキストメニューを使用すると、次のことが可能になります。VCS の HTTPS または SSH URL を設定します、プロジェクトを別のチームに移動する、プロジェクトの名前を変更する、プロジェクトトークンを...

プロジェクトトークン

一般に利用可能な有料リンターでは、Qodana の実行中に変数を使用してプロジェクトトークンを提供する必要があります。例:qodana scan \ -e QODANA_TOKEN=

分析レポート

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 クラウドに接続してレポートをダウンロードする...

Visual Studio

Visual Studio は、Microsoft によって開発された、Windows 上で .NET および C++ 開発者向けの包括的な IDE です。Qodana のバージョン 2025.1 以降では、Visual Studio で実行して以下の操作を行うことができます。Qodana クラウドに接続する、Qodana クラウドからダウンロードされた Qodana レポートを見る、始める前に:Qodana クラウドプロジェクトがあり、このプロジェクトに、Visual Studio でローカル...