Azure Quantum 開發套件 （QDK） 會在您使用 .qs 檔案時使用 Visual Studio Code （VS Code） 的所有標準功能，以及 Q# 特定功能。 本參考指南說明您可以在 VS Code 命令選項板中存取的所有 QDK 命令，以及其他功能和其他內容的連結。 如需一般 VS Code 指引，請參閱 VS Code 檔。
提示
QDK 延伸模組中的大多數指令都可以從 「檢視 > 指令選項板 」功能表存取。 在檔案中 .qs ，開啟「命令選項板」並輸入 QDK： 以檢視篩選的命令清單。
命令
大部分的 QDK 命令都與撰寫和執行 Q# 程式有關，而且只有在檔案處於作用中狀態時 .qs 才能使用。 其他命令在背景運作，無法在命令面板中存取。
下表說明 QDK 延伸模組中顯示在「命令選項板」中的命令。
提示
您可以使用 鍵盤快速鍵或 Ctrl + K + S 為 VS Code 命令建立自訂鍵盤快速鍵。如需詳細資訊，請參閱 VS Code 的索引鍵繫結。
| 命令 | 動作 | 備註 | 替代使用者操作 |
|---|---|---|---|
| QDK：建立 Q# 專案 | 在作用中資料夾中建立 Q# 專案，包括 qsharp.json 資訊清單檔案和 src 具有預設 main.qs 檔案的子資料夾。 |
如需 Q# 專案的詳細資訊，請參閱 使用 Q# 專案。 | 在 檔案總管 中，以滑鼠右鍵按兩下目標資料夾，然後選取 [建立 Q# 專案]。 |
| QDK：建立 Azure Quantum 筆記本 | 開啟執行 Q# + Python 程式的範例 Jupyter Notebook，並將作業提交至 Azure Quantum。 | 如需 Azure Quantum Notebook 的詳細資訊，請參閱使用 Azure Quantum Notebook。 | N/A |
| QDK：連線到 Azure Quantum 工作區 | 使用 Azure 帳戶或 連接字串 連線到 Azure Quantum 工作區。 驗證之後，您的工作區會出現在Quantum 工作空間的文件總管中。 | 如需 Azure Quantum 連線的詳細資訊，請參閱 連線到您的 Azure Quantum 工作區。 | 在檔案總管中，將滑鼠停留在 Quantum 工作區 上，然後選取 + 圖示。 |
| QDK：開啟 QDK 遊樂場 | 在 檔案總管 中開啟 Q# 範例程式的在線資料夾。 您可以在本機量子模擬器中編輯和執行程式，以及使用內建調試程式設定斷點並逐步執行程序代碼。 | 如需詳細資訊，請參閱 範例資料夾中的自述檔 。 | N/A |
| QDK：重新整理 Azure Quantum 工作區 | 同步連線量子工作區的最新變更。 | 如果發生連線問題，工作區名稱旁邊會出現警示圖示。 | 在檔案總管中，將滑鼠停留在 Quantum 工作區 上，然後選取重新整理圖示。 |
| 瀏覽器：聚焦於量子工作區視圖 | 開啟 檔案總管，並在設定時將焦點放在連線的量子工作區上。 如果未設定任何工作區，系統會提示您新增現有的工作區。 | 如需 Azure Quantum 連線的詳細資訊，請參閱 連線到您的 Azure Quantum 工作區。 | N/A |
.qs 檔案處於作用中時，可以使用以下命令。
| 命令 | 動作 | 備註 | 替代使用者操作 |
|---|---|---|---|
| QDK：顯示電路 | 在執行前顯示 Q# 程式的電路圖。 | 如需詳細資訊，請參閱 可視化量子電路圖。 | 從進入點作業旁的選單選取程式代碼鏡頭選項 [線路 ]，或在程式中的每個使用者定義作業上方選取 。 |
| QDK：執行檔案並顯示直方圖 | 執行目前的 Q# 程式，並在新窗格中顯示結果的直方圖。 | 若要存取直方圖顯示的排序和篩選選項，請選取直方圖窗格中的篩選圖示。 | 從入口作業旁的功能表中選取程式碼鏡片選項直方圖。 |
| QDK：取得目前 QDK 程式的 QIR | 在新編輯視窗中開啟目前 Q# 程式代碼的 QIR 來源。 您的程式必須使用「基本」、「調適型 RI」或「調適型 RIF」目標設定檔來匯出 QIR 來源。 | 如需 QIR 的詳細資訊，請參閱 量子中繼表示法和 Q# 開發人員部落格。 | N/A |
| QDK：計算資源估算 | 叫用資源估算器的內建版本。 | 如需詳細資訊，請參閱 Azure Quantum Resource Estimator 簡介。 | N/A |
| QDK：說明 | VS Code 中 QDK 延伸模組的簡短概觀。 | 如需完整的 Azure Quantum 檔，請參閱 Azure Quantum 檔。 | N/A |
| QDK：運行文件並顯示電路圖 | 執行目前的 Q# 程式，並顯示具有輸出的程式線路。 | 如需詳細資訊，請參閱 可視化量子電路圖。 | N/A |
| QDK：新增 Q# 和 OpenQASM 的 Copilot 指示檔案 | 開啟提示，讓您選擇新增 Copilot 指示，以協助您撰寫和執行 Q# 和 OpenQASM 程式碼。 | 如需詳細資訊，請參閱 在 VS Code 中設定 Quantum 開發套件的代理程式模式。 | N/A |
| QDK：顯示 API 文件 | 在新窗格中開啟 API 檔。 若要搜尋此窗格，請按 Ctrl + F。 | 如需詳細資訊，請參閱 Azure Quantum API 參考。 | N/A |
| QDK：顯示變更日誌 | 在新選項卡中打開一個變更日誌，其中顯示當前和所有以前版本的 QDK 更新。 | 變更日誌也可在開源 QDK GitHub 儲存庫中找到。 | N/A |
| 偵錯：開始偵錯 | 在調試程式中開啟目前的 Q# 程式。 | 如需詳細資訊，請參閱 偵錯和測試量子程序代碼。 | 按 F5，或從進入點作業旁邊的功能表中選取程式碼鏡頭選項 [偵錯 ]，或選取右上方的 [執行] 圖示，然後選擇 [開始偵錯]。 |
| 偵錯：執行 | 在預設量子模擬器中執行目前的 Q# 程式。 | 如需詳細資訊，請參閱 開始使用 Q# 程式。 | 按 Ctrl + F5，或從進入點作業旁邊的功能表中選取程式碼鏡頭選項 [執行 ]，或選取右上角的 [執行] 圖示，然後選擇 [執行]。 |
終端
Q# 程式會在 VS Code 中使用兩個終端機視窗：
| 終端機 | 動作 |
|---|---|
| 偵錯主控台 | 顯示執行輸出或偵錯輸出 |
| 問題 | 顯示編譯前的錯誤檢查 |
編輯 Q# 程式碼
當您使用 Q# 程式時，VS Code 中的大部分常見程式碼編輯功能也可供使用：
- 預編譯錯誤檢查
- 跳至定義
- 參考資料
- 函式簽名
- 參數資訊
- 完成提示，包括上下文感知、名稱空間成員及類別成員的完成建議。
- Linting - 在 Q# 檔案中，您會在指令清單檔案中設定每個專案的 Linting。 如需詳細資訊，請參閱 使用 Q# 專案。
如需詳細資訊，請參閱 VS Code 檔中的 Intellisense 。
常見工作
使用 Q# 檔案和專案
| 任務 | 動作 | 備註 |
|---|---|---|
| 新增 Q# 檔案 | 選取 檔案 > 新檔案 > 文字檔案。 將檔案儲存為 .qs 副檔名。 |
如果您設定 Files: Default Language = qsharp，新檔案會自動預設為 Q# 格式。 |
| 建立 Q# 專案 | 從 檔案總管 的開啟資料夾中，從 [命令選擇區] 選取 [建立 Q# 專案]，或以滑鼠右鍵按兩下 檔案總管 中的資料夾，然後選取 [建立 Q# 專案]。 | 如需 Q# 專案的詳細資訊，請參閱 使用 Q# 專案。 |
| 範例檔案 | 在空白 .qs 檔案中，輸入 範例，然後從選項清單中選取範例程式。 |
您也可以選取 [命令面板] 中的 [ 開啟 QDK 遊樂場 ]，以在檔案總管中開啟 Q# 範例程式的線上資料夾。 |
連線到 Azure Quantum
| 任務 | 動作 | 備註 | 替代使用者操作 |
|---|---|---|---|
| 聯機到 Azure Quantum 工作區 | 在檔案總管中，展開 [Quantum 工作區] ，然後選取 [ 新增現有的工作區]。 依照提示選取訂用帳戶和工作區。 | 您可以連線到多個工作區。 選取 Quantum 工作區旁的 + 以連線另一個工作區。 您的 VS Code 工作階段之間的工作區連線會持續存在。 | 從 [命令面板] 中，選取 [QDK：連線到 Azure Quantum 工作區]。 |
| 以程序設計方式與 Python 程式連線 | 以滑鼠右鍵按兩下現有的工作區連線，然後選取 [ 複製 Python 程式代碼] 以連線到工作區。 將產生的程式代碼貼到 Python 程式中。 | 如需詳細資訊，請參閱 將 Python 與 Q# 作業提交至 Azure Quantum。 | N/A |
執行程式
| 任務 | 動作 | 備註 | 替代使用者操作 |
|---|---|---|---|
| 在本機量子模擬器上執行 Q# 程式 | 在 Q# 程式中，選取右上方的 [執行] 圖示，然後選取 [執行]。 | 如需量子模擬器的詳細資訊，請參閱 疏鬆量子模擬器。 | 按 Ctrl + F5，或選擇 [QDK：執行檔案並顯示直方圖 ] 或 [QDK：執行檔案並顯示電路圖 ] 在命令面板中，或選擇進入點作業上方的 [執行 程式碼透鏡] 選項。 |
| 偵錯程式 | 在 Q# 程式中，選取右上方的 [執行] 圖示，然後選擇 [開始偵錯]。 | 如需 VS Code 中 Q# 調試程式的詳細資訊，請參閱 偵錯和測試量子程式代碼。 | 按 F5，或從進入點作業上方的功能表中選擇 Debug 程式碼透鏡。 |
| 在工作區中檢視提供者和目標 | 在檔案總管中，選取 [量子工作區]，展開工作區，然後展開 [提供者] 以查看工作區中可用的提供者。 展開個別提供者以檢視可用的目標。 | 將滑鼠停留在目標名稱上，以檢視其 狀態 和 佇列時間 ，然後再提交工作。 | N/A |
| 將作業提交至 Azure Quantum | 在 Q# 程式中，選取工作區、提供者和目標。 若要提交目前的 Q# 程式，請選取目標旁的箭號。 | 如需詳細資訊，請參閱 將 Q# 作業提交至 Azure Quantum。 | N/A |
| 檢視作業結果 | 展開工作區，然後展開 [ 作業]。 若要從 Azure 儲存體 開啟作業輸出，請選取作業名稱旁的雲端圖示。 | 工作會從最新到最舊列出。 | N/A |