Używanie programu Visual Studio Code do tworzenia aplikacji programu PowerShellUsing Visual Studio Code for PowerShell Development

Oprócz PowerShell ISE, programu PowerShell jest również dobrze jest obsługiwany w programie Visual Studio Code.In addition to the PowerShell ISE, PowerShell is also well-supported in Visual Studio Code. Ponadto środowiska ISE nie jest obsługiwana przy użyciu programu PowerShell Core, chociaż program Visual Studio Code jest przeznaczony dla programu PowerShell Core na wszystkich platformach (Windows, macOS i Linux)Furthermore, the ISE is not supported with PowerShell Core, while Visual Studio Code is supported for PowerShell Core on all platforms (Windows, macOS, and Linux)

Można użyć programu Visual Studio Code na Windows przy użyciu programu PowerShell w wersji 5 przy użyciu systemu Windows 10 lub dzięki zainstalowaniu Windows Management Framework 5.0 RTM dla niskiego poziomu OSs Windows (Windows 8.1, itp.).You can use Visual Studio Code on Windows with PowerShell version 5 by using Windows 10 or by installing Windows Management Framework 5.0 RTM for down-level Windows OSs (e.g. Windows 8.1, etc.).

Przed jej rozpoczęciem, upewnij się, że program PowerShell znajduje się w Twoim systemie.Before starting it, please make sure PowerShell exists on your system. W przypadku nowoczesnych obciążeń w Windows, macOS i Linux zobacz:For modern workloads on Windows, macOS, and Linux, see:

W przypadku tradycyjnych obciążeń programu Windows PowerShell, zobacz Instalowanie programu Windows PowerShell.For traditional Windows PowerShell workloads, see Installing Windows PowerShell.

Edytowanie w programie Visual Studio CodeEditing with Visual Studio Code

1. Instalowanie programu Visual Studio Code1. Installing Visual Studio Code

  • Linux: postępuj zgodnie z instrukcjami instalacji na uruchomiony program VS Code w systemie Linux stronyLinux: follow the installation instructions on the Running VS Code on Linux page

  • System macOS: postępuj zgodnie z instrukcjami instalacji na uruchomiony program VS Code w systemie macOS stronymacOS: follow the installation instructions on the Running VS Code on macOS page

    Ważne

    W systemie macOS należy zainstalować protokół OpenSSL rozszerzenia programu PowerShell, do prawidłowego działania.On macOS, you must install OpenSSL for the PowerShell extension to work correctly. W tym celu najłatwiej zainstalował Homebrew , a następnie uruchom brew install openssl.The easiest way to accomplish this is to install Homebrew and then run brew install openssl. Program VS Code można teraz pomyślnie załadować rozszerzenia programu PowerShell.VS Code can now load the PowerShell extension successfully.

  • Windows: postępuj zgodnie z instrukcjami instalacji na uruchomiony program VS Code w Windows stronyWindows: follow the installation instructions on the Running VS Code on Windows page

2. Instalowanie rozszerzenia programu PowerShell2. Installing PowerShell Extension

  • Uruchomienie programu Visual Studio Code aplikacji przez:Launch the Visual Studio Code app by:

    • Windows: wpisywanie code w sesji programu PowerShellWindows: typing code in your PowerShell session
    • Linux: wpisywanie code w terminaluLinux: typing code in your terminal
    • System macOS: wpisywanie code w terminalumacOS: typing code in your terminal
  • Uruchom szybkiego otwierania , naciskając klawisz Ctrl + P (Cmd + P na komputerze Mac).Launch Quick Open by pressing Ctrl+P (Cmd+P on Mac).

  • W szybkiego otwierania wpisz ext install powershell i kliknij przycisk Enter.In Quick Open, type ext install powershell and hit Enter.

  • Rozszerzenia zostanie otwarty widok na pasku bocznym.The Extensions view opens on the Side Bar. Zaznacz rozszerzenie programu PowerShell firmy Microsoft.Select the PowerShell extension from Microsoft. Powinny zostać wyświetlone informacje, takie jak poniżej:You should see something like below:

    VSCode

  • Kliknij przycisk zainstalować przycisku na rozszerzeniu programu PowerShell firmy Microsoft.Click the Install button on the PowerShell extension from Microsoft.

  • Po zakończeniu instalacji zostanie wyświetlony zainstalować przechodzi przycisk Załaduj ponownie.After the install, you see the Install button turns to Reload. Kliknij pozycję Załaduj ponownie.Click on Reload.

  • Visual Studio Code po Załaduj ponownie, wszystko jest gotowe do edycji.After Visual Studio Code has reload, you are ready for editing.

Na przykład, aby utworzyć nowy plik, kliknij przycisk Plik -> Nowy.For example, to create a new file, click File->New. Aby zapisać go, kliknij przycisk Plik -> Zapisz a następnie podaj nazwę pliku, teraz załóżmy, że HelloWorld.ps1.To save it, click File->Save and then provide a file name, let's say HelloWorld.ps1. Aby zamknąć plik, kliknij symbol "x" obok nazwy pliku.To close the file, click on "x" next to the file name. Aby zakończyć działanie programu Visual Studio Code, Plik -> Zakończ.To exit Visual Studio Code, File->Exit.

Przy użyciu określonych zainstalowanej wersji programu PowerShellUsing a specific installed version of PowerShell

Jeśli użytkownik chce określoną instalacją programu PowerShell za pomocą programu Visual Studio Code, należy dodać nową zmienną do pliku ustawień użytkownika.If you wish to use a specific installation of PowerShell with Visual Studio Code, you need to add a new variable to your user settings file.

  1. Kliknij przycisk Plik -> Preferencje -> UstawieniaClick File -> Preferences -> Settings

  2. Są wyświetlane dwa okienka edytora.Two editor panes appear. W okienku najdalej z prawej strony (settings.json), wstawić ustawienie poniżej odpowiednie dla Twojego systemu operacyjnego gdzieś między dwoma nawiasów klamrowych ({ i }) i Zastąp <wersji> z zainstalowaną wersją programu PowerShell:In the right-most pane (settings.json), insert the setting below appropriate for your OS somewhere between the two curly brackets ({ and }) and replace <version> with the installed PowerShell version:

     // On Windows:
     "powershell.powerShellExePath": "c:/Program Files/PowerShell/<version>/pwsh.exe"
    
     // On Linux:
     "powershell.powerShellExePath": "/opt/microsoft/powershell/<version>/pwsh"
    
     // On macOS:
     "powershell.powerShellExePath": "/usr/local/microsoft/powershell/<version>/pwsh"
    
  3. Zastąp ustawienia ścieżki do żądanego pliku wykonywalnego programu PowerShellReplace the setting with the path to the desired PowerShell executable

  4. Zapisz plik ustawień i ponownie uruchom Visual Studio CodeSave the settings file and restart Visual Studio Code

Ustawienia konfiguracji dla programu Visual Studio CodeConfiguration settings for Visual Studio Code

Wykonując kroki opisane w poprzednim akapicie można dodać ustawień konfiguracji w settings.json.By using the steps in the previous paragraph you can add configuration settings in settings.json.

Zalecamy następujące ustawienia konfiguracji dla programu Visual Studio Code:We recommend the following configuration settings for Visual Studio Code:

{
    "csharp.suppressDotnetRestoreNotification": true,
    "editor.renderWhitespace": "all",
    "editor.renderControlCharacters": true,
    "omnisharp.projectLoadTimeout": 120,
    "files.trimTrailingWhitespace": true
}

Debugowanie za pomocą programu Visual Studio CodeDebugging with Visual Studio Code

Obszar roboczy bez debugowaniaNo-workspace debugging

Począwszy od wersji programu Visual Studio Code 1.9 można debugować skrypty programu PowerShell, bez konieczności otwierania folderu zawierającego skrypt programu PowerShell.As of Visual Studio Code version 1.9 you can debug PowerShell scripts without having to open the folder containing the PowerShell script. Po prostu otwórz pliku skryptu programu PowerShell, za pomocą Plik -> Otwórz plik... , ustaw punkt przerwania w wierszu (naciśnij klawisz F9), a następnie naciśnij klawisz F5, aby rozpocząć debugowanie.Simply open the PowerShell script file with File->Open File..., set a breakpoint on a line (press F9) and then press F5 to start debugging. Powinien zostać wyświetlony w okienku Akcje debugowania są wyświetlane, co pozwala na przerwanie w debugerze, krok, wznowienie i zatrzymać debugowanie.You should see the Debug actions pane appear which allows you to break into the debugger, step, resume and stop debugging.

Debugowanie obszaru roboczegoWorkspace debugging

Obszar roboczy profilowanie odnosi się do debugowania w kontekście folder, który został otwarty w programie Visual Studio Code przy użyciu Otwórz Folder... z pliku menu.Workspace debugging refers to debugging in the context of a folder that you have opened in Visual Studio Code using Open Folder... from the File menu. Folder, który można otworzyć, jest zazwyczaj do folderu projektu programu PowerShell i/lub w katalogu głównym repozytorium Git.The folder you open is typically your PowerShell project folder and/or the root of your Git repository.

Nawet w tym trybie można uruchomić debugowania aktualnie zaznaczonego skryptu programu PowerShell, po prostu naciskając klawisz F5.Even in this mode, you can start debugging the currently selected PowerShell script by simply pressing F5. Jednakże debugowanie obszaru roboczego umożliwia definiowanie wielu konfiguracji debugowania innych niż po prostu debugowania aktualnie otwarty plik.However, workspace debugging allows you to define multiple debug configurations other than just debugging the currently open file. Na przykład można dodać konfiguracji do:For instance, you can add a configurations to:

  • Uruchom testy usług Pester w debugerzeLaunch Pester tests in the debugger
  • Uruchom określony plik z argumentami w debugerzeLaunch a specific file with arguments in the debugger
  • Uruchomienie interaktywnej sesji w debugerzeLaunch an interactive session in the debugger
  • Dołącz debuger do procesu hosta programu PowerShellAttach the debugger to a PowerShell host process

Wykonaj następujące kroki, aby utworzyć plik konfiguracji debugowania:Follow these steps to create your debug configuration file:

  1. Otwórz debugowania widoku, naciskając klawisz Ctrl + Shift + D (Cmd + Shift + D na komputerze Mac).Open the Debug view by pressing Ctrl+Shift+D (Cmd+Shift+D on Mac).
  2. Naciśnij klawisz Konfiguruj ikonę koła zębatego w pasku narzędzi.Press the Configure gear icon in the toolbar.
  3. Visual Studio Code wyświetli monit o wybierz środowisko.Visual Studio Code prompts you to Select Environment. Wybierz PowerShell.Choose PowerShell.

Gdy to zrobisz, Visual Studio Code tworzy katalog i plik ".vscode\launch.json" w katalogu głównym folderu obszaru roboczego.When you do this, Visual Studio Code creates a directory and a file ".vscode\launch.json" in the root of your workspace folder. Jest to, gdzie są przechowywane z konfiguracji debugowania.This is where your debug configuration is stored. Jeśli pliki znajdują się w repozytorium Git, zazwyczaj chcesz zatwierdzić pliku launch.json.If your files are in a Git repository, you typically want to commit the launch.json file. Zawartość pliku launch.json są:The contents of the launch.json file are:

{
  "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}"
      }
  ]
}

Reprezentuje typowe scenariusze debugowania.This represents the common debug scenarios. Jednak po otwarciu tego pliku w edytorze można zobaczyć Dodawanie konfiguracji... przycisku.However, when you open this file in the editor, you see an Add Configuration... button. Można nacisnąć ten przycisk, aby dodać większą liczbę konfiguracji debugowania programu PowerShell.You can press this button to add more PowerShell debug configurations. Jedna konfiguracja przydatna, aby dodać jest programu PowerShell: Uruchom skryptu.One handy configuration to add is PowerShell: Launch Script. W przypadku tej konfiguracji można określić specjalny plik z argumentów opcjonalnych, które powinien zostać uruchomiony po każdym naciśnięciu klawisza F5 niezależnie od tego, plik, który jest aktualnie aktywne w edytorze.With this configuration, you can specify a specific file with optional arguments that should be launched whenever you press F5 no matter which file is currently active in the editor.

Gdy zostanie nawiązane z konfiguracji debugowania, możesz wybrać konfigurację, która ma być używany podczas sesji debugowania, wybierając jedną z listy rozwijanej w konfiguracji debugowania debugowania narzędzi widoku.Once the debug configuration is established, you can select which configuration you want to use during a debug session by selecting one from the debug configuration drop-down in the Debug view's toolbar.

Istnieje kilka blogi, które mogą być przydatne ułatwią Ci rozpoczęcie pracy przy użyciu rozszerzenia programu PowerShell dla programu Visual Studio Code:There are a few blogs that may be helpful to get you started using PowerShell extension for Visual Studio Code:

Rozszerzenie programu PowerShell dla programu Visual Studio CodePowerShell Extension for Visual Studio Code

Kod źródłowy rozszerzenia programu PowerShell można znaleźć na GitHub.The PowerShell extension's source code can be found on GitHub.