Dokumentacja: Rozszerzenie Zestawu Microsoft Quantum Development Kit dla programu Visual Studio Code

Zestaw Microsoft Quantum Development Kit (QDK) korzysta ze standardowych funkcji Visual Studio Code (VS Code) wraz z funkcjami specyficznymi dla języka podczas pracy z plikami .qs lub .qasm. W tym przewodniku informacyjnym opisano wszystkie polecenia zestawu QDK, do których można uzyskać dostęp w palecie poleceń programu VS Code, wraz z innymi funkcjami i linkami do dodatkowej zawartości. Aby uzyskać ogólne wskazówki dotyczące programu VS Code, zobacz dokumentację programu VS Code.

Wskazówka

Większość poleceń z rozszerzenia QDK jest dostępnych z menu Widok > Paleta Poleceń. W pliku .qs lub .qasm otwórz paletę poleceń i wprowadź QDK:, aby zobaczyć filtrowaną listę poleceń.

Komendy

Większość poleceń zestawu QDK jest związanych z pisaniem i uruchamianiem programów Q# i OpenQASM i są dostępne tylko wtedy, gdy plik .qs lub .qasm jest aktywny. Inne polecenia działają w tle i nie są dostępne w palecie poleceń.

W poniższej tabeli opisano polecenia z rozszerzenia QDK, które są wyświetlane w palecie poleceń.

Wskazówka

Możesz tworzyć niestandardowe skróty klawiaturowe dla poleceń programu VS Code przy użyciu skrótów klawiaturowych lub Ctrl + K + S. Aby uzyskać więcej informacji, zobacz Powiązania kluczy dla programu VS Code.

Command	Action	Notatki	Akcja alternatywnego użytkownika
Zestaw QDK: tworzenie projektu języka Q#	Tworzy projekt języka Q# w aktywnym folderze, zawierając plik manifestu qsharp.json oraz podfolder src z domyślnym plikiem main.qs.	Aby uzyskać więcej informacji na temat projektów języka Q#, zobacz Praca z projektami języka Q#.	W Eksplorator plików kliknij prawym przyciskiem myszy folder docelowy i wybierz pozycję Utwórz projekt języka Q#.
QDK: Utwórz notatnik Microsoft Quantum	Otwiera przykładowy notes Jupyter Notebook, który uruchamia program Q# i Python oraz wysyła zadanie do usługi Azure Quantum.	Aby uzyskać więcej informacji na temat zestawu QDK w Jupyter Notebook, zobacz Wysyłanie zadań do Azure Quantum z Jupyter Notebook.	N/A
QDK: połączenie z przestrzenią roboczą Azure Quantum	Nawiąż połączenie z obszarem roboczym usługi Azure Quantum przy użyciu konta platformy Azure lub ciągu połączenia. Po uwierzytelnieniu Twój obszar roboczy pojawi się w Eksploratorze plików w Quantum Workspaces.	Aby uzyskać więcej informacji na temat połączeń usługi Azure Quantum, zobacz Connect to your Azure Quantum workspace (Nawiązywanie połączenia z obszarem roboczym usługi Azure Quantum).	W Eksploratorze plików umieść kursor nad Obszarami roboczymi Quantum i wybierz ikonę plus.
QDK: Otwórz plac zabaw QDK	Otwiera folder online przykładowych programów Q# i OpenQASM w Eksploratorze plików. Programy można edytować i uruchamiać w lokalnym symulatorze kwantowym, a także ustawiać punkty przerwania i przechodzić przez kod za pomocą wbudowanego debugera.	Aby uzyskać więcej informacji, zobacz plik README w folderze przykładowym.	N/A
QDK: Odśwież obszary robocze usługi Azure Quantum	Synchronizuje najnowsze zmiany z połączonych obszarów roboczych kwantowych.	Jeśli występuje problem z połączeniem, obok nazwy obszaru roboczego zostanie wyświetlona ikona alertu.	W Eksploratorze plików umieść kursor na obszarach roboczych kwantowych i wybierz ikonę odświeżania.
Explorer: Skup się na widoku Quantum Workspaces	Otwiera Eksplorator plików i koncentruje się na połączonych obszarach roboczych kwantowych, jeśli zostały skonfigurowane. Jeśli nie skonfigurowano żadnych obszarów roboczych, zostanie wyświetlony monit o dodanie istniejącego obszaru roboczego.	Aby uzyskać więcej informacji na temat połączeń usługi Azure Quantum, zobacz Connect to your Azure Quantum workspace (Nawiązywanie połączenia z obszarem roboczym usługi Azure Quantum).	N/A

Następujące polecenia są dostępne, gdy plik .qs lub .qasm jest aktywny.

Command	Action	Notatki	Akcja alternatywnego użytkownika
QDK: Pokaż obwód	Przedstawia diagram obwodu programu przed jego uruchomieniem.	Aby uzyskać więcej informacji, zobacz Wizualizowanie diagramów obwodów kwantowych.	Wybierz opcję kodu Circuit z menu obok operacji w punkcie wejścia lub nad każdą operacją zdefiniowaną przez użytkownika w programie.
QDK: Uruchamianie pliku i wyświetlanie histogramu	Uruchamia bieżący program i wyświetla histogram wyników w nowym okienku.	Aby uzyskać dostęp do opcji sortowania i filtrowania dla wyświetlania histogramu, wybierz ikonę filtru w okienku histogramu.	Wybierz opcję Histogram z menu obok operacji punktu wejściowego.
QDK: Uzyskaj QIR dla aktualnego programu QDK	Otwiera źródło QIR dla bieżącego kodu Q# lub OpenQASM w nowym oknie edycji. Aby wyeksportować źródło QIR, program musi używać profilu docelowego Base, Adaptive RI lub Adaptive RIF.	Aby uzyskać więcej informacji na temat QIR, zobacz Quantum intermediate representation (Reprezentacja pośrednia kwantowa) i blog dla deweloperów zestawu QDK.	N/A
QDK: Oblicz oszacowania zasobów	Wywołuje wbudowaną wersję narzędzia do szacowania zasobów.	Aby uzyskać więcej informacji, zobacz Wprowadzenie do narzędzia do szacowania zasobów Microsoft Quantum.	N/A
QDK: Pomoc	Krótkie omówienie rozszerzenia QDK w programie VS Code.	Aby uzyskać pełną dokumentację usługi Microsoft Quantum, zobacz dokumentację usługi Microsoft Quantum.	N/A
Zestaw QDK: Uruchamianie pliku i wyświetlanie diagramu obwodu	Uruchamia bieżący program i wyświetla obwód programu z danymi wyjściowymi.	Aby uzyskać więcej informacji, zobacz Wizualizowanie diagramów obwodów kwantowych.	N/A
QDK: Pokaż dokumentację interfejsu API	Otwiera dokumentację interfejsu API w nowym okienku. Aby wyszukać to okienko, naciśnij Ctrl + F.	Aby uzyskać więcej informacji, zobacz dokumentację interfejsu API kwantowego Microsoft.	N/A
QDK: Pokaż dziennik zmian	Otwiera dziennik zmian na nowej karcie zawierającej aktualizacje zestawu QDK dla bieżących i wszystkich poprzednich wersji.	Dziennik zmian jest również dostępny w repozytorium GitHub zestawu QDK typu open source.	N/A
Debugowanie: rozpoczynanie debugowania	Otwiera bieżący program w debugerze.	Aby uzyskać więcej informacji, zobacz Debugowanie i testowanie kodu kwantowego.	Naciśnij F5 lub wybierz opcję Obiektyw kodu Debuguj z menu obok operacji punktu wejścia lub wybierz ikonę Uruchom w prawym górnym rogu i wybierz pozycję Rozpocznij debugowanie.
Debugowanie: Uruchom	Uruchamia bieżący program w domyślnym symulatorze kwantowym.	Aby uzyskać więcej informacji, zobacz Wprowadzenie do programów języka Q#.	Naciśnij Ctrl + F5 lub wybierz opcję Obiektyw kodu Uruchom z menu obok operacji punktu wejścia lub wybierz ikonę Uruchom w prawym górnym rogu, a następnie wybierz polecenie Uruchom.

Terminale

Programy Q# i OpenQASM korzystają z dwóch okien terminalowych w programie VS Code:

Terminal	Action
Konsola debugowania	Wyświetla wynik działania lub dane wyjściowe debugowania
Problemy	Wyświetla wstępnie skompilowane testy błędów

Edytowanie kodu Q# i OpenQASM

Większość typowych funkcji edytowania kodu w programie VS Code jest również dostępna podczas pracy z programami Q# i OpenQASM:

• Sprawdzanie błędów prekompilacji
• Przejdź do definicji
• References
• Podpisy funkcji
• Informacje o parametrze
• Sugestie ukończenia, w tym informacje o kontekście, składowa przestrzeni nazw i uzupełnianie składowych typu.
• Linting — w plikach języka Q# konfigurujesz linting per-project w pliku manifestu. Aby uzyskać więcej informacji, zobacz Praca z projektami języka Q#.

Aby uzyskać więcej informacji, zobacz Intellisense w dokumentacji programu VS Code.

Typowe zadania

Praca z plikami i projektami języka Q#

Zadanie	Action	Notatki
Nowy plik języka Q#	Wybierz Plik > Nowy plik > Tekstowy. Zapisz plik z rozszerzeniem .qs.	Jeśli ustawisz Files: Default Language = qsharp, nowy plik automatycznie będzie miał formatowanie Q# jako domyślne.
Tworzenie projektu w języku Q#	W otwartym folderze w Eksplorator plików wybierz pozycję Utwórz projekt języka Q# z palety poleceń lub kliknij prawym przyciskiem myszy folder w Eksplorator plików i wybierz polecenie Utwórz projekt języka Q#.	Aby uzyskać więcej informacji na temat projektów języka Q#, zobacz Praca z projektami języka Q#.
Przykładowe pliki	W pustym .qs lub .qasm wpisz przykłady, a następnie wybierz przykładowy program z listy opcji.	Możesz również wybrać pozycję Otwórz plac zabaw zestawu QDK w palecie poleceń, aby otworzyć folder online przykładowych programów Q# i OpenQASM w Eksploratorze plików.

Nawiązywanie połączenia z usługą Azure Quantum

Zadanie	Action	Notatki	Akcja alternatywnego użytkownika
Nawiązywanie połączenia z obszarem roboczym usługi Azure Quantum	W Eksploratorze plików rozwiń Quantum Workspaces i wybierz Dodaj istniejący obszar roboczy. Postępuj zgodnie z monitami, aby wybrać subskrypcję i obszar roboczy.	Możesz nawiązać połączenie z wieloma obszarami roboczymi. Wybierz pozycję + obok pozycji Obszary robocze kwantowe , aby połączyć inny obszar roboczy. Połączenia obszaru roboczego utrzymują się między sesjami programu VS Code.	Z palety poleceń wybierz pozycję QDK: Połącz się z obszarem roboczym usługi Azure Quantum.
Programistyczne łączenie za pomocą programu w Pythonie	Kliknij prawym przyciskiem myszy istniejące połączenie obszaru roboczego i wybierz polecenie Kopiuj kod języka Python, aby nawiązać połączenie z obszarem roboczym. Wklej wynikowy kod do programu w języku Python.	Aby uzyskać więcej informacji, zobacz Przesyłanie języka Python z zadaniami języka Q# do usługi Azure Quantum.	N/A

Uruchamianie programów

Zadanie	Action	Notatki	Akcja alternatywnego użytkownika
Uruchamianie programu Q# lub OpenQASM w lokalnym symulatorze kwantowym	W pliku .qs lub .qasm wybierz ikonę Uruchom w prawym górnym rogu, a następnie wybierz pozycję Uruchom.	Aby uzyskać więcej informacji na temat symulatora kwantowego, zobacz Rozrzedny symulator kwantowy.	Naciśnij Ctrl + F5, lub wybierz QDK: Uruchom plik i pokaż histogram lub QDK: Uruchom plik i pokaż diagram obwodu w Palecie Poleceń, lub wybierz opcję Run Code Lens powyżej operacji punktu wejścia.
Debugowanie programu	W programie Q# lub OpenQASM wybierz ikonę Uruchom w prawym górnym rogu, a następnie wybierz pozycję Rozpocznij debugowanie.	Aby uzyskać więcej informacji na temat debugera języka Q# w programie VS Code, zobacz Debugowanie i testowanie kodu kwantowego.	Naciśnij F5 lub wybierz soczewkę debugowania kodu z menu nad operacją punktu wejścia.
Zobacz dostawców i cele w swoich obszarach roboczych	W Eksploratorze plików wybierz pozycję Obszary robocze kwantowe, rozwiń obszar roboczy, a następnie rozwiń węzeł Dostawcy , aby wyświetlić dostępnych dostawców w obszarze roboczym. Rozwiń pojedynczego dostawcę, aby wyświetlić dostępne cele.	Umieść kursor na nazwie docelowej, aby wyświetlić jej stan i czas kolejki przed przesłaniem zadania.	N/A
Przesyłanie zadania do usługi Azure Quantum	W programie Q# lub OpenQASM wybierz obszar roboczy, dostawcę oraz cel. Aby przesłać bieżący program, wybierz strzałkę obok obiektu docelowego.	Aby uzyskać więcej informacji, zobacz Przesyłanie zadań języka Q# do usługi Azure Quantum.	N/A
Wyświetlanie wyników zadania	Rozwiń obszar roboczy, a następnie rozwiń Zadania. Aby otworzyć dane wyjściowe zadania z usługi Azure Storage, wybierz ikonę chmury obok nazwy zadania.	Zadania są wyświetlane od najnowszych do najstarszych.	N/A