A Visual Studio Code használata a PowerShell-fejlesztéshez
A Visual Studio Code (VS Code) a Microsoft platformfüggetlen szkriptszerkesztője. A PowerShell-bővítménysel együtt gazdag és interaktív szkriptszerkesztési élményt nyújt, így könnyebben írhat megbízható PowerShell-szkripteket. PowerShell-szkriptek írásához a PowerShell-bővítményt tartalmazó Visual Studio Code az ajánlott szerkesztő.
A következő PowerShell-verziókat támogatja:
- PowerShell 7.2 és újabb (Windows, macOS és Linux)
- Windows PowerShell 5.1 (csak Windows) .NET-keretrendszer 4.8-as verzióval
Feljegyzés
A Visual Studio Code nem ugyanaz, mint a Visual Studio.
Első lépések
Mielőtt hozzákezdene, győződjön meg arról, hogy a PowerShell létezik a rendszeren. A Windows, macOS és Linux rendszeren futó modern számítási feladatokért tekintse meg az alábbi hivatkozásokat:
- A PowerShell telepítése Linuxon
- A PowerShell telepítése macOS rendszeren
- A PowerShell telepítése Windows rendszeren
A hagyományos Windows PowerShell-számítási feladatokról a Windows PowerShell telepítése című témakörben olvashat.
Fontos
A Windows PowerShell I Standard kiadás továbbra is elérhető a Windowshoz. Ez azonban már nem aktív funkciófejlesztésben van. Az I Standard kiadás csak a PowerShell 5.1 és régebbi verzióival működik. A Windows összetevőjeként továbbra is hivatalosan támogatott a biztonság és a magas prioritású karbantartási javítások esetében. Nem tervezzük eltávolítani az I Standard kiadás a Windowsból.
A VS Code és a PowerShell-bővítmény telepítése
Telepítse a Visual Studio Code-ot. További információkért tekintse meg a Visual Studio Code beállításának áttekintését.
Az egyes platformokhoz telepítési utasítások tartoznak:
Telepítse a PowerShell-bővítményt.
- Indítsa el a VS Code alkalmazást úgy, hogy begépel
code
egy konzolt, vagycode-insiders
ha telepítette a Visual Studio Code Insider-résztvevőket. - Indítsa el a Gyors megnyitást Windowson vagy Linuxon a Ctrl P billentyűkombináció+lenyomásával. MacOS rendszeren nyomja le a Cmd P billentyűt+.
- A Gyors megnyitás mezőbe írja be
ext install powershell
és nyomja le az Enter billentyűt. - Megnyílik a Bővítmények nézet az oldalsávon. Válassza ki a Microsoft PowerShell-bővítményét.
- Kattintson a Microsoft PowerShell-bővítmény Telepítés gombjára.
- A telepítés után, ha a Telepítés gomb újratöltésre vált, kattintson az Újratöltés gombra.
- A VS Code újratöltése után készen áll a szerkesztésre.
- Indítsa el a VS Code alkalmazást úgy, hogy begépel
Új fájl létrehozásához például kattintson az Új fájl > gombra. A mentéshez kattintson a Fájl > mentése gombra, majd adjon meg egy fájlnevet, példáulHelloWorld.ps1
. A fájl bezárásához kattintson a X
fájlnév melletti elemre.
A VS Code-ból való kilépéshez lépjen ki a fájlból>.
A PowerShell-bővítmény telepítése korlátozott rendszerekre
Egyes rendszerek úgy vannak beállítva, hogy megkövetelje az összes kódaadék ellenőrzését. A következő hibaüzenet jelenhet meg:
Language server startup failed.
Ez a probléma akkor fordulhat elő, ha a PowerShell végrehajtási szabályzatát a Windows csoportházirend állítja be. A PowerShell-szerkesztőszolgáltatások és a VS Code PowerShell-bővítményének manuális jóváhagyásához nyisson meg egy PowerShell-parancssort, és futtassa a következő parancsot:
Import-Module $HOME\.vscode\extensions\ms-vscode.powershell*\modules\PowerShellEditorServices\PowerShellEditorServices.psd1
A rendszer arra kéri , hogy futtasson szoftvereket ebből a nem megbízható közzétevőből? Írja be A
a fájl futtatásához. Ezután nyissa meg a VS Code-ot, és ellenőrizze, hogy a PowerShell-bővítmény megfelelően működik-e. Ha továbbra is problémákat tapasztal az első lépések során, tudassa velünk egy GitHub-problémával.
A PowerShell bővítményhez használandó verziójának kiválasztása
Ha a PowerShell egymás mellett telepíti a Windows PowerShellt, mostantól a PowerShell egy adott verzióját is használhatja a PowerShell-bővítménysel. Ez a funkció áttekint néhány jól ismert elérési utat a különböző operációs rendszereken a PowerShell telepítéseinek felderítéséhez.
A verzió kiválasztásához kövesse az alábbi lépéseket:
- Nyissa meg a Parancskatalógust Windows vagy Linux rendszeren a Ctrl+Shift+P billentyűkombinációval. MacOS rendszeren használja a Cmd Shift+P parancsot+.
- Munkamenet keresése.
- Kattintson a PowerShell: Munkamenet menü megjelenítése parancsra.
- Válassza ki a listában a használni kívánt PowerShell-verziót.
Ha nem tipikus helyre telepítette a PowerShellt, előfordulhat, hogy az kezdetben nem jelenik meg a Munkamenet menüben. A munkamenet menüt úgy bővítheti, hogy hozzáadja saját egyéni elérési útjait az alábbiak szerint.
A PowerShell-munkamenet menüje az {}
állapotsor jobb alsó sarkában lévő ikonból is elérhető. Az ikonra rámutatva vagy kijelölve megjelenik a munkamenet menüjére mutató parancsikon és egy kis kitűző ikon. Ha a rögzítés ikont választja, a verziószám megjelenik az állapotsoron. A verziószám a munkamenet menüjének parancsikonja, amely kevesebb kattintást igényel.
Feljegyzés
A verziószám rögzítése replikálja a bővítmény viselkedését a VS Code 1.65 előtti verzióiban. A VS Code 1.65-ös kiadása módosította a PowerShell-bővítmény által használt API-kat, és szabványosította a nyelvi bővítmények állapotsorát.
A Visual Studio Code konfigurációs beállításai
Először is, ha nem ismeri a VS Code beállításainak módosítását, javasoljuk, hogy olvassa el a Visual Studio Code beállítási dokumentációját.
A dokumentáció elolvasása után konfigurációs beállításokat adhat hozzá a következőben settings.json
: .
{
"editor.renderWhitespace": "all",
"editor.renderControlCharacters": true,
"files.trimTrailingWhitespace": true,
"files.encoding": "utf8bom",
"files.autoGuessEncoding": true
}
Ha nem szeretné, hogy ezek a beállítások az összes fájltípust befolyásolják, a VS Code nyelvenkénti konfigurációkat is lehetővé tesz. Hozzon létre egy nyelvspecifikus beállítást, ha a beállításokat egy [<language-name>]
mezőbe helyezi. Példa:
{
"[powershell]": {
"files.encoding": "utf8bom",
"files.autoGuessEncoding": true
}
}
Tipp.
A VS Code fájlkódolásáról további információt a fájlkódolás ismertetése című témakörben talál. A VS Code-ban az I Standard kiadás-élmény replikálása című témakörben további tippeket találhat a VS Code PowerShell-szerkesztéshez való konfigurálásához.
Saját PowerShell-elérési utak hozzáadása a munkamenet menüjéhez
A Visual Studio Code beállítással további PowerShell-végrehajtható elérési utakat is hozzáadhat a munkamenet menüjéhez: powershell.powerShellAdditionalExePaths
.
Ezt a grafikus felhasználói felület használatával teheti meg:
- A parancskatalógusban keressen rá, és válassza a Felhasználó megnyitása Gépház lehetőséget. Vagy használja a windowsos vagy linuxos Ctrl+ billentyűkombinációt. MacOS rendszeren használja a Cmd parancsot+.
- A Gépház szerkesztőben keressen további PowerShell-elérési utakat.
- Kattintson az Elem hozzáadása elemre.
- A kulcshoz (az Elem alatt) adja meg a további PowerShell-telepítés nevét.
- Az Érték (érték alatt) adja meg a végrehajtható fájl abszolút elérési útját.
Tetszőleges számú további elérési utat adhat hozzá. A hozzáadott elemek megjelennek a munkamenet menüben, a megadott kulccsal, mint névvel.
Másik lehetőségként kulcs-érték párokat is hozzáadhat a következő objektumhoz powershell.powerShellAdditionalExePaths
settings.json
:
{
"powershell.powerShellAdditionalExePaths": {
"Downloaded PowerShell": "C:/Users/username/Downloads/PowerShell/pwsh.exe",
"Built PowerShell": "C:/Users/username/src/PowerShell/src/powershell-win-core/bin/Debug/net6.0/win7-x64/publish/pwsh.exe"
},
}
Feljegyzés
A bővítmény 2022.5.0-s verziója előtt ez a beállítás a szükséges kulcsokkal exePath
és versionName
. A grafikus felhasználói felületen keresztüli konfiguráció támogatásához kompatibilitástörő változást vezettek be. Ha korábban konfigurálta ezt a beállítást, konvertálja az új formátumba. A megadott versionName
érték most a Kulcs, a megadott exePath
érték pedig az Érték. Ezt egyszerűbben teheti meg az érték alaphelyzetbe állításával és a Gépház felület használatával.
Az alapértelmezett PowerShell-verzió beállításához állítsa az értéket powershell.powerShellDefaultVersion
a munkamenet menüjében megjelenő szövegre (a kulcshoz használt szövegre):
{
"powershell.powerShellAdditionalExePaths": {
"Downloaded PowerShell": "C:/Users/username/Downloads/PowerShell/pwsh.exe",
},
"powershell.powerShellDefaultVersion": "Downloaded PowerShell",
}
Miután konfigurálta ezt a beállítást, indítsa újra a VS Code-ot, vagy töltse be újra az aktuális VS Code ablakot a parancskatalógusból, írja be a következőtDeveloper: Reload Window
: .
Ha megnyitja a munkamenet menüt, megjelenik a további PowerShell-telepítések.
Tipp.
Ha a PowerShellt forrásból hozza létre, ez nagyszerű módszer a PowerShell helyi buildjének tesztelésére.
Hibakeresés a Visual Studio Code-tal
Munkaterület nélküli hibakeresés
A VS Code 1.9-es (vagy újabb) verziójában a PowerShell-szkriptek hibakeresése a PowerShell-szkriptet tartalmazó mappa megnyitása nélkül is lehetővé teszi.
- Nyissa meg a PowerShell-szkriptfájlt fájlmegnyitási > fájllal...
- Töréspont beállítása – jelöljön ki egy sort, majd nyomja le az F9 billentyűt
- A hibakeresés megkezdéséhez nyomja le az F5 billentyűt
Ekkor megjelenik a Hibakeresési műveletek panel, amely lehetővé teszi, hogy betörjön a hibakeresőbe, lépjen tovább, folytassa és állítsa le a hibakeresést.
Munkaterület hibakeresése
A munkaterület hibakeresése olyan mappa környezetében végzett hibakeresést jelenti, amelyet a Fájl menüből nyitott meg a Mappa megnyitása...parancs használatával. A megnyitott mappa általában a PowerShell-projektmappája vagy a Git-adattár gyökere. A munkaterület hibakeresése lehetővé teszi, hogy az aktuálisan megnyitott fájl hibakeresésén kívül több hibakeresési konfigurációt is definiáljon.
Hibakeresési konfigurációs fájl létrehozásához kövesse az alábbi lépéseket:
Nyissa meg a Hibakeresés nézetet Windows vagy Linux rendszeren a Ctrl Shift+D billentyűkombináció+lenyomásával. MacOS rendszeren nyomja le a Cmd Shift D billentyűkombinációt++.
Kattintson a launch.json fájlhivatkozás létrehozására.
A Környezet kiválasztása párbeszédpanelen válassza a PowerShellt.
Válassza ki a használni kívánt hibakeresés típusát:
- Aktuális fájl indítása – A fájl indítása és hibakeresése az aktuálisan aktív szerkesztőablakban
- Szkript indítása – A megadott fájl vagy parancs elindítása és hibakeresése
- Interaktív munkamenet – Az integrált konzolról végrehajtott parancsok hibakeresése
- Csatolás – A hibakereső csatolása egy futó PowerShell-gazdagéphez
A VS Code létrehoz egy könyvtárat és egy fájlt .vscode\launch.json
a munkaterület mappa gyökerében a hibakeresési konfiguráció tárolásához. Ha a fájlok egy Git-adattárban találhatók, általában véglegesíteni szeretné a launch.json
fájlt. A fájl tartalma:launch.json
{
"version": "0.2.0",
"configurations": [
{
"type": "PowerShell",
"request": "launch",
"name": "PowerShell Launch (current file)",
"script": "${file}",
"args": [],
"cwd": "${file}"
},
{
"type": "PowerShell",
"request": "attach",
"name": "PowerShell Attach to Host Process",
"processId": "${command.PickPSHostProcess}",
"runspaceId": 1
},
{
"type": "PowerShell",
"request": "launch",
"name": "PowerShell Interactive Session",
"cwd": "${workspaceRoot}"
}
]
}
Ez a fájl a gyakori hibakeresési forgatókönyveket jelöli. Amikor megnyitja a fájlt a szerkesztőben, megjelenik egy Konfiguráció hozzáadása... gomb. Erre a gombra kattintva további PowerShell-hibakeresési konfigurációkat vehet fel. Egy hasznos konfigurációt ad hozzá a PowerShell: Launch Script. Ezzel a konfigurációval megadhat egy olyan fájlt, amely opcionális argumentumokat tartalmaz, amelyeket az F5 billentyű lenyomásakor használ, függetlenül attól, hogy melyik fájl aktív a szerkesztőben.
A hibakeresési konfiguráció létrehozása után kiválaszthatja a hibakeresési munkamenet során használni kívánt konfigurációt. Válasszon ki egy konfigurációt a Hibakeresési nézet eszköztárának hibakeresési konfiguráció legördülő menüjéből.
A PowerShell-bővítmény hibaelhárítása
Ha problémákat tapasztal a VS Code for PowerShell-szkriptek fejlesztésével kapcsolatban, tekintse meg a GitHub hibaelhárítási útmutatóját .
Hasznos források
Néhány videó és blogbejegyzés hasznos lehet a VS Code-hoz készült PowerShell-bővítmény használatának megkezdéséhez:
Videók
- A Visual Studio Code használata alapértelmezett PowerShell-szerkesztőként
- Visual Studio Code: a PowerShell-szkriptek hibakeresésének részletes bemutatása
Blogbejegyzések
- PowerShell-bővítmény
- PowerShell-szkriptek írása és hibakeresése a Visual Studio Code-ban
- A Visual Studio Code hibakeresési útmutatója
- A PowerShell hibakeresése a Visual Studio Code-ban
- A PowerShell-fejlesztés első lépései a Visual Studio Code-ban
- A Visual Studio Code szerkesztési funkciói a PowerShell-fejlesztéshez – 1. rész
- A Visual Studio Code szerkesztési funkciói a PowerShell-fejlesztéshez – 2. rész
- PowerShell-szkript hibakeresése a Visual Studio Code-ban – 1. rész
- PowerShell-szkript hibakeresése a Visual Studio Code-ban – 2. rész
PowerShell-bővítmény projekt forráskódja
A PowerShell-bővítmény forráskódja a GitHubon található.
Ha szeretne hozzájárulni, a lekéréses kérelmeket nagyra értékeljük. Az első lépésekhez kövesse a GitHub fejlesztői dokumentációját .
Visszajelzés
https://aka.ms/ContentUserFeedback.
Hamarosan elérhető: 2024-ben fokozatosan kivezetjük a GitHub-problémákat a tartalom visszajelzési mechanizmusaként, és lecseréljük egy új visszajelzési rendszerre. További információ:Visszajelzés küldése és megtekintése a következőhöz: