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 referencyjnym opisano główne 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.

Większość poleceń z rozszerzenia QDK jest dostępnych z menu Widok > Paleta Poleceń. Otwórz paletę poleceń i wprowadź QDK: aby wyświetlić filtrowaną listę poleceń w .qspliku , .qasmlub .qsc .

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.

Komendy

Wiele poleceń zestawu QDK jest związanych z pisaniem i uruchamianiem programów Q# i OpenQASM i są dostępne tylko wtedy, gdy .qsplik , .qasmlub .qsc jest aktywny. Inne polecenia są ogólnie dostępne.

Polecenia ogólne

Command	Action	Notatki	Akcja alternatywnego użytkownika
QDK: Utwórz projekt w języku 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 Przesyłanie zadań do Azure Quantum przy użyciu pakietu zestawu QDK Python.	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 wybierz ikonę panelu kwantowego Microsoft (w lewym dolnym rogu).	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).	Najedź kursorem na obszar Quantum workspaces i wybierz ikonę ＋.
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.	Zatrzymaj wskaźnik myszy na obszarach roboczych kwantowych i wybierz ikonę odświeżania.
QDK: Utworzyć wirtualne środowisko języka Python dla Microsoft Quantum	Tworzy folder i instaluje środowisko wirtualne Python z wybranymi pakietami.	Dostępne w programie VS Code dla komputerów stacjonarnych, ale nie w programie VS Code dla sieci Web.	N/A
QDK: sfera Bloch	Otwiera wizualizator sfer Bloch.	Aby uzyskać więcej informacji, zobacz How to use the Bloch sphere visualizer in the QDK (Jak używać wizualizatora sfer Bloch w zestawie QDK).	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
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

Polecenia dostępne w zależności od aktywnego typu pliku

Command	Typy plików programu	Action	Notatki	Akcja alternatywnego użytkownika
QDK: Pokaż obwód	.qs, .qasm	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	.qs, .qasm	Uruchamia bieżący program i wyświetla histogram wyników w nowym okienku.	Aby uzyskać dostęp do opcji sortowania i filtrowania, wybierz ikonę filtru w okienku histogramu.	Wybierz opcję Histogram z menu obok operacji punktu wejściowego.
QDK: Uzyskaj QIR dla aktualnego programu QDK	.qs, .qasm	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 and the QDK developer blog ( Reprezentacja pośrednia kwantowa ) i blog dla deweloperów zestawu QDK.	N/A
QDK: Oblicz oszacowania zasobów	.qs, .qasm	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	.qs	Otwiera krótkie omówienie rozszerzenia QDK w programie VS Code.	N/A	N/A
Zestaw QDK: Uruchamianie pliku i wyświetlanie diagramu obwodu	.qs, .qasm	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	.qs	Otwiera dokumentację interfejsu API w nowym okienku. Aby wyszukać to okienko, naciśnij Ctrl + F.	Aby uzyskać więcej informacji, zobacz dokumentację interfejsu API języka Q#.	N/A
Debugowanie: rozpoczynanie debugowania	.qs, .qasm, .qsc	Otwiera bieżący program w debugerze.	Aby uzyskać więcej informacji, zobacz Debugowanie i testowanie kodu kwantowego.	Naciśnij klawisz F5, wybierz opcję obiektywu kodu Debuguj obok operacji punktu wejścia lub wybierz ikonę Uruchom w prawym górnym rogu, a następnie wybierz pozycję Rozpocznij debugowanie.
QDK: Uruchamianie programu	.qs, .qasm, .qsc	Uruchamia bieżący program w domyślnym symulatorze kwantowym.	Aby uzyskać więcej informacji, zobacz Wprowadzenie do programów języka Q#.	Naciśnij klawisze Ctrl + F5, wybierz opcję CodeLens Uruchom obok operacji będącej punktem wejścia albo wybierz ikonę Uruchom w prawym górnym rogu, a następnie wybierz pozycję Uruchom.

Widoki panelu

Programy Q# i OpenQASM korzystają z następujących widoków w panelu programu VS Code:

View	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 autouzupełniania, w tym sugestie zależne od kontekstu, elementy członkowskie przestrzeni nazw i elementy członkowskie 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

Poniższe tabele zawierają listę poleceń dla typowych zadań podczas pracy z rozszerzeniem QDK.

Praca z plikami i projektami języka Q#

Zadanie	Action	Notatki
Tworzenie nowego pliku 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 Eksploratorze plików wybierz pozycję QDK: Utwórz projekt Q# z palety poleceń lub kliknij prawym przyciskiem myszy folder w Eksploratorze 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#.
Tworzenie przykładowego pliku	W pustym .qs lub .qasm wpisz przykłady, a następnie wybierz przykładowy program z listy opcji.	Możesz również wybrać QDK: Otwórz środowisko testowe QDK w Palecie poleceń, aby otworzyć w Eksploratorze plików folder online z przykładowymi programami Q# i OpenQASM.

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	Wybierz ikonę panelu kwantowego Microsoft (w lewym dolnym rogu). W obszarze Obszary robocze kwantowe wybierz pozycję 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 Submit jobs to Azure Quantum with the QDK Python package (Przesyłanie zadań do Azure Quantum przy użyciu pakietu Python zestawu QDK).	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	Wybierz ikonę panelu kwantowego Microsoft (w lewym dolnym rogu). W sekcji Quantum Workspaces rozwiń obszar roboczy, a następnie rozwiń pozycję Providers, aby wyświetlić dostawców dostępnych 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 Submit jobs to Azure Quantum with the QDK extension for VS Code (Przesyłanie zadań do Azure Quantum za pomocą rozszerzenia QDK dla programu VS Code).	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