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