Udostępnij przez

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 Code (VS Code) wraz z funkcjami specyficznymi dla języka Q# podczas pracy z plikami .qs . 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.

Napiwek

Większość poleceń z rozszerzenia QDK jest dostępnych z menu Widok > Paleta Poleceń. W pliku .qs otwórz paletę poleceń i wpisz QDK: aby wyświetlić przefiltrowaną listę poleceń.

Polecenia

Większość poleceń zestawu QDK jest związana z pisaniem i uruchamianiem .qs programów w języku Q# i jest dostępna tylko wtedy, gdy plik 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ń.

Napiwek

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.

Polecenie Akcja Uwagi 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 notebook Azure 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 notesów usługi Azure Quantum, zobacz Praca z notesami usługi Azure Quantum. Nie dotyczy
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 języka Q# 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. Nie dotyczy
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). Nie dotyczy

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

Polecenie Akcja Uwagi Akcja alternatywnego użytkownika
QDK: 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ę 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 języka Q# 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 języka Q# 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 języka QIR, zobacz Quantum intermediate representation (Reprezentacja pośrednia kwantowa) i blog dla deweloperów języka Q#. Nie dotyczy
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 usługi Azure Quantum. Nie dotyczy
QDK: 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
Zestaw QDK: 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
QDK: Dodaj plik instrukcji Copilot dla języka Q# i OpenQASM Otwiera okno dialogowe z opcją dodania instrukcji Copilot, które ułatwiają pisanie i uruchamianie kodu Q# i OpenQASM. Aby uzyskać więcej informacji, zobacz Konfigurowanie trybu agenta w programie VS Code dla zestawu Quantum Development Kit. Nie dotyczy
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 usługi Azure Quantum. Nie dotyczy
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. Nie dotyczy
Debugowanie: rozpoczynanie debugowania Otwiera bieżący program języka Q# 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 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 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 języka Q# korzystają z dwóch okien terminalowych w programie VS Code:

Terminal Akcja
Konsola debugowania Wyświetla wynik działania 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 również dostępna podczas pracy z programami języka Q#:

  • Sprawdzanie błędów prekompilacji
  • Przejdź do definicji
  • Bibliografia
  • 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 Akcja Uwagi
Nowy plik języka Q# Wybierz Plik > Nowy plik > Tekstowy. Zapisz plik z .qs rozszerzeniem. 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 pliku wprowadź 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 języka Q# w Eksploratorze 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 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. 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. 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 języka Q# 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. Nie dotyczy
Przesyłanie zadania do usługi Azure Quantum W programie języka Q# wybierz obszar roboczy, dostawcę 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ń 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. Nie dotyczy
  • Last updated on