PowerShell Geliştirme için Visual Studio Code kullanma

Makale
05/09/2024

Visual Studio Code (VS Code), Microsoft tarafından platformlar arası bir betik düzenleyicisidir. PowerShell uzantısıyla birlikte zengin ve etkileşimli bir betik düzenleme deneyimi sağlayarak güvenilir PowerShell betikleri yazmayı kolaylaştırır. PowerShell uzantısına sahip Visual Studio Code, PowerShell betikleri yazmak için önerilen düzenleyicidir.

Aşağıdaki PowerShell sürümlerini destekler:

PowerShell 7.2 ve üzeri (Windows, macOS ve Linux)
.NET Framework 4.8 ile Windows PowerShell 5.1 (yalnızca Windows)

Not

Visual Studio Code, Visual Studio ile aynı değildir.

Başlarken

Başlamadan önce PowerShell'in sisteminizde mevcut olduğundan emin olun. Windows, macOS ve Linux'taki modern iş yükleri için aşağıdaki bağlantılara bakın:

Geleneksel Windows PowerShell iş yükleri için bkz . Windows PowerShell'i Yükleme.

Önemli

Windows PowerShell ISE, Windows için hala kullanılabilir. Ancak artık etkin özellik geliştirme aşamasında değildir. ISE yalnızca PowerShell 5.1 ve üzeri ile çalışır. Windows'un bir bileşeni olarak, güvenlik ve yüksek öncelikli bakım düzeltmeleri için resmi olarak desteklenmeye devam eder. ISE'yi Windows'tan kaldırmayı planlamıyoruz.

VS Code ve PowerShell Uzantısını Yükleme

Visual Studio Code’u yükleme. Daha fazla bilgi için bkz. Visual Studio Code'un ayarlanmasına genel bakış.

Her platform için yükleme yönergeleri vardır:
PowerShell Uzantısı'nı yükleyin.
1. Bir konsola yazarak code veya code-insiders Visual Studio Code Insider'ları yüklediyseniz VS Code uygulamasını başlatın.
2. Ctrl+P tuşuna basarak Windows veya Linux'ta Hızlı Aç'ı başlatın. macOS'ta Cmd+P tuşuna basın.
3. Hızlı Aç'a yazın ext install powershell ve Enter tuşuna basın.
4. Uzantılar görünümü Yan Çubukta açılır. Microsoft'tan PowerShell uzantısını seçin.
5. Microsoft'un PowerShell uzantısında Yükle düğmesine tıklayın.
6. Yüklemeden sonra Yükle düğmesinin Yeniden Yükle'ye dönüşmesi durumunda Yeniden Yükle'ye tıklayın.
7. VS Code yeniden yüklendikten sonra düzenlemeye hazır olursunuz.

Örneğin, yeni bir dosya oluşturmak için Dosya > Yeni'ye tıklayın. Kaydetmek için Dosya > Kaydet'e tıklayın ve gibi HelloWorld.ps1bir dosya adı sağlayın. Dosyayı kapatmak için dosya adının yanındaki öğesine tıklayın X . VS Code'dan çıkmak için Dosyadan > Çık'ı seçin.

PowerShell Uzantısını Kısıtlı Sistemlere Yükleme

Bazı sistemler tüm kod imzalarının doğrulanması için ayarlanır. Aşağıdaki hatayı alabilirsiniz:

Language server startup failed.

PowerShell'in yürütme ilkesi Windows Grup İlkesi tarafından ayarlandığında bu sorun oluşabilir. PowerShell Düzenleyici Hizmetleri'ni ve VS Code için PowerShell uzantısını el ile onaylamak için bir PowerShell istemi açın ve aşağıdaki komutu çalıştırın:

Import-Module $HOME\.vscode\extensions\ms-vscode.powershell*\modules\PowerShellEditorServices\PowerShellEditorServices.psd1

Bu güvenilmeyen yayımcıdan yazılım çalıştırmak istiyor musunuz? soruldu . Dosyayı çalıştırmak için yazın A . Ardından VS Code'ı açın ve PowerShell uzantısının düzgün çalıştığını doğrulayın. Başlarken sorun yaşamaya devam ediyorsanız github sorunuyla ilgili bize bildirin.

Uzantıyla kullanılacak PowerShell sürümünü seçme

PowerShell, Windows PowerShell ile yan yana yüklenirken artık PowerShell uzantısıyla PowerShell'in belirli bir sürümünü kullanmak mümkündür. Bu özellik, PowerShell yüklemelerini bulmak için farklı işletim sistemlerindeki birkaç iyi bilinen yola bakar.

Sürümü seçmek için aşağıdaki adımları kullanın:

Ctrl Shift+P ile Windows veya Linux'ta Komut Paleti'ni+ açın. macOS'ta Cmd+Shift+P kullanın.
Oturum için arama.
PowerShell: Oturum Menüsünü Göster'e tıklayın.
Listeden kullanmak istediğiniz PowerShell sürümünü seçin.

PowerShell'i tipik olmayan bir konuma yüklediyseniz, başlangıçta Oturum Menüsünde gösterilmeyebilir. Aşağıda açıklandığı gibi kendi özel yollarınızı ekleyerek oturum menüsünü genişletebilirsiniz.

PowerShell oturum menüsüne durum çubuğunun {} sağ alt köşesindeki simgeden de erişilebilir. Üzerine gelindiğinde veya bu simgeyi seçtiğinizde oturum menüsünün kısayolu ve küçük bir raptiye simgesi görüntülenir. Raptiye simgesini seçerseniz sürüm numarası durum çubuğuna eklenir. Sürüm numarası, daha az tıklama gerektiren oturum menüsünün kısayoludur.

Not

Sürüm numarasını sabitlemek, uzantının davranışını VS Code'un 1.65 öncesi sürümlerinde çoğaltır. VS Code'un 1.65 sürümü, PowerShell uzantısının kullandığı API'leri değiştirdi ve dil uzantıları için durum çubuğunu standartlaştırmıştı.

Visual Studio Code için yapılandırma ayarları

İlk olarak, VS Code'da ayarların nasıl değiştirileceğini bilmiyorsanız Visual Studio Code'un ayarlar belgelerini okumanızı öneririz.

Belgeleri okuduktan sonra, içine settings.jsonyapılandırma ayarları ekleyebilirsiniz.

{
    "editor.renderWhitespace": "all",
    "editor.renderControlCharacters": true,
    "files.trimTrailingWhitespace": true,
    "files.encoding": "utf8bom",
    "files.autoGuessEncoding": true
}

Bu ayarların tüm dosya türlerini etkilemesini istemiyorsanız VS Code, dil başına yapılandırmalara da izin verir. Bir alana ayarlar koyarak dile özgü bir [<language-name>] ayar oluşturun. Örneğin:

{
    "[powershell]": {
        "files.encoding": "utf8bom",
        "files.autoGuessEncoding": true
    }
}

İpucu

VS Code'da dosya kodlama hakkında daha fazla bilgi için bkz . Dosya kodlamayı anlama. Ayrıca VS Code'un PowerShell düzenlemesi için nasıl yapılandırılması konusunda diğer ipuçları için VS Code'da ISE deneyimini çoğaltma bölümüne göz atın.

Visual Studio Code ayarı aracılığıyla oturum menüsüne diğer PowerShell yürütülebilir yollarını ekleyebilirsiniz: powershell.powerShellAdditionalExePaths.

Gui kullanarak bunu yapabilirsiniz:

Komut Paleti'nden Kullanıcı Ayarlar Aç'ı arayın ve seçin. Veya Windows veya Linux Ctrl'de+ klavye kısayolunu kullanın. macOS'ta Cmd'yi+ kullanın.
Ayarlar düzenleyicisinde PowerShell Ek Exe Yolları'nı arayın.
Öğe Ekle'ye tıklayın.
Anahtar için (Öğe altında), bu ek PowerShell yüklemesi için seçtiğiniz adı belirtin.
Değer için (Değer altında), yürütülebilir dosyanın kendisine mutlak yolu sağlayın.

İstediğiniz kadar ek yol ekleyebilirsiniz. Eklenen öğeler oturum menüsünde, ad olarak verilen anahtarla gösterilir.

Alternatif olarak, içindeki settings.jsonnesnesine powershell.powerShellAdditionalExePaths anahtar-değer çiftleri ekleyebilirsiniz:

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

Not

Uzantının 2022.5.0 sürümünden önce, bu ayar gerekli anahtarları exePath ve versionNameiçeren nesnelerin listesiydi. GUI aracılığıyla yapılandırmayı desteklemek için hataya neden olan bir değişiklik yapıldı. Bu ayarı daha önce yapılandırdıysanız lütfen yeni biçime dönüştürün. için verilen versionName değer şimdi Anahtar ve verilen exePath değer de artık Değer'dir. Değeri sıfırlayarak ve Ayarlar arabirimini kullanarak bunu daha kolay yapabilirsiniz.

Varsayılan PowerShell sürümünü ayarlamak için, değeri powershell.powerShellDefaultVersion oturum menüsünde görüntülenen metne (anahtar için kullanılan metin) ayarlayın:

{
    "powershell.powerShellAdditionalExePaths": {
        "Downloaded PowerShell": "C:/Users/username/Downloads/PowerShell/pwsh.exe",
    },
    "powershell.powerShellDefaultVersion": "Downloaded PowerShell",
}

Bu ayarı yapılandırdıktan sonra VS Code'ı yeniden başlatın veya geçerli VS Code penceresini Komut Paleti'nden yeniden yüklemek için yazınDeveloper: Reload Window.

Oturum menüsünü açarsanız ek PowerShell yüklemelerinizi görürsünüz.

İpucu

PowerShell'i kaynaktan derlediyseniz bu, yerel PowerShell derlemenizi test etmenin harika bir yoludur.

Visual Studio Code ile hata ayıklama

Çalışma alanı yok hata ayıklaması

VS Code sürüm 1.9'da (veya üzeri), PowerShell betiğini içeren klasörü açmadan PowerShell betiklerinde hata ayıklayabilirsiniz.

Dosya > Aç Dosyası ile PowerShell betik dosyasını açın...
Kesme noktası ayarlama - bir satır seçin ve F9 tuşuna basın
Hata ayıklamayı başlatmak için F5 tuşuna basın

Hata ayıklayıcıya geçmenize, adımlamanıza, sürdürmenize ve hata ayıklamayı durdurmanıza olanak tanıyan Hata ayıklama eylemleri bölmesinin göründüğünü görmeniz gerekir.

Çalışma alanı hata ayıklama

Çalışma alanı hata ayıklaması, Dosya menüsünden Klasör Aç... kullanarak açtığınız bir klasör bağlamında hata ayıklamayı ifade eder. Açtığınız klasör genellikle PowerShell proje klasörünüz veya Git deponuzun köküdür. Çalışma alanı hata ayıklama, yalnızca açık olan dosyada hata ayıklama dışında birden çok hata ayıklama yapılandırması tanımlamanızı sağlar.

Hata ayıklama yapılandırma dosyası oluşturmak için şu adımları izleyin:

Ctrl+Shift+D tuşlarına basarak Windows veya Linux'ta Hata Ayıklama görünümünü açın. macOS'ta, Cmd+Shift D tuşuna+basın.
launch.json dosyası oluştur bağlantısına tıklayın.
Ortam Seç isteminden PowerShell'i seçin.
Kullanmak istediğiniz hata ayıklama türünü seçin:
- Geçerli Dosyayı Başlat - Şu anda etkin olan düzenleyici penceresinde dosyayı başlatma ve hata ayıklama
- Betiği Başlat - Belirtilen dosya veya komutu başlatma ve hata ayıklama
- Etkileşimli Oturum - Tümleşik Konsoldan yürütülen hata ayıklama komutları
- Ekle - Çalışan bir PowerShell Ana Bilgisayar İşlemine hata ayıklayıcı ekleme

VS Code, hata ayıklama yapılandırmasını depolamak için çalışma alanı klasörünüzün kökünde bir dizin ve dosya .vscode\launch.json oluşturur. Dosyalarınız bir Git deposundaysa, genellikle dosyayı işlemek launch.json istersiniz. Dosyanın içeriği launch.json şunlardır:

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

Bu dosya yaygın hata ayıklama senaryolarını temsil eder. Bu dosyayı düzenleyicide açtığınızda, Yapılandırma Ekle... düğmesini görürsünüz. Daha fazla PowerShell hata ayıklama yapılandırması eklemek için bu düğmeye tıklayabilirsiniz. Eklenecek kullanışlı yapılandırmalardan biri PowerShell: Betiği Başlat'tır. Bu yapılandırmayla, düzenleyicide hangi dosya etkin olursa olsun F5 tuşuna her bastığınızda kullanılan isteğe bağlı bağımsız değişkenler içeren bir dosya belirtebilirsiniz.

Hata ayıklama yapılandırması oluşturulduktan sonra, hata ayıklama oturumu sırasında kullanmak istediğiniz yapılandırmayı seçebilirsiniz. Hata ayıklama görünümünün araç çubuğundaki hata ayıklama yapılandırması açılan listesinden bir yapılandırma seçin.

PowerShell uzantısı sorunlarını giderme

PowerShell betiği geliştirme için VS Code kullanırken herhangi bir sorunla karşılaşırsanız GitHub'da sorun giderme kılavuzuna bakın.

Yararlı kaynaklar

VS Code için PowerShell uzantısını kullanmaya başlamanıza yardımcı olabilecek birkaç video ve blog gönderisi vardır:

Videolar

Blog gönderileri

PowerShell uzantısı proje kaynak kodu

PowerShell uzantısının kaynak kodu GitHub'da bulunabilir.

Katkıda bulunmak istiyorsanız Çekme İstekleri çok beğenilir. Başlamak için GitHub'da geliştirici belgelerini izleyin.

Aracılığıyla paylaş