Referencia: Azure Quantum Development Kit-bővítmény a Visual Studio Code-hoz
Az Azure Quantum Development Kit (QDK) a Visual Studio (VS) Code összes szabványos funkcióját, valamint a Q#-specifikus funkciókat használja a .qs-fájlok használatakor. Ez a cikk referencia-útmutató a Q#-hoz kapcsolódó összes parancshoz és funkcióhoz, szükség esetén további tartalmakra mutató hivatkozásokkal. Általános VS Code-útmutatásért tekintse meg a VS Code dokumentációját.
Tipp.
A Q#-tal kapcsolatos parancsok többsége a Parancskatalógus megtekintése > menüből érhető el. A .qs-fájlban válassza a Ctrl-Shift-P (Cmd-Shift-P macOS rendszeren) lehetőséget, és írja be a Q# -t a parancsok szűrt listájának megtekintéséhez.
A macOS összes billentyűparancsát a macOS billentyűparancsai között találhatja meg.
Parancsok
A Q#-tal kapcsolatos parancsok többsége a Parancskatalógus megtekintése > menüből érhető el. Válassza a Ctrl-Shift-P billentyűkombinációt, és írja be a Q#-t a parancsok szűrt listájának megtekintéséhez. Egyes parancsok csak akkor érhetők el, ha egy .qs-fájl aktív.
Tipp.
Bármely VS Code-parancshoz létrehozhat egyéni billentyűparancsokat billentyűparancsokkal vagy Ctrl+K+S billentyűkombinációkkal. További információ: A VS Code kulcskötései.
| Parancs | Művelet | Jegyzetek | Másodlagos felhasználói művelet |
|---|---|---|---|
| Q#: Q#-projekt létrehozása | Létrehoz egy Q#-projektet az aktív mappában, beleértve a következőket: * egy qsharp.json jegyzékfájl * egy src almappát egy alapértelmezett main.qs fájllal. |
A Q#-projektekről további információt a Q#-projektek használata című témakörben talál. | A Fájlkezelő kattintson a jobb gombbal a célmappára, és válassza a Q#-projekt létrehozása lehetőséget. |
| K#: Azure Quantum-jegyzetfüzet létrehozása | Megnyit egy Q# + Python-programot futtató jupyter-mintajegyzetfüzetet, és elküld egy feladatot az Azure Quantumnak. | Az Azure Quantum-jegyzetfüzetekről további információt az Azure Quantum-jegyzetfüzetek használata című témakörben talál. | n/a |
| K#: Csatlakozás Azure Quantum-munkaterülethez | Csatlakozzon egy Azure Quantum-munkaterülethez az Azure-fiókjával vagy egy kapcsolati sztring. A hitelesítés után a munkaterület megjelenik a Kvantum-munkaterületek Fájlkezelő. | További információ az Azure Quantum-kapcsolatokról: Csatlakozás az Azure Quantum-munkaterülethez. | A Fájlkezelő mutasson a Kvantum-munkaterületek fölé, és válassza a "+" ikont. |
| Q#: A Q# játszótér megnyitása | Megnyitja a Q#-mintaprogramok online mappáját a Fájlkezelő. Szerkesztheti és futtathatja a programokat a helyi kvantumszimulátorban, valamint töréspontokat állíthat be, és a beépített hibakeresővel végiglépkedhet a kódon. | További információ: README fájl a mintamappában. | n/a |
| K#: Azure Quantum-munkaterületek frissítése | Szinkronizálja a csatlakoztatott kvantum-munkaterületek legújabb módosításait. | Kapcsolati probléma esetén a munkaterület neve mellett megjelenik egy riasztásikon. | A Fájlkezelő mutasson a Quantum-munkaterületekre, és válassza a frissítés ikont. |
| Explorer: Fókusz a Kvantum-munkaterületek nézeten | Megnyitja Fájlkezelő, és konfigurálva a csatlakoztatott kvantum-munkaterületekre összpontosít. Ha nincsenek munkaterületek konfigurálva, a rendszer egy meglévő munkaterület hozzáadását kéri. | További információ az Azure Quantum-kapcsolatokról: Csatlakozás az Azure Quantum-munkaterülethez. | n/a |
Az alábbi parancsok érhetők el, ha egy .qs-fájl aktív.
| Parancs | Művelet | Jegyzetek | Másodlagos felhasználói művelet |
|---|---|---|---|
| K#: Az Azure Quantum QIR-célprofil beállítása | Beállítja a QIR vagy a kvantum köztes reprezentáció célprofilját a Q#-programokhoz. | A célprofilokról további információt a Célprofilok című témakörben talál. | Az aktuális célprofil az alsó eszköztáron jelenik meg. Válassza ki a célprofilt az eszköztáron a kijelölési legördülő lista megnyitásához. |
| Q#: Kapcsolatcsoport megjelenítése | A Q#-program kapcsolatcsoportdiagramjának megjelenítése a futtatás előtt. | További információ: Kvantum-kapcsolatcsoport-diagramok vizualizációja. | Válassza ki a kódlencse beállításcsoportot a belépési pont művelet melletti menüből vagy a program minden felhasználó által meghatározott művelete felett. |
| K#: Fájl futtatása és hisztogram megjelenítése | Futtatja az aktuális Q#-programot, és megjeleníti az eredmények hisztogramját a jobb oldali panelen. | A hisztogram megjelenítésének rendezési és szűrési beállításainak eléréséhez válassza a hisztogram panel szűrőikonját. | Válassza ki a kódlencse lehetőség hisztogramját a belépési pont művelet melletti menüből. |
| Q#: QIR lekérése az aktuális Q#-programhoz | Megnyitja az aktuális Q#-kód QIR-forrását egy új szerkesztési ablakban. A programnak a QIR-forrás exportálásához az Alap vagy az Adaptív RI célprofilt kell használnia. | A QIR-ről további információt a Kvantum köztes ábrázolása és a Q# fejlesztői blogja tartalmaz. | n/a |
| Hibakeresés: Q#-fájl hibakeresése | Megnyitja az aktuális Q#-programot a hibakeresőben. | További információ: A kvantumkód hibakeresése és tesztelése. | * Válassza az F5 lehetőséget * Válassza a kódlencse Hibakeresés lehetőségét a belépési pont művelet melletti menüből. * Válassza a futtatás ikont a jobb felső sarokban, és válassza a Q#-fájl hibakeresése lehetőséget. |
| Hibakeresés: Q#-fájl futtatása | Az aktuális Q#-programot az alapértelmezett kvantumszimulátorban futtatja. | További információt a Q#-programok használatának első lépései című témakörben talál. | * Válassza a Ctrl+F5 billentyűkombinációt * Válassza a Kódlencse lehetőséget , amely a belépési pont művelet melletti menüből fut . * Válassza a futtatás ikont a jobb felső sarokban, és válassza a Q#-fájl futtatása lehetőséget. |
| K#: Erőforrás-becslések kiszámítása | Meghívja az Erőforrásbecslő beépített verzióját. | További információ: Bevezetés az Azure Quantum Resource Estimator használatába. | n/a |
| K#: Súgó | A VS Code QDK-bővítményének rövid áttekintése. | Az Azure Quantum teljes dokumentációját az Azure Quantum dokumentációjában találja. | n/a |
| Q#: Fájl futtatása és kapcsolatcsoportdiagram megjelenítése | Futtatja az aktuális Q#-programot, és megjeleníti a program egy kapcsolatcsoportját kimenetekkel. | További információ: Kvantum-kapcsolatcsoport-diagramok vizualizációja. | n/a |
| Q#: API-dokumentáció megjelenítése | Megnyitja az API-dokumentációt egy új panelen. Keresés ebben az ablaktáblában a Ctrl-F billentyűkombinációval. | További információ: Azure Quantum API-referencia. | n/a |
Terminálok
A Q#-programok két terminálablakot használnak a VS Code-ban:
| Terminál | Művelet |
|---|---|
| Hibakeresési konzol | Futtatási kimenet vagy hibakeresési kimenet megjelenítése |
| Problémák | Fordítás előtti hibaellenőrzések megjelenítése |
Q#-kód szerkesztése
A VS Code gyakori kódszerkesztési funkciói a Q#-programok használatakor érhetők el. További információ: Intellisense a VS Code dokumentációjában.
- Kompatibilitás előtti hibaellenőrzés
- Ugrás definíciója
- Hivatkozások
- Függvény-aláírások
- Paraméteradatok
- Befejezési javaslatok
- Linting – A Q#-fájlokban projektenként konfigurálja a lintinget a jegyzékfájlban. További információ: Q#-projektek használata.
Gyakori feladatok
Q#-fájlok és -projektek használata
| Task | Művelet | Jegyzetek |
|---|---|---|
| Új Q#-fájl | > Válassza az Új fájl > szövegfájlja lehetőséget. Mentse a fájlt .qs kiterjesztéssel. | Ha be van állítva Files: Default Language = qsharp, az új fájl alapértelmezés szerint automatikusan Q#-formázást használ. |
| Q#-projekt létrehozása | A Fájlkezelő egyik megnyitott mappájában válassza a Q#-projekt létrehozása parancskatalógusból, vagy kattintson a jobb gombbal a Fájlkezelő mappára, és válassza a Q# projekt létrehozása lehetőséget. | A Q#-projektekről további információt a Q#-projektek használata című témakörben talál. |
| Mintafájlok | Egy üres .qs fájlban adjon meg mintákat, majd válasszon ki egy mintaprogramot a listából. | A Q#-mintaprogramok online mappájának megnyitásához a parancskatalógusban a Q# játszótér megnyitása lehetőséget is választhatja Fájlkezelő. |
Csatlakozás az Azure Quantumhoz
| Task | Művelet | Jegyzetek | Másodlagos felhasználói művelet |
|---|---|---|---|
| Csatlakozás Azure Quantum-munkaterülethez | A Fájlkezelő bontsa ki a Kvantum-munkaterületeket, és válassza a Meglévő munkaterület hozzáadása lehetőséget. Az előfizetés és a munkaterület kiválasztásához kövesse az utasításokat. | * Több munkaterülethez is csatlakozhat. Másik munkaterület csatlakoztatásához válassza a Kvantum-munkaterületek melletti "+" lehetőséget. A munkaterület-kapcsolatok továbbra is megmaradnak a VS Code-munkamenetek között. * Munkaterület-kapcsolat eltávolításához kattintson a jobb gombbal a munkaterületre, és válassza a Munkaterület-kapcsolat eltávolítása lehetőséget. |
A parancskatalógusban válassza a Csatlakozás Azure Quantum-munkaterülethez lehetőséget. |
| Csatlakozás programozott módon Egy Python-programmal | Kattintson a jobb gombbal egy meglévő munkaterület-kapcsolatra, és válassza a Python-kód másolása lehetőséget a munkaterülethez való csatlakozáshoz. Illessze be az eredményül kapott kódot a Python-programba. | További információ: Python küldése Q#-feladatokkal az Azure Quantumba. | n/a |
Programok futtatása
| Task | Művelet | Jegyzetek | Másodlagos felhasználói művelet |
|---|---|---|---|
| Q#-program futtatása a helyi kvantumszimulátoron | Egy Q#-programban válassza a futtatás ikont a jobb felső sarokban, és válassza a Q#-fájl futtatása lehetőséget. | A kvantumszimulátorról további információt a Sparse kvantumszimulátorban talál. | * Válassza a Ctrl-F5 billentyűkombinációt * A parancskatalógusban válassza a Q#: Fájl futtatása és hisztogram vagy Q#: Fájl futtatása és kapcsolatcsoportdiagram megjelenítése * Válassza a Kódlencse lehetőséget , amely a belépési pont művelet melletti menüből fut . |
| Program hibakeresése | Egy Q#-programban válassza a futtatás ikont a jobb felső sarokban, és válassza a Q#-fájl hibakeresése lehetőséget. | A VS Code Q#-hibakeresőjével kapcsolatos további információkért lásd a kvantumkód hibakeresését és tesztelését. | * Válassza az F5 lehetőséget * Válassza a kódlencse Hibakeresés lehetőségét a belépési pont művelet melletti menüből. |
| Szolgáltatók és célok megtekintése a munkaterületeken | A Fájlkezelő válassza ki a Kvantum-munkaterületeket, bontsa ki a munkaterületet, majd bontsa ki a Szolgáltatók elemet a munkaterület elérhető szolgáltatóinak megtekintéséhez. Bontsa ki az egyes szolgáltatókat az elérhető célok megtekintéséhez. | Megjegyzés: Vigye az egérmutatót a célnév fölé az állapot és az üzenetsor időének megtekintéséhez a feladat elküldése előtt. | n/a |
| Feladat elküldése az Azure Quantumba | Egy Q#-programban válasszon ki egy munkaterületet, szolgáltatót és célt. Az aktuális Q#-program elküldéséhez kattintson a cél melletti nyílra. | További információ: Q#-feladatok beküldése az Azure Quantumba. | n/a |
| Feladat eredményeinek megtekintése | Bontsa ki a munkaterületet, majd bontsa ki a Feladatok elemet. A feladat kimenetének az Azure Storage-ból való megnyitásához válassza a feladat neve melletti felhőikont. | A feladatok a legfrissebbkel vannak felsorolva. | n/a |