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 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

  1. 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:

  2. Telepítse a PowerShell-bővítményt.

    1. Indítsa el a VS Code alkalmazást úgy, hogy begépel code egy konzolt, vagy code-insiders ha telepítette a Visual Studio Code Insider-résztvevőket.
    2. 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+.
    3. A Gyors megnyitás mezőbe írja be ext install powershell és nyomja le az Enter billentyűt.
    4. Megnyílik a Bővítmények nézet az oldalsávon. Válassza ki a Microsoft PowerShell-bővítményét.
    5. Kattintson a Microsoft PowerShell-bővítmény Telepítés gombjára.
    6. A telepítés után, ha a Telepítés gomb újratöltésre vált, kattintson az Újratöltés gombra.
    7. A VS Code újratöltése után készen áll a szerkesztésre.

Ú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:

  1. 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+.
  2. Munkamenet keresése.
  3. Kattintson a PowerShell: Munkamenet menü megjelenítése parancsra.
  4. 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:

  1. 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+.
  2. A Gépház szerkesztőben keressen további PowerShell-elérési utakat.
  3. Kattintson az Elem hozzáadása elemre.
  4. A kulcshoz (az Elem alatt) adja meg a további PowerShell-telepítés nevét.
  5. 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.powerShellAdditionalExePathssettings.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.

  1. Nyissa meg a PowerShell-szkriptfájlt fájlmegnyitási > fájllal...
  2. Töréspont beállítása – jelöljön ki egy sort, majd nyomja le az F9 billentyűt
  3. 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:

  1. 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++.

  2. Kattintson a launch.json fájlhivatkozás létrehozására.

  3. A Környezet kiválasztása párbeszédpanelen válassza a PowerShellt.

  4. 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

Blogbejegyzések

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 .