Microsoft Quantum Development Kit (QDK) では、Visual Studio Code (VS Code) の標準機能と、.qs または .qasm ファイルを操作するときに、言語固有の機能が使用されます。 このリファレンス ガイドでは、VS Code コマンド パレットでアクセスできるすべての QDK コマンドと、その他の機能と追加コンテンツへのリンクについて説明します。 VS Code の一般的なガイダンスについては、 VS Code のドキュメントを参照してください。
ヒント
QDK 拡張機能のほとんどのコマンドは、[ 表示] > コマンド パレット メニューからアクセスできます。
.qsまたは.qasm ファイルでコマンド パレットを開き、「QDK: 」と入力して、フィルター処理されたコマンドの一覧を表示します。
Commands
QDK コマンドのほとんどは、Q# および OpenQASM プログラムの作成と実行に関連しており、 .qs または .qasm ファイルがアクティブな場合にのみ使用できます。 他のコマンドはバックグラウンドで動作し、コマンド パレットではアクセスできません。
次の表では、コマンド パレットに表示される QDK 拡張機能のコマンドについて説明します。
ヒント
VS Code コマンドのカスタム キーボード ショートカットは、 キーボード ショートカットまたは Ctrl + K + S キーを使用して作成できます。詳細については、「 VS Code のキー バインド」を参照してください。
| 命令 | Action | 注記 | 代替ユーザー アクション |
|---|---|---|---|
| QDK: Q# プロジェクトを作成する |
qsharp.json マニフェスト ファイルと既定のsrc ファイルを含む main.qs サブフォルダーを含む、アクティブ なフォルダーに Q# プロジェクトを作成します。 |
Q# プロジェクトの詳細については、「 Q# プロジェクトでの作業」を参照してください。 | エクスプローラーで、ターゲット フォルダーを右クリックし、Q# プロジェクトの作成を選択します。 |
| QDK: Microsoft Quantum ノートブックを作成する | Q# + Python プログラムを実行し、Azure Quantum にジョブを送信するサンプル Jupyter Notebook を開きます。 | Jupyter Notebookの QDK の詳細については、「submit jobs to Azure Quantum from Jupyter Notebook」を参照してください。 | N/A |
| QDK: Azure Quantum ワークスペースに接続する | Azure アカウントまたは接続文字列を使用して Azure Quantum ワークスペースに接続します。 認証が完了すると、ワークスペースが Quantum Workspaces のエクスプローラーに表示されます。 | Azure Quantum 接続の詳細については、「 Connect to your Azure Quantum workspace」を参照してください。 | エクスプローラーで、 Quantum ワークスペース にカーソルを合わせ、[ +] アイコンを選択します。 |
| QDK: QDK プレイグラウンドを開く | エクスプローラーで Q# と OpenQASM サンプル プログラムのオンライン フォルダーを開きます。 ローカル量子シミュレーターでプログラムを編集して実行したり、ブレークポイントを設定したり、組み込みのデバッガーを使用してコードをステップ実行したりできます。 | 詳細については、サンプル フォルダーの README ファイルを参照してください。 | N/A |
| QDK: Azure Quantum ワークスペースを更新する | 接続された量子ワークスペースからの最新の変更を同期します。 | 接続に問題がある場合は、ワークスペース名の横にアラート アイコンが表示されます。 | エクスプローラーで、 Quantum ワークスペース にカーソルを合わせ、更新アイコンを選択します。 |
| エクスプローラー: Quantum ワークスペース ビューにフォーカスする | エクスプローラーを開き、構成されている場合は、接続されている量子ワークスペースに焦点を当てます。 ワークスペースが構成されていない場合は、既存のワークスペースを追加するように求められます。 | Azure Quantum 接続の詳細については、「 Connect to your Azure Quantum workspace」を参照してください。 | N/A |
.qsまたは.qasm ファイルがアクティブな場合は、次のコマンドを使用できます。
| 命令 | Action | 注記 | 代替ユーザー アクション |
|---|---|---|---|
| QDK: 回線の表示 | 実行前にプログラムの回路図を表示します。 | 詳細については、「 量子回路図の表示を参照してください。 | プログラムのエントリ ポイント操作の横または各ユーザー定義操作の上にあるメニューから、コード レンズ オプション Circuit を選択します。 |
| QDK: ファイルを実行してヒストグラムを表示する | 現在のプログラムを実行し、結果のヒストグラムを新しいウィンドウに表示します。 | ヒストグラム表示の並べ替えオプションとフィルター オプションにアクセスするには、ヒストグラム ペインでフィルター アイコンを選択します。 | エントリ ポイント操作の横にあるメニューから、コード レンズ オプション Histogram を選択します。 |
| QDK: 現在の QDK プログラムの QIR を取得する | 新しい編集ウィンドウで、現在の Q# または OpenQASM コードの QIR ソースを開きます。 QIR ソースをエクスポートするには、プログラムで Base、Adaptive RI、または Adaptive RIF ターゲット プロファイルを使用する必要があります。 | QIR の詳細については、 Quantum 中間表現と QDK 開発者ブログを参照してください。 | N/A |
| QDK: リソースの見積もりを計算する | リソース推定器の組み込みバージョンを呼び出します。 | 詳細については、「 Microsoft Quantum リソース推定機能の概要」を参照してください。 | N/A |
| QDK: ヘルプ | VS Code の QDK 拡張機能の簡単な概要。 | Microsoft Quantum の完全なドキュメントについては、 Microsoft Quantum のドキュメントを参照してください。 | N/A |
| QDK: ファイルを実行し、回路図を表示する | 現在のプログラムを実行し、出力を含むプログラムの回路を表示します。 | 詳細については、「 量子回路図の表示を参照してください。 | N/A |
| QDK: API ドキュメントを表示する | 新しいウィンドウで API ドキュメントを開きます。 このウィンドウを検索するには、 Ctrl + F キーを押します。 | 詳細については、Microsoft Quantum API リファレンスを参照してください。 | N/A |
| QDK: 変更ログの表示 | 現在および以前のすべてのリリース バージョンの QDK 更新プログラムを表示する新しいタブで変更ログを開きます。 | 変更ログは、オープンソースの QDK GitHub リポジトリでも使用できます。 | N/A |
| デバッグ: デバッグを開始する | デバッガーで現在のプログラムを開きます。 | 詳細については、「 量子コードのデブギングとテストを参照してください。 | F5 キーを押すか、エントリ ポイント操作の横にあるメニューからコード レンズ オプション [デバッグ] を選択するか、右上の [実行] アイコンを選択して [デバッグの開始] を選択します。 |
| デバッグ: 実行 | 既定の量子シミュレーターで現在のプログラムを実行します。 | 詳細については、「 Get started with Q# programs」を参照してください。 | Ctrl キーを押しながら F5 キーを押すか、エントリ ポイント操作の横にあるメニューからコード レンズ オプション [実行] を選択するか、右上にある [実行] アイコンを選択して、[実行] を選択します。 |
端末
Q# プログラムと OpenQASM プログラムでは、VS Code で次の 2 つのターミナル ウィンドウを使用します。
| Terminal | Action |
|---|---|
| デバッグ コンソール | 実行出力またはデバッグ出力を表示します |
| 問題 | コンパイル前のエラー チェックを表示します |
Q# と OpenQASM コードを編集する
VS Code の一般的なコード編集機能のほとんどは、Q# プログラムと OpenQASM プログラムを使用する場合にも使用できます。
- エラー チェックをプリコンパイルする
- Go-to の定義
- References
- 関数シグネチャ
- パラメータ情報
- コンテキスト認識、名前空間メンバー、型メンバーの入力候補を含む入力候補提案。
- Linting - Q# ファイルでは、マニフェスト ファイルでプロジェクトごとの linting を構成します。 詳細については、「 Q# プロジェクトでの作業を参照してください。
詳細については、VS Code ドキュメントの「 Intellisense 」を参照してください。
一般的なタスク
Q# ファイルとプロジェクトを操作する
| Task | Action | 注記 |
|---|---|---|
| 新しい Q# ファイル |
[ファイル]>[新しいファイル]>[テキスト ファイル]を選択。
.qs という拡張子でファイルを保存します。 |
Files: Default Language = qsharp設定した場合、新しいファイルは自動的に Q# 形式になります。 |
| Q# プロジェクトを作成する | エクスプローラーで開いているフォルダーから、コマンド パレットから [Q# プロジェクトの作成] を選択するか、エクスプローラー内のフォルダーを右クリックして[Q# プロジェクトの作成]選択。 | Q# プロジェクトの詳細については、「 Q# プロジェクトでの作業」を参照してください。 |
| サンプル ファイル | 空白の .qs または .qasm ファイルに サンプルを入力し、オプションの一覧からサンプル プログラムを選択します。 |
コマンド パレットで [ QDK プレイグラウンドを開く ] を選択して、エクスプローラーで Q# と OpenQASM サンプル プログラムのオンライン フォルダーを開くこともできます。 |
Azure Quantum に接続する
| Task | Action | 注記 | 代替ユーザー アクション |
|---|---|---|---|
| Azure Quantum ワークスペースに接続する | エクスプローラーで、[ Quantum ワークスペース] を展開し、[ 既存のワークスペースの追加] を選択します。 プロンプトに従って、サブスクリプションとワークスペースを選択します。 | 複数のワークスペースに接続できます。 Quantum ワークスペースの横にある [+] を選択して、別のワークスペースに接続します。 ワークスペース接続は VS Code セッション間で保持されます。 | コマンド パレットで、[ QDK: Azure Quantum ワークスペースに接続する] を選択します。 |
| Python プログラムを使用してプログラムで接続する | 既存のワークスペース接続を右クリックし、 Copy Python コードを選択してワークスペースに接続します。 結果のコードを Python プログラムに貼り付けます。 | 詳細については、「 Azure Quantum への Q# ジョブを使用した Python の送信を参照してください。 | N/A |
プログラムを実行する
| Task | Action | 注記 | 代替ユーザー アクション |
|---|---|---|---|
| ローカル量子シミュレーターで Q# または OpenQASM プログラムを実行する |
.qsまたは.qasm ファイルで、右上にある [実行] アイコンを選択し、[実行] を選択します。 |
量子シミュレーターの詳細については、 Sparse 量子シミュレーターを参照してください。 | Ctrl キーを押しながら F5 キーを押すか、[QDK: ファイルの実行とヒストグラムの表示] または [QDK: コマンド パレットでのファイルの実行と回路図の表示] を選択するか、エントリ ポイント操作の上にある [コード レンズの実行] オプションを選択します。 |
| プログラムをデバッグする | Q# または OpenQASM プログラムで、右上にある [実行 ] アイコンを選択し、[ デバッグの開始] を選択します。 | VS Code の Q# デバッガーの詳細については、「 量子コードのデバッグとテストを参照してください。 | F5 キーを押すか、エントリ ポイント操作の上にあるメニューからコード デバッグ コード レンズを選択します。 |
| ワークスペース内のプロバイダーとターゲットを表示する | エクスプローラーで [ Quantum ワークスペース] を選択し、ワークスペースを展開し、[ プロバイダー ] を展開して、ワークスペースで使用可能なプロバイダーを表示します。 個々のプロバイダーを展開して、使用可能なターゲットを表示します。 | ジョブを送信する前に、ターゲット名にカーソルを合わせると 、その状態 と キューの時刻 が表示されます。 | N/A |
| Azure Quantum にジョブを送信する | Q# または OpenQASM プログラムで、ワークスペース、プロバイダー、およびターゲットを選択します。 現在のプログラムを送信するには、ターゲットの横にある矢印を選択します。 | 詳細については、「 Azure Quantum への Q# ジョブの送信を参照してください。 | N/A |
| ジョブの結果を表示する | ワークスペースを展開し、 Jobs を展開します。 Azure Storage からのジョブ出力を開くには、ジョブ名の横にあるクラウド アイコンを選択します。 | ジョブは、最新のものから最も古いものまで一覧表示されます。 | N/A |