Dokumentacja: Rozszerzenie zestawu Azure Quantum Development Kit dla programu Visual Studio Code

Zestaw Azure Quantum Development Kit (QDK) używa wszystkich standardowych funkcji programu Visual Studio (VS) Code wraz z funkcjami specyficznymi dla języka Q#podczas pracy z plikami qs. Ten artykuł jest przewodnikiem referencyjnym dla wszystkich poleceń i funkcji związanych z językiem Q#, z linkami do dodatkowej zawartości zgodnie z potrzebami. Aby uzyskać ogólne wskazówki dotyczące programu VS Code, zobacz dokumentację programu VS Code.

Napiwek

Do większości poleceń związanych z językiem Q# można uzyskać dostęp z menu Widok > palety poleceń. W pliku qs wybierz Ctrl-Shift-P (Cmd-Shift-P w systemie macOS) i wprowadź ciąg Q#, aby wyświetlić filtrowaną listę poleceń.

Aby zapoznać się ze wszystkimi skrótami klawiaturowymi systemu macOS, zobacz Skróty klawiaturowe dla systemu macOS.

Polecenia

Do większości poleceń związanych z językiem Q# można uzyskać dostęp z menu Widok > palety poleceń. Wybierz Ctrl-Shift-P i wprowadź ciąg Q# , aby wyświetlić filtrowaną listę poleceń. Niektóre polecenia są dostępne tylko wtedy, gdy plik qs jest aktywny.

Napiwek

Możesz tworzyć niestandardowe skróty klawiaturowe dla dowolnego polecenia 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.

Polecenie	Akcja	Uwagi	Akcja alternatywnego użytkownika
Q#: Tworzenie projektu języka Q#	Tworzy projekt języka Q# w aktywnym folderze, w tym: * plik manifestu qsharp.json * 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#.
Q#: Tworzenie notesu usługi Azure Quantum	Otwiera przykładowy notes Jupyter Notebook z uruchomionym programem Q# i Python i przesyła zadanie do usługi Azure Quantum.	Aby uzyskać więcej informacji na temat notesów usługi Azure Quantum, zobacz Praca z notesami usługi Azure Quantum.	Nie dotyczy
Q#: Nawiązywanie połączenia z obszarem roboczym usługi Azure Quantum	Nawiąż połączenie z obszarem roboczym usługi Azure Quantum przy użyciu konta platformy Azure lub parametry połączenia. Po uwierzytelnieniu obszar roboczy zostanie wyświetlony w Eksplorator plików w obszarach roboczych kwantowych.	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 Eksplorator plików zatrzymaj wskaźnik myszy na obszarach roboczych quantum i wybierz ikonę "+".
Q#: Otwórz plac zabaw dla języka Q#	Otwiera folder online przykładowych programów języka Q# w Eksplorator 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.	Nie dotyczy
Q#: Odświeżanie obszarów roboczych 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 Eksplorator plików umieść kursor nad obszarami roboczymi quantum i wybierz ikonę odświeżania.
Explorer: Focus on Quantum Workspaces View	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).	Nie dotyczy

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

Polecenie	Akcja	Uwagi	Akcja alternatywnego użytkownika
Q#: Ustawianie profilu docelowego usługi Azure Quantum QIR	Ustawia kwantową reprezentację QIR lub kwantową reprezentację docelową dla programów języka Q#.	Aby uzyskać więcej informacji na temat profilów docelowych, zobacz Profile docelowe.	Bieżący profil docelowy jest wyświetlany na dolnym pasku narzędzi. Wybierz profil docelowy na pasku narzędzi, aby otworzyć listę rozwijaną wyboru.
Q#: Pokaż obwód	Przedstawia diagram obwodu programu języka Q# przed jego uruchomieniem.	Aby uzyskać więcej informacji, zobacz Wizualizowanie diagramów obwodów kwantowych.	Wybierz opcję Obiektyw kodu Obwód z menu obok operacji punktu wejścia lub powyżej każdej operacji zdefiniowanej przez użytkownika w programie.
Q#: Uruchamianie pliku i wyświetlanie histogramu	Uruchamia bieżący program języka Q# i wyświetla histogram wyników w okienku po prawej stronie.	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ścia.
Q#: Pobieranie QIR dla bieżącego programu q#	Otwiera źródło QIR dla bieżącego kodu języka Q# w nowym oknie edycji. Aby wyeksportować źródło QIR, program musi używać profilu docelowego podstawowego lub adaptacyjnego wystąpienia zarezerwowanego.	Aby uzyskać więcej informacji na temat języka QIR, zobacz Quantum intermediate representation (Reprezentacja pośrednia kwantowa) i blog dla deweloperów języka Q#.	Nie dotyczy
Debugowanie: Debugowanie pliku języka Q#	Otwiera bieżący program języka Q# w debugerze.	Aby uzyskać więcej informacji, zobacz Debugowanie i testowanie kodu kwantowego.	* Wybierz F5 * Wybierz opcję obiektywu kodu Debuguj z menu obok operacji punktu wejścia. * Wybierz ikonę Uruchom w prawym górnym rogu, a następnie wybierz pozycję Debuguj plik języka Q#.
Debugowanie: uruchamianie pliku języka Q#	Uruchamia bieżący program języka Q# w domyślnym symulatorze kwantowym.	Aby uzyskać więcej informacji, zobacz Wprowadzenie do programów języka Q#.	* Naciśnij Ctrl+F5 * Wybierz opcję obiektywu kodu Uruchom z menu obok operacji punktu wejścia. * Wybierz ikonę Uruchom w prawym górnym rogu, a następnie wybierz pozycję Uruchom plik Q#.
Q#: Obliczanie oszacowań 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 usługi Azure Quantum.	Nie dotyczy
Q#: Pomoc	Krótkie omówienie rozszerzenia QDK w programie VS Code.	Aby uzyskać pełną dokumentację usługi Azure Quantum, zobacz dokumentację usługi Azure Quantum.	Nie dotyczy
Q#: Uruchamianie pliku i wyświetlanie diagramu obwodu	Uruchamia bieżący program języka Q# i wyświetla obwód programu z danymi wyjściowymi.	Aby uzyskać więcej informacji, zobacz Wizualizowanie diagramów obwodów kwantowych.	Nie dotyczy
Q#: Pokaż dokumentację interfejsu API	Otwiera dokumentację interfejsu API w nowym okienku. Wyszukaj to okienko przy użyciu Ctrl-F.	Aby uzyskać więcej informacji, zobacz dokumentację interfejsu API usługi Azure Quantum.	Nie dotyczy

Terminali

Programy języka Q# korzystają z dwóch okien terminalowych w programie VS Code:

Terminal	Akcja
Konsola debugowania	Wyświetla dane wyjściowe przebiegu lub dane wyjściowe debugowania
Problemy	Wyświetla wstępnie skompilowane testy błędów

Edytowanie kodu w języku Q#

Większość typowych funkcji edytowania kodu w programie VS Code jest dostępna podczas pracy z programami języka Q#. Aby uzyskać więcej informacji, zobacz Intellisense w dokumentacji programu VS Code.

• Sprawdzanie błędów prekompiluj
• Definicja przechodzenia do
• Informacje
• Podpisy funkcji
• Informacje o parametrze
• Sugestie dotyczące ukończenia
• 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#.

Typowe zadania

Praca z plikami i projektami języka Q#

Zadanie	Akcja	Uwagi
Nowy plik języka Q#	Wybierz pozycję Plik > nowy plik >tekstowy. Zapisz plik przy użyciu rozszerzenia qs.	Jeśli ustawisz wartość , nowy plik zostanie automatycznie sformatowany Files: Default Language = qsharpw języku Q#.
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 pliku qs wprowadź przykłady, a następnie wybierz przykładowy program z listy.	Możesz również wybrać pozycję Otwórz plac zabaw w języku Q# w palecie poleceń, aby otworzyć folder online przykładowych programów języka Q# w Eksplorator plików.

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

Zadanie	Akcja	Uwagi	Akcja alternatywnego użytkownika
Nawiązywanie połączenia z obszarem roboczym usługi Azure Quantum	W Eksplorator plików rozwiń węzeł Obszary robocze kwantowe i wybierz pozycję Dodaj istniejący obszar roboczy. Postępuj zgodnie z monitami, aby wybrać subskrypcję i obszar roboczy.	* Możesz połączyć się z wieloma obszarami roboczymi. Wybierz pozycję "+" obok pozycji Obszary robocze kwantowe, aby połączyć inny obszar roboczy. Połączenia obszaru roboczego są utrwalane między sesjami programu VS Code. * Aby usunąć połączenie obszaru roboczego, kliknij prawym przyciskiem myszy obszar roboczy i wybierz polecenie Usuń połączenie obszaru roboczego.	W palecie poleceń wybierz pozycję Połącz z obszarem roboczym usługi Azure Quantum.
Programowe łączenie z programem w języku Python	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.	Nie dotyczy

Uruchamianie programów

Zadanie	Akcja	Uwagi	Akcja alternatywnego użytkownika
Uruchamianie programu języka Q# w lokalnym symulatorze kwantowym	W programie języka Q# wybierz ikonę Uruchom w prawym górnym rogu, a następnie wybierz pozycję Uruchom plik Q#.	Aby uzyskać więcej informacji na temat symulatora kwantowego, zobacz symulator kwantowy Rozrzedny.	* Naciśnij Ctrl-F5 * Z palety poleceń wybierz pozycję Q#: Uruchom plik i pokaż histogram lub Q#: Uruchom plik i pokaż diagram obwodu * Wybierz opcję obiektywu kodu Uruchom z menu obok operacji punktu wejścia.
Debugowanie programu	W programie języka Q# wybierz ikonę Uruchom w prawym górnym rogu, a następnie wybierz pozycję Debuguj plik języka Q#.	Aby uzyskać więcej informacji na temat debugera języka Q# w programie VS Code, zobacz Debugowanie i testowanie kodu kwantowego.	* Wybierz F5 * Wybierz opcję obiektywu kodu Debuguj z menu obok operacji punktu wejścia.
Wyświetlanie dostawców i obiektów docelowych w obszarach roboczych	W Eksplorator 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 elementy docelowe.	Uwaga: Umieść kursor nad nazwą docelową, aby wyświetlić jej stan i czas kolejki przed przesłaniem zadania.	Nie dotyczy
Przesyłanie zadania do usługi Azure Quantum	W programie języka Q# wybierz obszar roboczy, dostawca i element docelowy. Aby przesłać bieżący program w języku Q#, wybierz strzałkę obok obiektu docelowego.	Aby uzyskać więcej informacji, zobacz Przesyłanie zadań języka Q# do usługi Azure Quantum.	Nie dotyczy
Wyświetlanie wyników zadania	Rozwiń obszar roboczy, a następnie rozwiń węzeł Zadania. Aby otworzyć dane wyjściowe zadania z usługi Azure Storage, wybierz ikonę chmury obok nazwy zadania.	Zadania są wyświetlane na liście z najnowszymi na górze.	Nie dotyczy