Visual Studio'da bir proje için Python ortamı seçme

Python projesindeki tüm kodlar belirli bir ortam bağlamında çalışır. Bu ortamlar genel bir Python ortamı, anaconda ortamı, sanal ortam veya conda ortamı olabilir. Visual Studio hata ayıklama, içeri aktarma ve üye tamamlamaları ve söz dizimi denetimi için Python ortamını kullanır. Ortam, Python sürümüne özgü dil hizmetleri ve yüklü paket kümesi gerektiren tüm görevler için kullanılır.

Visual Studio bir proje için birden çok ortam oluşturabilir ve bunlar arasında kendi geliştirme gereksinimlerinize göre geçiş yapabilirsiniz. Tüm yeni Python projeleri başlangıçta varsayılan genel ortamı kullanacak şekilde yapılandırılır. projenizin ortamlarını Çözüm Gezgini içindeki Python Environments düğümü altında görebilirsiniz:

Önkoşullar

• Visual Studio. Ürünü yüklemek için Visual Studio'yu Yükleme'deki adımları izleyin.

• Yalnızca mevcut ortamlar arasında geçiş yapabilirsiniz. Varsayılan genel ortamdan başka bir ortamınız yoksa , sanal ortamlarla çalışma hakkında aşağıdaki bölümlere bakın. Daha fazla bilgi için bkz. Visual Studio'da Python ortamları oluşturma ve yönetme.

Geçerli proje ortamını değiştirme

Visual Studio Çözüm Gezgini içindeki bir Python projesinin etkin (geçerli) ortamını değiştirebilir veya Ortam Ekle özelliğini kullanarak araç çubuğundan değiştirebilirsiniz.

1. Ortam Ekle işlemini başlatın:

   • Çözüm Gezgini'da projeniz için Python Ortamlar düğümüne sağ tıklayın ve Ortam Ekle öğesini seçin.
   • Python araç çubuğunda Ortam Ekle seçeneğini Environment açılır menüsünden seçin.

   Visual Studio'da Ortam Ekle özelliğine erişmek için iki seçeneği gösteren ekran görüntüsü.

2. Ortam Ekle iletişim kutusunda Var olan ortam sekmesini seçin. Ortam açılan listesini genişletin ve istediğiniz ortamı seçin, ardından Ekle'yi seçin.

   

Uyarı

Kullanmak istediğiniz ortam listede yoksa , var olan bir ortamı el ile tanımlamanız gerekebilir.

Sanal ortamları kullanma

Sanal ortam, belirli bir Python yorumlayıcı ile diğer genel ve conda ortamlarından farklı olan belirli bir kitaplık kümesinin benzersiz bir birleşimidir. Sanal ortam bir projeye özgüdür ve bir proje alt klasöründe tutulur. klasör, ortamın yüklü kitaplıklarının yanı sıra, dosya sistemindeki ortamın temel yorumlayıcısının yolunu belirten bir pyvenv.cfg dosyası içerir. (Sanal ortam yorumlayıcının bir kopyasını içermez, yalnızca buna bir bağlantı içerir.)

Sanal ortamı kullanmanın bir avantajı, projenizi zaman içinde geliştirirken sanal ortamın her zaman projenizin tam bağımlılıklarını yansıtmasıdır. Bu davranış, projenizde kullansanız da kullanmasanız da herhangi bir sayıda kitaplık içeren paylaşılan bir genel ortamdan farklıdır. Sanal ortamdan, diğer geliştirme veya üretim bilgisayarlarına paket bağımlılıklarını yeniden yüklemek için kullanılanrequirements.txtdosyasını kolayca oluşturabilirsiniz. Daha fazla bilgi için bkz. requirements.txtile gerekli paketleri yönetme .

requirements.txt dosyası içeren bir projeyi Visual Studio açtığınızda Visual Studio size otomatik olarak sanal ortamı yeniden oluşturma seçeneği sunar. Visual Studio yüklü olmayan bilgisayarlarda, gerekli paketleri geri yüklemek için pip install -r requirements.txt komutunu kullanabilirsiniz.

Sanal ortam, temel Python yorumlayıcısına sabit kodlanmış bir yol içerdiğinden ve requirements.txt dosyasını kullanarak ortamı yeniden oluşturabildiğiniz için, genellikle ortam alt klasörünü kaynak denetiminden atlarsınız. Projenize bir sanal ortam ekledikten sonra, Python Ortamlar penceresinde görünür. Daha sonra bunu diğer ortamlar gibi etkinleştirebilir ve paketlerini yönetebilirsiniz.

Sanal ortam oluşturma

Yeni bir sanal ortamı doğrudan Visual Studio'da aşağıdaki gibi oluşturabilirsiniz:

1. Ortam Ekle işlemini başlatın:

   • Çözüm Gezgini'da projeniz için Python Ortamlar düğümüne sağ tıklayın ve Ortam Ekle öğesini seçin.
   • Python araç çubuğunda Ortam Ekle seçeneğini Ortam açılır menüsünden seçin.

2. Ortam Ekle iletişim kutusunda Sanal ortam sekmesini seçin:

   ``` ```

3. Gerekli alanları yapılandırın:

   Gerekli alan	Description
   Project	Ortamın oluşturulacağı projeyi belirleyin.
   Name	Yeni sanal ortamın adını belirtin.
   Temel yorumlayıcı	Sanal ortam için temel dil yorumlayıcısını belirtin.
   Konum	Sistem, sanal ortam için varsayılan konumu atar. Konumu değiştirmek için Sanal ortamın konumunu değiştir bağlantısını seçin, konuma göz atın ve Klasör seç'i seçin.

4. İstenen isteğe bağlı alanları yapılandırın:

   İsteğe bağlı alan	Description
   Dosyadan paketleri yükleme	Sanal ortama paket eklemek için birrequirements.txt dosyasının yolunu belirtin. Dosyanın konumunu ve adını girin veya konuma (...) gidin ve dosyayı seçin.
   Geçerli ortam olarak ayarla	Ortam oluşturulduktan sonra seçili projedeki yeni ortamı etkinleştirin.
   Yeni projeler için varsayılan ortam olarak ayarla	Visual Studio'de oluşturulan tüm yeni projelerde ortamı otomatik olarak ayarlayın ve etkinleştirin. Bu ayar, Python Ortamları penceresindeki Bu yeni projeler için varsayılan ortam seçeneği aracılığıyla da kullanılabilir. Bu seçeneği kullandığınızda, sanal ortamı belirli bir projenin dışındaki bir konuma yerleştirin.
   Python Ortamları penceresinde görüntüle	Yeni ortamı oluşturduktan sonra Python Environments penceresinin gösterilip gösterilmeyeceğini belirtin.
   Bu ortamı genel kullanıma sun	Sanal ortamın genel ortam olarak da davranıp davranmayacağını belirtin. Bu seçeneği kullandığınızda, sanal ortamı belirli bir projenin dışındaki bir konuma yerleştirin.

5. Sanal ortamı sonlandırmak için Oluştur'u seçin.

Visual Studio ortamı yapılandırırken bir ilerleme çubuğu görüntüler ve gerekli paketleri indirir.

İşlem tamamlandıktan sonra Visual Studio yeni sanal ortamı etkinleştirir ve Çözüm Gezgini içindeki Python Environments düğümüne ekler. Ortam, içeren projenin Python Ortamları penceresinde de kullanılabilir.

Ortamı etkinleştirme

Bir proje için var olan bir ortamı etkinleştirmek için şu adımları izleyin:

1. Çözüm Gezgini'da projenizin Python Environments düğümünü genişletin ve kullanmak istediğiniz ortamı bulun.

2. Ortama sağ tıklayın ve Ortamı Etkinleştir'i seçin.

   Visual Studio'da bir proje ortamını etkinleştirmeyi gösteren ekran görüntüsü.

   Visual Studio bu ortamda bir requirements.txt dosyası algılarsa, bu paketlerin yüklenip yüklenmeyeceğini sorar.

   Visual Studio ortamı etkinleştirdikten sonra, etkin ortamın adı Çözüm Gezgini kalın yazı tipinde gösterilir:

   

Sanal ortamı kaldırma

Bir projenin mevcut ortamını kaldırmak için şu adımları izleyin:

1. Çözüm Gezgini'da sanal ortama sağ tıklayın ve Remove öğesini seçin.

2. Visual Studio sanal ortamı kaldırmak mı yoksa silmek mi istediğinizi sorar.

   • Ortamı projede kullanılamaz duruma getirmek ancak dosya sisteminde bırakmak için Kaldır'ı seçin.
   • Hem ortamı projeden kaldırmak hem de dosya sisteminden silmek için Sil'i seçin. Temel yorumlayıcı etkilenmez.

Yüklü paketleri görüntüleme ve yönetme

Çözüm Gezgini ortamında yüklü paketleri görüntüleyebilir ve yönetebilirsiniz. Bu paketler içeri aktarılabilir ve ortam etkin olduğunda kodunuzda kullanılabilir.

• Bir ortamda yüklü paketleri hızla görüntülemek için Çözüm Gezgini1'de projenizin Python Environments düğümü altındaki ortam düğümünü genişletin:

  Visual Studio Çözüm Gezgini'nde bir ortam için Python paketlerini gösteren ekran görüntüsü.

• Yeni paketleri yüklemek veya mevcut paketleri yönetmek için ortam düğümüne sağ tıklayın ve Python Packages öğesini seçin. Python araç çubuğundaki paket düğmesini de kullanabilirsiniz:

  Çözüm Gezgini'nde bir ortam için Python paketlerini yönet seçeneğine nasıl erişileceğini gösteren ekran görüntüsü.

  Python Ortamları penceresi açılır ve Packages (PyPI) sekmesinde seçili ortam için yüklü paketleri gösterir:

  

  Visual Studio'da, çoğu ortam için olan paketler ve bağımlılıklar, kullanılabilir paketleri de arayabileceğiniz Python Paket İndeksi (PyPI)'nden indirilir. Visual Studio durum çubuğu ve çıkış penceresi yükleme hakkındaki bilgileri gösterir.

• Paketi kaldırmak (kaldırmak) için listede paketi bulun ve sağ tarafta x simgesini seçin.

• Paketin veya diğer paketlerin güncelleştirilmiş sürümlerini aramak için bir arama terimi (genellikle paket adı) girin:

  Visual Studio eşleşen paketleri görüntüler. Bu örnekte arama, yanıp sönen terimiyle eşleşen paketler içindir.

  

  Visual Studio eşleşen sonuçların listesini etkin komut bağlantıları olarak görüntüler.

  • İlk komut, paketi en güncel sürüme ve geçerli bağımlılıklara yeniler. komutu ile Run command: pip install <package-name>benzerdir. Arama teriminizden sonra Enter seçerseniz Visual Studio bu ilk komutu otomatik olarak çalıştırır.

  • Diğer bağlantılar, gibi Install blinker-async (0.0.3)belirli bir paketi, sürümü veya bağımlılığı yükleyen komutlar içindir. Bu komutlardan birini çalıştırmak için bağlantıyı seçin.

Paket yüklemeyle ilgili dikkat edilmesi gerekenler

Visual Studio paketlerle çalışırken aşağıdaki noktaları göz önünde bulundurun:

• Paketler için görüntülenen girişlerin en güncel sürüm veya kullanılabilirlik açısından doğru olmayabileceğini unutmayın. Bir paket için gösterilen yükleme ve kaldırma bilgileri güvenilir veya kullanılabilir olmayabilir.

• Visual Studio varsa pip paket yöneticisini kullanır ve gerektiğinde indirir ve yükler. Visual Studio easy_install paket yöneticisini de kullanabilir. Komut satırından pip veya easy_install komutları kullanılarak yüklenen paketler de görüntülenir.

• Pip'in paket yükleyemediği yaygın bir durum, paketin *.pyd dosyalarındaki yerel bileşenler için kaynak kodu içermesidir. gerekli Visual Studio sürümü yüklü olmadan pip bu bileşenleri derleyemez. Bu durumda görüntülenen hata iletisi şu hatadır: vcvarsall.batbulunamadı . easy_install komutu genellikle önceden derlenmiş ikili dosyaları indirebilir ve https://python.en.uptodown.com/windows/versions'den eski Python sürümleri için uygun bir derleyici indirebilirsiniz. Daha fazla bilgi için Python araçları ekip blogundaki "vcvarsallbat bulunamadı" acısını nasıl giderebilirsiniz? bölümüne bakın.

• Conda paket yöneticisi genellikle varsayılan kanal olarak kullanır https://repo.continuum.io/pkgs/ , ancak diğer kanallar kullanılabilir. Daha fazla bilgi için bkz. Kanalları Yönetme (docs.conda.io).

• Visual Studio şu anda conda ortamına paket yüklemek için conda komutunun kullanılmasını desteklemez. conda Bunun yerine komut satırından komutunu kullanın.

İlgili içerik

• Visual Studio'da Python ortamlarını yönetme
• Bağımlılıklar için requirements.txt kullanma
• Arama yolları
• Python Ortamları başvuru penceresi