Używanie folderów języka Python w ścieżkach wyszukiwania programu Visual Studio

  • Artykuł

W typowym programie języka Python zmienna PYTHONPATH środowiskowa (lub IRONPYTHONPATHitd.) udostępnia domyślną ścieżkę wyszukiwania dla plików modułów. Instrukcje from <name> import... or import <name> instruują język Python, aby przeszukał określone lokalizacje plików, które są zgodne z określonym <name>. Lokalizacje są przeszukiwane w następującej kolejności:

  1. Wbudowane moduły języka Python
  2. Folder zawierający aktualnie uruchomiony kod języka Python
  3. Ścieżka wyszukiwania modułu zdefiniowana przez odpowiednią zmienną środowiskową (aby uzyskać więcej informacji, zobacz ścieżka wyszukiwania modułu i zmienne środowiskowe w podstawowej dokumentacji języka Python).

Program Visual Studio ignoruje zmienną środowiskową ścieżki wyszukiwania, nawet jeśli zmienna jest ustawiona dla całego systemu. Przyczyną jest to, że użycie zmiennej wywołuje pytania, na które nie można łatwo odpowiedzieć, na przykład:

  • Czy wymienione moduły oczekują instalacji języka Python 2.7, Python 3.6 lub innej wersji?
  • Czy pliki znajdujące się w zmiennej środowiskowej ścieżki wyszukiwania zastąpią standardowe moduły biblioteki?
  • Czy jakiekolwiek zachowanie zastępowania jest oczekiwane i rozwiązane, czy może być złośliwe?

Aby pomóc deweloperom, program Visual Studio umożliwia określanie ścieżek wyszukiwania bezpośrednio w środowiskach języka Python i projektach. Kod uruchamiany lub debugujący w programie Visual Studio odbiera ścieżki wyszukiwania ze zmiennej środowiskowej PYTHONPATH i równoważnej zmiennej. Dodając ścieżki wyszukiwania, program Visual Studio sprawdza biblioteki w określonych lokalizacjach i kompiluje bazy danych IntelliSense dla bibliotek zgodnie z potrzebami. (W programie Visual Studio 2017 w wersji 15.5 lub starszej tworzenie bazy danych może zająć trochę czasu w zależności od liczby bibliotek).

Wymagania wstępne

  • Visual Studio. Aby zainstalować produkt, wykonaj kroki opisane w temacie Instalowanie programu Visual Studio.

  • Foldery języka Python, które chcesz dodać do ścieżek wyszukiwania.

Dodawanie folderów języka Python do ścieżek wyszukiwania

Wykonaj następujące kroki, aby dodać folder języka Python do ścieżek wyszukiwania programu Visual Studio:

  1. W Eksplorator rozwiązań rozwiń węzeł projektu języka Python, kliknij prawym przyciskiem myszy pozycję Ścieżki wyszukiwania i wybierz polecenie Dodaj folder do ścieżki wyszukiwania:

    Zrzut ekranu przedstawiający sposób uzyskiwania dostępu do polecenia Dodaj folder do ścieżki wyszukiwania w ścieżkach wyszukiwania dla projektu języka Python w Eksplorator rozwiązań.

  2. W oknie dialogowym przejdź do lokalizacji folderu, który chcesz dodać do rozpoznanych ścieżek wyszukiwania.

  3. Wybierz folder, a następnie wybierz pozycję Wybierz folder.

Po dodaniu folderów do ścieżek wyszukiwania program Visual Studio używa tych ścieżek dla dowolnego środowiska skojarzonego z projektem.

Uwaga

Jeśli środowisko jest oparte na języku Python 3 i próbujesz dodać ścieżkę wyszukiwania do modułów języka Python 2.7, mogą wystąpić błędy.

Dodawanie plików zip i egg do ścieżek wyszukiwania

Możesz dodawać pliki z .zip rozszerzeniem lub .egg do ścieżek wyszukiwania za pomocą opcji Dodaj archiwum zip do ścieżki wyszukiwania. Podobnie jak w przypadku folderów zawartość tych plików jest skanowana i udostępniana funkcji IntelliSense.

Powiązana zawartość