リファレンス: Visual Studio Code 用 Azure Quantum Development Kit 拡張機能

Azure Quantum Development Kit (QDK) では、Visual Studio (VS) コードのすべての標準機能と、.qs ファイルを操作する際の Q#固有の機能が使用されます。 この記事は、必要に応じて追加のコンテンツへのリンクを含む、すべての Q# 関連のコマンドと機能のリファレンス ガイドです。 VS Code の一般的なガイダンスについては、 VS Code のドキュメントを参照してください。

ヒント

Q# 関連のほとんどのコマンドには、 View > コマンド パレット メニューからアクセスできます。 .qs ファイルで、 Ctrl-Shift-P (macOS の場合は Cmd-Shift-P ) を選択し、「 Q# 」と入力して、フィルター処理されたコマンドの一覧を表示します。

すべての macOS キーボード ショートカットについては、macOS の Keyboard ショートカットを参照してください。

コマンド

Q# 関連のほとんどのコマンドには、 View > コマンド パレット メニューからアクセスできます。 Ctrl-Shift-Pを選択し、「Q#」と入力して、フィルター処理されたコマンドの一覧を表示します。 一部のコマンドは、.qs ファイルがアクティブな場合にのみ使用できます。

ヒント

Keyboard Shortcuts または Ctrl + K + S を使用して、VS Code コマンドのカスタム キーボード ショートカットを作成できます。 詳細については、「KEY Bindings for VS Code」を参照してください。

command	アクション	メモ	代替ユーザー アクション
Q#: Q# プロジェクトを作成する	次のような Q# プロジェクトをアクティブ フォルダーに作成します。 * qsharp.json マニフェスト ファイル * 既定の main.qs ファイルを含む src サブフォルダー。	Q# プロジェクトの詳細については、「 Q# プロジェクトでの作業」を参照してください。	エクスプローラーで、ターゲット フォルダーを右クリックし、Q# プロジェクトの作成を選択します。
Q#: Azure Quantum ノートブックを作成する	Q# + Python プログラムを実行し、Azure Quantum にジョブを送信するサンプル Jupyter Notebook を開きます。	Azure Quantum ノートブックの詳細については、「 Work with Azure Quantum Notebooks」を参照してください。	該当なし
Q#: Azure Quantum ワークスペースに接続する	Azure アカウントまたは接続文字列を使用して Azure Quantum ワークスペースに接続します。 認証が完了すると、ワークスペースが Quantum Workspaces のエクスプローラーに表示されます。	Azure Quantum 接続の詳細については、「 Connect to your Azure Quantum workspace」を参照してください。	エクスプローラーで、Quantum ワークスペースにカーソルを合わせ+" アイコンを選択します。
Q#: Q# プレイグラウンドを開く	エクスプローラーで Q# サンプル プログラムのオンライン フォルダーを開きます。 ローカル量子シミュレーターでプログラムを編集して実行したり、ブレークポイントを設定したり、組み込みのデバッガーを使用してコードをステップ実行したりできます。	詳細については、サンプル フォルダーの README ファイルを参照してください。	該当なし
Q#: Azure Quantum ワークスペースを更新する	接続された量子ワークスペースからの最新の変更を同期します。	接続の問題がある場合は、ワークスペース名の横にアラート アイコンが表示されます。	エクスプローラーで、Quantum ワークスペースにカーソルを合わせ更新アイコンを選択します。
エクスプローラー: Quantum ワークスペース ビューにフォーカスする	エクスプローラーを開き、構成されている場合は、接続されている量子ワークスペースに焦点を当てます。 ワークスペースが構成されていない場合は、既存のワークスペースを追加するように求められます。	Azure Quantum 接続の詳細については、「 Connect to your Azure Quantum workspace」を参照してください。	該当なし

.qs ファイルがアクティブな場合は、次のコマンドを使用できます。

command	アクション	メモ	代替ユーザー アクション
Q#: Azure Quantum QIR ターゲット プロファイルを設定する	Q# プログラムの QIR (量子中間表現) ターゲット プロファイルを設定します。	ターゲット プロファイルの詳細については、「 ターゲット プロファイル」を参照してください。	現在のターゲット プロファイルが下部のツール バーに表示されます。 ツール バーのターゲット プロファイルを選択して、選択ドロップダウンを開きます。
Q#: 回線を表示する	Q# プログラムを実行する前に、そのプログラムの回路図を表示します。	詳細については、「 量子回路図の表示を参照してください。	プログラムのエントリ ポイント操作の横または各ユーザー定義操作の上にあるメニューから、コード レンズ オプション Circuit を選択します。
Q#: ファイルを実行してヒストグラムを表示する	現在の Q# プログラムを実行し、結果のヒストグラムを右側のウィンドウに表示します。	ヒストグラム表示の並べ替えオプションとフィルター オプションにアクセスするには、ヒストグラム ペインでフィルター アイコンを選択します。	エントリ ポイント操作の横にあるメニューから、コード レンズ オプション Histogram を選択します。
Q#: 現在の Q# プログラムの QIR を取得する	新しい編集ウィンドウで、現在の Q# コードの QIR ソースを開きます。 QIR ソースをエクスポートするには、プログラムで Base または Adaptive RI ターゲット プロファイルを使用する必要があります。	QIR の詳細については、 Quantum 中間表現および Q# developer ブログを参照してください。	該当なし
デバッグ: Q# ファイルをデバッグする	デバッガーで現在の Q# プログラムを開きます。	詳細については、「 量子コードのデブギングとテストを参照してください。	* F5 を選択 *エントリポイント操作の横にあるメニューからコードレンズオプション Debug を選択します。 * 右上にある Run アイコンを選択し、 Debug Q# ファイルを選択します。
デバッグ: Q# ファイルを実行する	既定の量子シミュレーターで現在の Q# プログラムを実行します。	詳細については、「 Get started with Q# programs」を参照してください。	* Ctrl + F5 キーを押す *入力ポイント操作の横にあるメニューから、コードレンズオプション Run を選択します。 * 右上にある Run アイコンを選択し、 Run Q# ファイルを選択。
Q#: リソース見積もりの計算	Resource Estimator の組み込みバージョンを呼び出します。	詳細については、「 Azure Quantum Resource Estimator への導入」を参照してください。	該当なし
Q#: ヘルプ	VS Code の QDK 拡張機能の簡単な概要。	Azure Quantum の完全なドキュメントについては、 Azure Quantum のドキュメントを参照してください。	該当なし
Q#: ファイルを実行して回路図を表示する	現在の Q# プログラムを実行し、出力を含むプログラムの回路を表示します。	詳細については、「 量子回路図の表示を参照してください。	該当なし
Q#: API ドキュメントを表示する	新しいウィンドウで API ドキュメントを開きます。 Ctrl-F を使用して、このウィンドウを検索します。	詳細については、 Azure Quantum API リファレンスを参照してください。	該当なし

ターミナル

Q# プログラムでは、VS Code で次の 2 つのターミナル ウィンドウを使用します。

ターミナル	アクション
デバッグ コンソール	実行出力またはデバッグ出力を表示します
問題	コンパイル前のエラー チェックを表示します

Q# コードの編集

VS Code の一般的なコード編集機能のほとんどは、Q# プログラムを使用するときに使用できます。 詳細については、VS Code ドキュメントの「 Intellisense 」を参照してください。

• エラー チェックをプリコンパイルする
• Go-to の定義
• 関連情報
• 関数シグネチャ
• パラメータ情報
• 入力候補
• Linting - Q# ファイルでは、マニフェスト ファイルでプロジェクトごとの linting を構成します。 詳細については、「 Q# プロジェクトでの作業を参照してください。

一般的なタスク

Q# ファイルとプロジェクトの操作

タスク	アクション	メモ
新しい Q# ファイル	[ファイル]>[新しいファイル]>[テキスト ファイル]を選択。 拡張子が .qs のファイルを保存します。	Files: Default Language = qsharp設定した場合、新しいファイルは既定で Q# 形式に自動的に設定されます。
Q# プロジェクトを作成する	エクスプローラーで開いているフォルダーから、コマンド パレットから [Q# プロジェクトの作成] を選択するか、エクスプローラー内のフォルダーを右クリックして[Q# プロジェクトの作成]選択。	Q# プロジェクトの詳細については、「 Q# プロジェクトでの作業」を参照してください。
サンプル ファイル	空白の .qs ファイルに「 サンプル」と入力し一覧からサンプル プログラムを選択します。	コマンド パレットで Open Q# playground を選択して、エクスプローラーで Q# サンプル プログラムのオンライン フォルダーを開くこともできます。

Azure Quantum への接続

タスク	アクション	メモ	代替ユーザー アクション
Azure Quantum ワークスペースに接続する	エクスプローラーで、Quantum ワークスペースを展開し既存のワークスペース追加を選択します。 プロンプトに従って、サブスクリプションとワークスペースを選択します。	* 複数のワークスペースに接続できます。 Quantum ワークスペースの横にある "+"を選択別のワークスペースに接続します。 ワークスペース接続は VS Code セッション間で保持されます。 * ワークスペース接続を削除するには、ワークスペースを右クリックし、 ワークスペース接続の削除を選択します。	コマンド パレットで、 [Azure Quantum ワークスペースに接続する] を選択。
Python プログラムを使用してプログラムで接続する	既存のワークスペース接続を右クリックし、 Copy Python コードを選択してワークスペースに接続します。 結果のコードを Python プログラムに貼り付けます。	詳細については、「 Azure Quantum への Q# ジョブを使用した Python の送信を参照してください。	該当なし

プログラムの実行

タスク	アクション	メモ	代替ユーザー アクション
ローカル量子シミュレーターで Q# プログラムを実行する	Q# プログラムで、右上にある Run アイコンを選択し、Q# ファイルの実行 選択。	量子シミュレーターの詳細については、 Sparse 量子シミュレーターを参照してください。	* Ctrl-F5 を選択 * コマンド パレットから、 Q#: ファイルの実行とヒストグラムの表示 または Q#: ファイルの実行と回路図の表示を選択します *入力ポイント操作の横にあるメニューから、コードレンズオプション Run を選択します。
プログラムをデバッグする	Q# プログラムで、右上にある Run アイコンを選択し、 Debug Q# ファイルを選択します。	VS Code の Q# デバッガーの詳細については、「 量子コードのデバッグとテストを参照してください。	* F5 を選択 *エントリポイント操作の横にあるメニューからコードレンズオプション Debug を選択します。
ワークスペース内のプロバイダーとターゲットを表示する	エクスプローラーで、Quantum ワークスペースを選択し、ワークスペースを展開してから Providers を展開して、ワークスペースで使用可能なプロバイダーを表示します。 個々のプロバイダーを展開して、使用可能なターゲットを表示します。	注: ターゲット名をポイントすると、ジョブを送信する前に Status と Queue time が表示されます。	該当なし
Azure Quantum にジョブを送信する	Q# プログラムで、ワークスペース、プロバイダー、およびターゲットを選択します。 現在の Q# プログラムを送信するには、ターゲットの横にある矢印を選択します。	詳細については、「 Azure Quantum への Q# ジョブの送信を参照してください。	該当なし
ジョブの結果を表示する	ワークスペースを展開し、 Jobs を展開します。 Azure Storage からのジョブ出力を開くには、ジョブ名の横にあるクラウド アイコンを選択します。	最新のジョブが一覧表示されます。	該当なし