Tworzenie środowisk języka Python i zarządzanie nimi w programie Visual Studio

Środowisko języka Python to kontekst, w którym uruchamiasz kod języka Python i obejmuje środowiska globalne, wirtualne i conda. Środowisko składa się z interpretera, biblioteki (zazwyczaj biblioteki standardowej języka Python) i zestawu zainstalowanych pakietów. Te składniki razem określają prawidłowe konstrukcje języka i składnię, funkcje systemu operacyjnego, do których można uzyskać dostęp, oraz pakiety, których można użyć.

W programie Visual Studio w systemie Windows użyjesz okna Środowiska języka Python , zgodnie z opisem w tym artykule, aby zarządzać środowiskami i wybierać je jako domyślne dla nowych projektów.

Inne aspekty środowisk można poznać w następujących artykułach:

• W przypadku dowolnego projektu można wybrać określone środowisko , a nie użyć wartości domyślnej.

• Aby uzyskać szczegółowe informacje na temat tworzenia i używania środowisk wirtualnych dla projektów języka Python, zobacz Używanie środowisk wirtualnych.

• Jeśli chcesz zainstalować pakiety w środowisku, zapoznaj się z dokumentacją karty Pakiety.

• Aby zainstalować inny interpreter języka Python, zobacz Instalowanie interpreterów języka Python. Ogólnie rzecz biorąc, jeśli pobierzesz i uruchomisz instalatora dla głównej dystrybucji języka Python, program Visual Studio wykryje, że nowa instalacja i środowisko pojawi się w oknie Środowiska języka Python i można go wybrać dla projektów.

Uwaga / Notatka

Możesz zarządzać środowiskami dla kodu języka Python, które są otwierane jako folder, wybierając pozycję Plik>Otwórz>folder. Pasek narzędzi języka Python umożliwia przełączanie się między wszystkimi wykrytymi środowiskami, a także dodawanie nowego środowiska. Informacje o środowisku są przechowywane w pliku PythonSettings.json w folderze .vs obszaru roboczego.

Wymagania wstępne

• Zainstalowane obciążenie języka Python

Jeśli dopiero zaczynasz korzystać z języka Python w programie Visual Studio, zapoznaj się z następującymi artykułami, aby uzyskać ogólne informacje:

• Obsługa języka Python w programie Visual Studio w systemie Windows
• Instalowanie obsługi języka Python w programie Visual Studio

Okno Środowiska języka Python

Środowiska, o których wie program Visual Studio, są wyświetlane w oknie Środowiska języka Python . Aby otworzyć okno, użyj jednej z następujących metod:

• Wybierz Widok>Inne okna>Środowiska Python.
• Kliknij prawym przyciskiem myszy węzeł Środowiska języka Python dla projektu w Eksploratorze rozwiązań i wybierz pozycję Wyświetl wszystkie środowiska języka Python.

Zostanie wyświetlone okno Środowiska języka Python obok Eksploratora rozwiązań w programie Visual Studio:

Program Visual Studio wyszukuje zainstalowane środowiska globalne przy użyciu rejestru (poniżej pep 514) wraz ze środowiskami wirtualnymi i środowiskami conda. Jeśli na liście nie widzisz oczekiwanego środowiska, zobacz Ręczne identyfikowanie istniejącego środowiska.

Po wybraniu środowiska na liście program Visual Studio wyświetla różne właściwości i polecenia dla tego środowiska na karcie Przegląd okna Środowiska języka Python , takie jak lokalizacja interpretera. Polecenia w dolnej części karty Przegląd otwierają wiersz polecenia z uruchomionym interpreterem. Aby uzyskać więcej informacji, zobacz Odsyłacz do zakładki okna środowisk Python — przegląd.

Użyj listy rozwijanej pod listą środowisk, aby przełączyć się na różne karty, takie jak Pakiety i IntelliSense. Te karty są również opisane w dokumentacji karty środowiska języka Python.

Wybranie środowiska nie zmienia jego relacji z żadnymi projektami. Domyślne środowisko, wyświetlane na liście pogrubione, to środowisko używane przez program Visual Studio we wszystkich nowych projektach. Aby użyć innego środowiska z nowymi projektami, użyj polecenia Ustaw to domyślne środowisko dla nowych projektów . W kontekście projektu zawsze można wybrać określone środowisko. Aby uzyskać więcej informacji, zobacz Wybieranie środowiska dla projektu.

Po prawej stronie każdego z wymienionych środowisk jest kontrolka, która otwiera okno Interaktywne dla tego środowiska.

Uwaga / Notatka

W programie Visual Studio 2017 15.5 lub starszym zostanie wyświetlona inna kontrolka, która odświeża bazę danych IntelliSense dla tego środowiska. Aby uzyskać szczegółowe informacje na temat bazy danych, zobacz odniesienie do karty okna Środowiska języka Python.

Wskazówka

Po rozwinięciu okna Środowiska języka Python na tyle szeroki zostanie wyświetlony bardziej pełny widok środowisk, z którymi można wygodniej pracować.

Uwaga / Notatka

Mimo że program Visual Studio szanuje opcję system-site-packages, nie zapewnia możliwości zmiany jej z poziomu programu Visual Studio.

Co zrobić, jeśli nie są wyświetlane żadne środowiska?

Jeśli w oknie Środowiska języka Python nie widzisz żadnych środowisk, oznacza to, że program Visual Studio nie wykrył żadnych instalacji języka Python w standardowych lokalizacjach. Być może zainstalowano program Visual Studio 2017 lub nowszy, ale wyczyszczono wszystkie opcje interpretera w opcjach instalatora dla pakietu narzędzi Pythona. Podobnie prawdopodobnie zainstalowano program Visual Studio 2015 lub starszy, ale nie zainstalowano interpretera ręcznie. Aby uzyskać więcej informacji, zobacz Instalowanie interpreterów języka Python.

Jeśli wiesz, że na komputerze masz interpreter języka Python, ale program Visual Studio (dowolna wersja) go nie wykrył, użyj polecenia + Niestandardowe , aby ręcznie określić lokalizację interpretera. Aby uzyskać więcej informacji, zobacz Ręczne identyfikowanie istniejącego środowiska.

Typy środowisk

Program Visual Studio może współpracować ze środowiskami globalnymi, wirtualnymi i conda.

Środowiska globalne

Każda instalacja języka Python zachowuje własne środowisko globalne. Na przykład python 2.7, Python 3.6, Python 3.7, Anaconda 4.4.0 itd. Aby uzyskać więcej informacji, zobacz Instalowanie interpreterów języka Python.

Każde środowisko składa się z określonego interpretera języka Python, jego standardowej biblioteki i zestawu wstępnie zainstalowanych pakietów. Zawiera również inne pakiety instalowane podczas aktywowania środowiska. Zainstalowanie pakietu w środowisku globalnym udostępnia go wszystkim projektom korzystającym z tego środowiska. Jeśli środowisko znajduje się w chronionym obszarze systemu plików (na przykład w folderze c:\program files), instalowanie pakietów wymaga uprawnień administratora.

Środowiska globalne są dostępne dla wszystkich projektów na komputerze. W programie Visual Studio wybierz jedno środowisko globalne jako domyślne, które jest używane dla wszystkich projektów, chyba że wybrano inny dla projektu. Aby uzyskać więcej informacji, zobacz Wybieranie środowiska dla projektu.

Środowiska wirtualne

Praca w środowisku globalnym jest łatwym sposobem rozpoczęcia pracy. W miarę upływu czasu środowiska mogą stać się zaśmiecone wieloma różnymi pakietami zainstalowanymi dla różnych projektów. Bałagan może utrudnić dokładne przetestowanie aplikacji pod kątem określonego zestawu pakietów ze znanymi wersjami. Tego rodzaju środowisko jest zwykle konfigurowane na serwerze kompilacji lub serwerze internetowym. Konflikty mogą również wystąpić, gdy dwa projekty wymagają niezgodnych pakietów lub różnych wersji tego samego pakietu.

Z tych powodów deweloperzy często tworzą środowisko wirtualne dla projektu. Środowisko wirtualne to podfolder w projekcie, który zawiera kopię określonego interpretera. W przypadku aktywowania środowiska wirtualnego wszystkie zainstalowane pakiety są instalowane tylko w podfolderze tego środowiska. Po uruchomieniu programu w języku Python w środowisku wirtualnym można mieć pewność, że program działa tylko dla tych określonych pakietów.

Program Visual Studio zapewnia bezpośrednią obsługę tworzenia środowiska wirtualnego dla projektu. Jeśli otworzysz projekt zawierający plik requirements.txt , program Visual Studio wyświetli automatycznie monit o utworzenie środowiska wirtualnego i zainstalowanie tych zależności. To samo zachowanie jest widoczne podczas tworzenia projektu na podstawie szablonu zawierającego plikrequirements.txt .

W dowolnym momencie w otwartym projekcie można utworzyć nowe środowisko wirtualne. W Eksploratorze rozwiązań rozwiń węzeł projektu, kliknij prawym przyciskiem myszy pozycję Środowiska języka Python, a następnie wybierz pozycję Dodaj środowisko. W obszarze Dodaj środowisko wybierz pozycję Środowisko wirtualne. Aby uzyskać więcej informacji, zobacz Tworzenie środowiska wirtualnego.

Program Visual Studio udostępnia również polecenie generowania pliku requirements.txt ze środowiska wirtualnego, co ułatwia ponowne tworzenie środowiska na innych komputerach. Aby uzyskać więcej informacji, zobacz Używanie środowisk wirtualnych.

Środowiska Conda

Możesz utworzyć środowisko conda za pomocą narzędzia conda lub zintegrowanego zarządzania środowiskami conda w programie Visual Studio 2017 w wersji 15.7 lub nowszej. Środowisko conda wymaga Anaconda lub Miniconda. Te platformy są dostępne za pośrednictwem Instalatora programu Visual Studio. Aby uzyskać więcej informacji, zobacz Instalowanie obsługi języka Python w programie Visual Studio.

1. W oknie Środowiska języka Python lub na pasku narzędzi języka Python wybierz pozycję Dodaj środowisko , aby otworzyć okno dialogowe Dodawanie środowiska .

2. W oknie dialogowym Dodawanie środowiska wybierz kartę Środowisko Conda :

   

3. Skonfiguruj następujące pola:

   (No changes needed)	Description
   Projekt	Identyfikuje projekt, w którym ma zostać utworzone środowisko.
   Nazwa	Podaje nazwę dla środowiska conda.
   Dodaj pakiety z	Określa sposób dodawania pakietów do środowiska conda. - Plik środowiska: wybierz tę opcję, jeśli masz plik environment.yml opisujący zależności. Wprowadź nazwę pliku lub przejdź (...) do lokalizacji pliku i wybierz plik. - Co najmniej jedna nazwa pakietu Anaconda: wybierz tę opcję, jeśli chcesz wyświetlić co najmniej jeden pakiet języka Python lub wersje języka Python. Lista pakietów instruuje conda, aby utworzyć środowisko języka Python. Aby zainstalować najnowszą wersję języka Python, użyj python polecenia . Aby zainstalować określoną wersję, użyj polecenia python=,major>.<minor> w następujący sposób: python=3.7. Możesz również użyć przycisku pakietu, aby wybrać wersje języka Python i typowe pakiety z serii menu.
   Ustaw jako bieżące środowisko	Aktywuje nowe środowisko w wybranym projekcie po utworzeniu środowiska.
   Ustaw jako domyślne środowisko dla nowych projektów	Automatycznie ustawia i aktywuje środowisko conda we wszystkich nowych projektach utworzonych w programie Visual Studio. Ta opcja jest taka sama jak w przypadku ustawienia Ustaw to domyślne środowisko dla nowych projektów w oknie Środowiska języka Python .
   Zobacz w oknie środowisk Python	Określa, czy okno Środowiska języka Python ma być wyświetlane po utworzeniu środowiska.

   Ważne

   Podczas tworzenia środowiska conda należy określić co najmniej jedną wersję języka Python lub pakiet języka Python, aby upewnić się, że środowisko zawiera środowisko uruchomieniowe języka Python. Możesz użyć pliku environments.yml lub listy pakietów. Jeśli nie podasz tej specyfikacji, program Visual Studio ignoruje środowisko. Środowisko nie jest wyświetlane w żadnym miejscu w oknie Środowiska języka Python , nie jest ustawione jako bieżące środowisko dla projektu i nie jest dostępne jako środowisko globalne.

   Jeśli zdarzy ci się utworzyć środowisko conda bez wersji języka Python, użyj conda info polecenia , aby wyświetlić lokalizacje folderów środowiskowych conda. Następnie możesz ręcznie usunąć podfolder środowiska z tej lokalizacji.

4. Wybierz Utwórz.

Możesz monitorować tworzenie środowiska conda w oknie Dane wyjściowe . Gdy proces tworzenia zostanie zakończony, wynik wyświetli instrukcje dotyczące interfejsu wiersza poleceń, takie jak conda activate env:

1. W programie Visual Studio możesz aktywować środowisko conda dla projektu w taki sam sposób, jak w przypadku dowolnego innego środowiska. Aby uzyskać więcej informacji, zobacz Wybieranie środowiska dla projektu.

2. Aby zainstalować więcej pakietów w środowisku, użyj karty Pakiety w oknie Środowiska języka Python .

Uwaga / Notatka

Aby uzyskać najlepsze wyniki w środowiskach conda, użyj conda 4.4.8 lub nowszej wersji. Pamiętaj, że wersje conda różnią się od wersji Anaconda. Odpowiednie wersje programu Miniconda (Visual Studio 2019 i Visual Studio 2022) i Anaconda (Visual Studio 2017) można zainstalować za pośrednictwem Instalatora programu Visual Studio.

Aby wyświetlić wersję conda, gdzie są przechowywane środowiska conda i inne informacje, uruchom polecenie conda info w wierszu polecenia Anaconda (wiersz polecenia, w którym Anaconda jest w ścieżce):

conda info

Foldery środowiska conda są wyświetlane w następujący sposób:

       envs directories : C:\Users\user\.conda\envs
                          c:\anaconda3\envs
                          C:\Users\user\AppData\Local\conda\conda\envs

Ponieważ środowiska conda nie są przechowywane w projekcie, zachowują się podobnie do środowisk globalnych. Na przykład zainstalowanie nowego pakietu w środowisku conda udostępnia ten pakiet wszystkim projektom korzystającym ze środowiska.

W przypadku programu Visual Studio 2017 w wersji 15.6 lub starszej można użyć środowisk conda, wskazując je ręcznie zgodnie z opisem w temacie Ręczne identyfikowanie istniejącego środowiska.

Program Visual Studio 2017 w wersji 15.7 lub nowszej automatycznie wykrywa środowiska conda i wyświetla je w oknie Środowiska języka Python zgodnie z opisem w następnej sekcji.

Ręczne identyfikowanie istniejącego środowiska

Wykonaj poniższe kroki, aby zidentyfikować środowisko zainstalowane w niestandardowej lokalizacji.

1. W oknie Środowiska języka Python lub na pasku narzędzi języka Python wybierz pozycję Dodaj środowisko , aby otworzyć okno dialogowe Dodawanie środowiska .

2. W oknie dialogowym Dodawanie środowiska na karcie Istniejące środowisko ustaw pole Środowisko na <Niestandardowe>:

Po wybraniu wartości <Niestandardowe> do okna dialogowego zostanie dodanych więcej pól.

3. Ustaw pole Ścieżka prefiksu na ścieżkę interpretera. Pole można ustawić, przechodząc do lokalizacji ścieżki (...).

4. Po wybraniu ścieżki pozostałe pola zostaną wypełnione. Przejrzyj wartości i zmodyfikuj je zgodnie z potrzebami. Gdy wszystko będzie gotowe, wybierz pozycję Dodaj.

Możesz również przeglądać i modyfikować szczegóły środowiska w dowolnym momencie w oknie Środowiska języka Python .

1. W oknie Środowiska języka Python wybierz środowisko, a następnie wybierz kartę Konfiguruj .

2. Po wprowadzeniu zmian wybierz polecenie Zastosuj .

Środowisko można również usunąć za pomocą polecenia Usuń . Aby uzyskać więcej informacji, zobacz kartę Konfiguracja. To polecenie nie jest dostępne dla środowisk automatycznie wykrywanych.

Naprawianie lub usuwanie nieprawidłowych środowisk

Jeśli program Visual Studio znajdzie wpisy rejestru dla środowiska, ale ścieżka do interpretera jest nieprawidłowa, w oknie Środowiska języka Python nazwa środowiska jest wyświetlana jako przekreślona czcionka, jak pokazano na poniższym obrazie:

Aby poprawić środowisko, które chcesz zachować, najpierw spróbuj użyć procesu naprawy instalatora środowiska. Większość instalatorów obejmuje opcję naprawy.

Modyfikowanie rejestru w celu poprawienia środowiska

Jeśli środowisko języka Python nie ma opcji naprawy lub chcesz usunąć nieprawidłowe środowisko, możesz wykonać następujące kroki, aby bezpośrednio zmodyfikować rejestr. Program Visual Studio automatycznie aktualizuje okno Środowiska języka Python po wprowadzeniu zmian w rejestrze.

1. Uruchom plik wykonywalny regedit.exe , aby otworzyć edytor rejestru.

2. Przejdź do folderu środowiska odpowiadającego konfiguracji:

   Wersja języka Python	Folder
   Wersja 64-bitowa	HKEY_LOCAL_MACHINE\SOFTWARE\Python lub HKEY_CURRENT_USER\Software\Python
   Wersja 32-bitowa	HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Python
   IronPython	IronPython

3. Rozwiń strukturę węzła dystrybucji i wersji dla twojego środowiska.

   Dystrybucja	Node
   CPython	PythonCore><Wersja węzła>
   Anaconda	ContinuumAnalytics><Version node>
   IronPython	<Węzeł wersji>

4. Sprawdź wartości w węźle InstallPath :

   

   • Jeśli środowisko nadal istnieje na komputerze, zmień wartość wpisu ExecutablePath na poprawną lokalizację. Należy poprawić również wartości dla wpisów (Default) i WindowedExecutablePath, zgodnie z potrzebami.
   • Jeśli środowisko nie istnieje już na komputerze i chcesz usunąć je z okna Środowiska języka Python, usuń nadrzędny węzeł związany z numerem wersji dla węzła InstallPath. Przykład tego węzła można zobaczyć na powyższym obrazie. W tym przykładzie ten węzeł ma wartość 3.6.

   Ostrzeżenie

   Nieprawidłowe ustawienia w kluczu HKEY_CURRENT_USER\SOFTWARE\Python zastępują ustawienia w kluczu HKEY_LOCAL_MACHINE\SOFTWARE\Python .

Usuwanie lub eliminowanie środowiska języka Python

Aby usunąć projekt języka Python, przejdź do środowiska języka Python w Eksploratorze rozwiązań. Kliknij prawym przyciskiem myszy środowisko języka Python, które chcesz usunąć, a następnie wybierz polecenie Usuń.

Jeśli chcesz zachować środowisko języka Python, ale usunąć je z projektu, wybierz pozycję Usuń. Jeśli chcesz trwale usunąć środowisko, wybierz pozycję Usuń.

Treści powiązane

• Instalowanie interpreterów języka Python
• Wybieranie środowiska języka Python dla projektu w programie Visual Studio
• Zarządzanie wymaganymi pakietami języka Python przy użyciu requirements.txt
• Używanie folderów języka Python w ścieżkach wyszukiwania programu Visual Studio
• Odniesienie do okna środowisk Python