Megosztás a következőn keresztül:


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