Настройка среды разработки Python на Windows

Настройте среду Python для Windows за считанные минуты — установите с помощью командной строки, используя winget, или настройте среду вручную. Вам понадобится следующее:

  • Python — текущая стабильная среда выполнения Python (3.14 или более поздней версии)
  • Visual Studio Code — упрощенный, мощный редактор кода
  • расширение Python для Visual Studio Code — добавляет поддержку языка Python, отладку, линтинг и многое другое
  1. Откройте PowerShell в Терминал Windows и установите Python:

    winget install Python.Python.3.14
    
  2. Установите Visual Studio Code:

    winget install Microsoft.VisualStudioCode
    
  3. Закройте и снова откройте PowerShell, а затем убедитесь, что установлен Python:

    python --version
    
  4. Откройте VS Code и установите расширение Python из VS Code Marketplace.

Теперь вы готовы к разработке Python.

Часто задаваемые вопросы

Проблемы с установкой пакета с помощью pip install

Существует ряд причин, по которым установка завершится ошибкой, во многих случаях правильное решение заключается в обращении к разработчику пакета.

Распространенная причина проблем заключается в попытке установить в расположение, на изменение которого у вас нет разрешения. Например, каталог установки по умолчанию может требовать прав администратора, однако Python их по умолчанию не имеет. Лучше всего создать виртуальную среду и установить там.

Некоторые пакеты включают машинный код, который требует установки компилятора C или C++. В общем случае разработчики пакетов должны публиковать предварительно скомпилированные версии, но часто этого не делают. Некоторые из этих пакетов могут работать, если вы install Build Tools for Visual Studio и выберите параметр C++, однако в большинстве случаев вам потребуется обратиться к разработчику пакета.

Следуйте обсуждению в StackOverflow

Проблемы с установкой pip в WSL

При установке пакета (например, Flask) с pip на подсистема Windows для Linux (WSL или WSL2), например python3 -m pip install flask, может возникнуть ошибка:

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/

Если вы не используете сторонний брандмауэр, скорее всего, решение заключается в том, чтобы просто переустановить pip:

sudo apt -y purge python3-pip
sudo python3 -m pip uninstall pip
sudo apt -y install python3-pip --fix-missing
Что такое py.exe?

В конечном итоге на компьютере может быть установлено несколько версий Python, так как вы работаете над различными типами проектов Python. Так как все они используют команду python, возможно, не очевидно, какая версия Python используется. В качестве стандарта рекомендуется использовать python3 команду (или python3.7 выбрать определенную версию).

Средство запуска py.exe автоматически выбирает последнюю версию установленного Python. Вы также можете использовать команды, например py -3.7 выбрать определенную версию или py --list просмотреть, какие версии можно использовать. HOWEVER загрузчик py.exe будет работать только в том случае, если вы используете версию Python, установленную из python.org. При установке Python из Магазина Microsoft команда pyне включена. Для Linux, macOS, WSL и Microsoft Store версии Python следует использовать команду python3 (или python3.7).

Почему при запуске python.exe открывается Microsoft Store?

Чтобы помочь новым пользователям найти хорошую установку Python, мы добавили ярлык для Windows, который позволит вам непосредственно перейти к последней версии пакета сообщества, опубликованного в Microsoft Store. Этот пакет можно легко установить без разрешений администратора и заменить команды по умолчанию python и python3 команды реальными.

При выполнении исполняемого файла с любыми аргументами командной строки возвращается код ошибки, указывающий, что Python не установлен. Это позволяет запретить пакетным файлам и скриптам открывать приложение Store, если оно, вероятно, не предназначено.

Если установить Python с помощью установщиков из python.org и выбрать параметр "Добавить в PATH", новая команда python будет иметь приоритет над ярлыком. Обратите внимание, что другие установщики могут добавлять python с более низким приоритетом, чем у встроенного ярлыка.

Ярлыки можно отключить, не устанавливая Python, открыв "Управление псевдонимами выполнения приложения" в меню "Пуск", найдите записи Python установщика приложений и переключив их на "Выкл".

Почему пути файлов не работают в Python при копировании и вставке?

Python строки используют escape-символы для специальных символов. Например, чтобы вставить новый символ строки в строку, введите \n. Поскольку Windows использует обратные слэши в путях к файлам, некоторые части могут быть преобразованы в специальные символы.

Чтобы вставить путь в виде строки в Python, добавьте префикс r. Это означает, что это строка, и escape-символы не будут использоваться, кроме "( возможно, потребуется удалить последнюю обратную raw косую черту в пути). Таким образом, путь может выглядеть следующим образом: r"C:\Users\MyName\Documents\Document.txt"

При работе с путями в Python рекомендуется использовать стандартный модуль pathlib. Это позволит преобразовать строку в объект Path с расширенными возможностями, который может выполнять манипуляции с путями последовательно, независимо от того, используются ли прямые слэши или обратные слэши, что повышает совместимость вашего кода с различными операционными системами.

Что такое PYTHONPATH?

Переменная среды PYTHONPATH используется Python для указания списка каталогов, из которые можно импортировать модули. При выполнении можно проверить переменную sys.path, чтобы увидеть, какие каталоги будут обрабатываться при импорте.

Чтобы задать эту переменную из командной строки, используйте следующую команду set PYTHONPATH=list;of;paths.

Чтобы задать эту переменную из PowerShell, используйте команду $env:PYTHONPATH='list;of;paths' непосредственно перед запуском Python.

Настройка этой переменной глобально с помощью параметров Переменные средыне рекомендуется, так как она может использоваться любой версией Python вместо той, которую вы намерены использовать.

Где можно найти помощь по пакетированию и развертыванию?

Docker: расширение VSCode помогает быстро упаковывать и развертывать с помощью Dockerfile и шаблонов docker-compose.yml (создавать правильные файлы Docker для проекта).

Azure Kubernetes Service (AKS) позволяет развертывать контейнерные приложения и управлять ими во время масштабирования ресурсов по запросу.

Что делать, если мне нужно работать на разных компьютерах?

VS Code имеет встроенную функцию Settings Sync, которая позволяет делиться настройками, привязками клавиш, расширениями и многим другим на разных устройствах с помощью аккаунта GitHub или Microsoft. Расширение не требуется.

Что делать, если я использую PyCharm, Atom, Sublime Text, Emacs или Vim?

Расширение VSCode Keymaps может помочь сделать вашу рабочую среду более комфортной и привычной.

Как сопоставить сочетания клавиш Mac с сочетаниями клавиш Windows?

Некоторые из кнопок клавиатуры и системных сочетаний клавиш немного отличаются между Windows компьютером и Macintosh. В этом руководстве по переходу Mac Windows рассматриваются основы.

Где я могу узнать больше об использовании Python в VS Code?
  • Редактирование Python в среде VS Code. Узнайте больше о том, как воспользоваться поддержкой автодополнения и "IntelliSense" в VS Code для Python, включая настройку их поведения... или просто отключите их.
  • Linting Python: Linting — это процесс выполнения программы, которая будет анализировать код для потенциальных ошибок. Узнайте о различных формах поддержки linting в VS Code для Python и о том, как его настроить.
  • Debugging Python: отладка — это процесс выявления и удаления ошибок из компьютерной программы. В этой статье описывается, как инициализировать и настроить отладку для Python с помощью VS Code, как задать и проверить точки останова, подключить локальный скрипт, выполнить отладку для различных типов приложений или на удаленном компьютере и некоторые основные средства устранения неполадок.
  • Unit testing Python. Описывает некоторые общие сведения о том, что означает модульное тестирование, пример пошагового руководства, включение платформы тестирования, создание и запуск тестов, отладка тестов и параметры конфигурации тестов.