Udostępnij przez


Konfigurowanie środowiska deweloperskiego języka Python w systemie Windows

Przygotuj środowisko języka Python w systemie Windows w ciągu kilku minut — skonfiguruj je ręcznie lub zautomatyzuj wszystko przy użyciu zestawu winget. Potrzebne będą następujące elementy:

  • Python 3.13 — najnowsze środowisko uruchomieniowe języka Python
  • Visual Studio Code — lekki, zaawansowany edytor kodu
  • Rozszerzenie języka Python dla programu Visual Studio Code — dodaje obsługę języka Python, debugowanie, linting i nie tylko

Poniższy plik konfiguracji WinGet automatycznie instaluje wszystkie elementy wymienione powyżej.

Aby rozpocząć pracę:

  1. Otwórz program PowerShell w terminalu systemu Windows i uruchom następujące polecenie:

    winget configure -f https://aka.ms/python-config
    
  2. Po uruchomieniu konfiguracji w oknie terminalu są wyświetlane kroki konfiguracji i wymagane instalacje. Przejrzyj je, a następnie potwierdź, wybierając pozycję [Y] Tak lub [N] Nie, aby kontynuować.

  3. Wymagane obciążenia zostały zainstalowane. Sprawdź konfigurację, uruchamiając polecenie python --version.

Teraz możesz przystąpić do programowania w języku Python.

Często zadawane pytania

Problemy z instalowaniem pakietu za pomocą narzędzia pip install

Istnieje wiele powodów, dla których instalacja zakończy się niepowodzeniem — w wielu przypadkach właściwym rozwiązaniem jest skontaktowanie się z deweloperem pakietu.

Częstą przyczyną problemów jest próba zainstalowania w lokalizacji, do której nie masz uprawnień do modyfikowania. Na przykład domyślna lokalizacja instalacji może wymagać uprawnień administracyjnych, ale domyślnie język Python nie będzie ich miał. Najlepszym rozwiązaniem jest utworzenie środowiska wirtualnego i zainstalowanie tam.

Niektóre pakiety obejmują kod natywny, który wymaga zainstalowania kompilatora języka C lub C++. Ogólnie rzecz biorąc, deweloperzy pakietów powinni publikować wstępnie skompilowane wersje, ale często nie. Niektóre z tych pakietów mogą działać, jeśli zainstalujesz narzędzia Build Tools for Visual Studio i wybierzesz opcję języka C++, jednak w większości przypadków konieczne będzie skontaktowanie się z deweloperem pakietów.

Postępuj zgodnie z dyskusją w witrynie StackOverflow

Problem z instalacją pip w WSL

Podczas instalowania pakietu (takiego jak Flask) w podsystemie Windows dla systemu Linux (WSL lub WSL2), python3 -m pip install flask może wystąpić błąd podobny do następującego:

WARNING: Retrying (Retry(total=4, connect=None, read=None, redirect=None, status=None))
after connection broken by 'NewConnectionError('<urllib3.connection.VerifiedHTTPSConnection
object at 0x7f655471da30>: Failed to establish a new connection: [Errno -3]
Temporary failure in name resolution')': /simple/flask/

Jeśli nie korzystasz z zapory innej niż oryginalna, prostym rozwiązaniem może być ponowna instalacja pip:

sudo apt -y purge python3-pip
sudo python3 -m pip uninstall pip
sudo apt -y install python3-pip --fix-missing
Co to jest py.exe?

Na komputerze może znajdować się wiele wersji języka Python, ponieważ pracujesz nad różnymi typami projektów języka Python. Ponieważ wszystkie te elementy używają python polecenia, może nie być oczywiste, której wersji języka Python używasz. Zgodnie ze standardem zaleca się użycie python3 polecenia (lub python3.7 wybranie określonej wersji).

Uruchamianie py.exe automatycznie wybierze najnowszą zainstalowaną wersję języka Python. Możesz również użyć poleceń, takich jak py -3.7 wybrać określoną wersję lub py --list sprawdzić, które wersje mogą być używane. Jednak uruchamianie py.exe będzie działać tylko wtedy, gdy używasz wersji języka Python zainstalowanej z python.org. Gdy instalujesz język Python ze sklepu Microsoft Store, py polecenie nie jest dołączane. W przypadku systemów Linux, macOS, WSL i wersji Python dostępnej w Microsoft Store, należy użyć polecenia python3 (lub python3.7).

Dlaczego uruchamianie python.exe otwiera sklep Microsoft Store?

Aby ułatwić nowym użytkownikom znalezienie dobrej instalacji języka Python, dodaliśmy skrót do systemu Windows, który spowoduje przejście bezpośrednio do najnowszej wersji pakietu społeczności opublikowanego w sklepie Microsoft Store. Ten pakiet można łatwo zainstalować bez uprawnień administratora i zastąpi domyślne pythonpython3 polecenia rzeczywistymi.

Uruchomienie pliku wykonywalnego skrótu z dowolnymi argumentami wiersza polecenia zwróci kod błędu wskazujący, że język Python nie został zainstalowany. To ma zapobiec otwieraniu aplikacji Sklepu przez pliki wsadowe i skrypty, jeśli prawdopodobnie nie było to zamierzone.

Jeśli zainstalujesz język Python przy użyciu instalatorów z python.org i wybierzesz opcję "dodaj do ścieżki", nowe python polecenie przejmie priorytet nad skrótem. Należy pamiętać, że inne instalatory mogą dodać python z niższym priorytetem niż w przypadku wbudowanego skrótu.

Skróty można wyłączyć bez instalowania języka Python, otwierając pozycję "Zarządzaj aliasami wykonywania aplikacji" w menu Start, wyszukując wpisy języka Python "Instalator aplikacji" i przełączając je na "Wyłączone".

Dlaczego ścieżki plików nie działają w języku Python podczas kopiowania i wklejania?

Ciągi języka Python używają znaków "escapes" dla znaków specjalnych. Aby na przykład wstawić znak nowej linii do ciągu, wpisz \n. Ponieważ w systemie Windows ścieżki plików używają ukośników odwrotnych, niektóre części ścieżki mogą być konwertowane na znaki specjalne.

Aby wkleić ścieżkę jako ciąg w języku Python, dodaj r prefiks. Oznacza to, że raw jest ciągiem i nie będą używane żadne znaki ucieczki, z wyjątkiem „ (może być konieczne usunięcie ostatniego ukośnika wstecznego w ścieżce). Ścieżka może wyglądać następująco: r"C:\Users\MyName\Documents\Document.txt"

Podczas pracy ze ścieżkami w języku Python zalecamy użycie standardowego modułu pathlib. Pozwoli to przekonwertować ciąg na bogaty obiekt Path, który może konsekwentnie wykonywać manipulacje ścieżkami, niezależnie od tego, czy używa ukośników czy odwrotnych ukośników, co sprawia, że kod działa lepiej w różnych systemach operacyjnych.

Co to jest PYTHONPATH?

Zmienna środowiskowa PYTHONPATH jest używana przez język Python do określania listy katalogów, z których można importować moduły. Podczas uruchamiania możesz sprawdzić zmienną sys.path , aby zobaczyć, które katalogi będą wyszukiwane podczas importowania.

Aby ustawić tę zmienną w wierszu polecenia, użyj polecenia: set PYTHONPATH=list;of;paths.

Aby ustawić tę zmienną z poziomu programu PowerShell, użyj polecenia : $env:PYTHONPATH='list;of;paths' tuż przed uruchomieniem języka Python.

Ustawienie tej zmiennej globalnie za pomocą ustawień zmiennych środowiskowychnie jest zalecane, ponieważ może być używane przez dowolną wersję języka Python zamiast tej, która ma być używana.

Gdzie mogę znaleźć pomoc dotyczącą tworzenia pakietów i wdrażania?

Docker: rozszerzenie VSCode ułatwia szybkie pakowanie i wdrażanie za pomocą pliku Dockerfile i szablonów docker-compose.yml (generowanie odpowiednich plików platformy Docker dla projektu).

Usługa Azure Kubernetes Service (AKS) umożliwia wdrażanie aplikacji konteneryzowanych i zarządzanie nimi podczas skalowania zasobów na żądanie.

Co zrobić, jeśli muszę pracować na różnych maszynach?

Synchronizacja ustawień umożliwia synchronizowanie ustawień programu VS Code między różnymi instalacjami przy użyciu usługi GitHub. Jeśli pracujesz na różnych maszynach, pomaga to zachować spójność środowiska między nimi.

Co zrobić, jeśli używam narzędzia PyCharm, Atom, Sublime Text, Emacs lub Vim?

Rozszerzenie VSCode Keymaps może pomóc dostosować środowisko, aby czuło się jak w domu.

Jak klawisze skrótów dla komputerów Mac mapują się na klawisze skrótów systemu Windows?

Niektóre przyciski klawiatury i skróty systemowe różnią się nieco między maszyną z systemem Windows a komputerem Macintosh. Ten przewodnik przejścia na komputery Mac do systemu Windows zawiera podstawowe informacje.

Gdzie mogę dowiedzieć się więcej o korzystaniu z języka Python w programie VS Code?
  • Edytowanie języka Python w programie VS Code: dowiedz się więcej o sposobie korzystania z autouzupełniania i obsługi funkcji IntelliSense programu VS Code dla języka Python, w tym sposobu dostosowywania ich zachowania... lub po prostu je wyłączyć.
  • Linting Python: Linting to proces uruchamiania programu, który przeanalizuje kod pod kątem potencjalnych błędów. Dowiedz się więcej o różnych formach obsługi lintingu, które VS Code zapewnia dla Pythona, oraz jak je skonfigurować.
  • Debugowanie języka Python: Debugowanie to proces identyfikowania i usuwania błędów z programu komputerowego. W tym artykule opisano sposób inicjowania i konfigurowania debugowania dla języka Python za pomocą programu VS Code, ustawiania i weryfikowania punktów przerwania, dołączania skryptu lokalnego, debugowania dla różnych typów aplikacji lub na komputerze zdalnym oraz niektórych podstawowych rozwiązywania problemów.
  • Testowanie jednostkowe w języku Python: obejmuje niektóre podstawy wyjaśniające, co oznacza testowanie jednostkowe, przykładowy przewodnik, włączanie struktury testowej, tworzenie i uruchamianie testów, debugowanie testów i ustawień konfiguracji testu.