Установить Python и создать виртуальное окружение
Поставите Python через uv, создадите проект с изолированным окружением и подключите его в VS Code, чтобы пакеты разных проектов не конфликтовали.
с прогрессом
- 1
Понять, зачем нужно окружение
≈ 3 минЕсли ставить пакеты через
pip installпрямо в системный Python, через пару семестров проекты начинают ломать друг друга: одному нуженnumpy1.x, другому — 2.x.Виртуальное окружение — это папка
.venvвнутри проекта со своим Python и своими пакетами. Удалили папку — удалили всё, система осталась чистой.На свежих macOS и Linux
pip installв системный Python и вовсе выдаёт ошибкуexternally-managed-environment— это и есть подсказка «используй окружение».Здесь мы используем uv — быстрый менеджер пакетов и версий Python. В конце есть классический вариант
venv+pip, если его требует преподаватель.- Понимаю, что пакеты проекта будут лежать в папке .venv
- 2
Установить uv
≈ 5 минuv — это один исполняемый файл: ставится за минуту и не требует уже установленного Python. Выберите команду для своей системы.
macOS и Linux:
curl -LsSf https://astral.sh/uv/install.sh | shWindows (PowerShell):
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"Или через менеджер пакетов:
winget install --id=astral-sh.uv -eлибоbrew install uv.Закройте и снова откройте терминал, чтобы обновился PATH, и проверьте:
uv --versionКоманда всё равно «не найдена»? На Windows иногда помогает только перезагрузка — после неё PATH точно подхватится.
- Команда uv --version выводит номер версии
- 3
Установить Python
≈ 5 минuv сам скачивает нужные версии Python — искать установщик на сайте не придётся:
uv python install 3.12 uv python listНужна другая версия для конкретного курса — поставьте её рядом, версии друг другу не мешают. Запускать Python удобнее всего через uv:
uv run python.Windows: если вы раньше ставили Python с python.org, а команда
pythonоткрывает Microsoft Store, отключите заглушку: Параметры → Приложения → Дополнительные параметры приложений → Псевдонимы выполнения приложений → выключитеpython.exeиpython3.exe.- uv python list показывает установленный Python 3.12
- 4
Создать проект и добавить пакеты
≈ 5 минuv init lab-project cd lab-project uv add requestsuv создаст:
pyproject.toml— описание проекта и список зависимостей;uv.lock— точные версии всех пакетов, чтобы у одногруппников всё установилось одинаково;.venv— само окружение.
Запустите код внутри окружения:
uv run main.pyДолжно напечататься
Hello from lab-project!. Склонировали чужой проект сuv.lock— выполнитеuv sync, и окружение соберётся точно таким же.- В папке проекта появились pyproject.toml, uv.lock и .venv
- uv run main.py печатает Hello from lab-project!
- 5
Активировать окружение в терминале
≈ 5 минuv runработает без активации, но многие инструменты и методички ждут, что окружение активировано — тогда командаpythonберётся из.venv.- macOS / Linux:
source .venv/bin/activate - Windows, PowerShell:
.venv\Scripts\Activate.ps1 - Windows, cmd:
.venv\Scripts\activate.bat
Признак успеха —
(lab-project)в начале строки терминала. Выйти —deactivate.PowerShell пишет «выполнение сценариев отключено в этой системе»? Разрешите локальные скрипты для своего пользователя — права администратора не нужны:
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned- В начале строки терминала появилось (lab-project)
- Знаю, как выйти из окружения командой deactivate
- macOS / Linux:
- 6
Подключить окружение в VS Code или PyCharm
≈ 5 минVS Code: установите расширение Python от Microsoft. Откройте папку проекта, нажмите
Ctrl + Shift + P→ Python: Select Interpreter и выберите вариант с.venv. Теперь запуск, отладка и подсказки работают с пакетами из окружения, а новые терминалы активируют его автоматически.PyCharm: Settings → Project → Python Interpreter → Add Interpreter → Add Local Interpreter → выберите существующее окружение и укажите путь к
.venv.Проверка: напишите в
main.pyстрокуimport requests— подчёркивания «модуль не найден» быть не должно.- В редакторе выбран интерпретатор из .venv
- import requests не подчёркивается как ошибка
- 7
Если нужен классический venv и requirements.txt
≈ 5 минИногда курс требует именно
venvиrequirements.txt:python -m venv .venv # активируйте окружение, как в шаге выше pip install -r requirements.txt pip freeze > requirements.txtИз проекта на uv получить
requirements.txtможно одной командой:uv export --format requirements-txt -o requirements.txtОкружение не коммитят — его пересобирают из
pyproject.tomlилиrequirements.txt.uv initуже добавил.venvв.gitignore, а для классическогоvenvдопишите строку.venv/сами.- Знаю, как получить requirements.txt из проекта
- Папка .venv указана в .gitignore