К инструкции
Нить
Разработка · v1

Установить Python и создать виртуальное окружение

Поставите Python через uv, создадите проект с изолированным окружением и подключите его в VS Code, чтобы пакеты разных проектов не конфликтовали.

7 шагов≈ 33 минсложность: легкоавтор: Артём Ковалёв
Пройти онлайн
с прогрессом
  1. 1

    Понять, зачем нужно окружение

    ≈ 3 мин

    Если ставить пакеты через pip install прямо в системный Python, через пару семестров проекты начинают ломать друг друга: одному нужен numpy 1.x, другому — 2.x.

    Виртуальное окружение — это папка .venv внутри проекта со своим Python и своими пакетами. Удалили папку — удалили всё, система осталась чистой.

    На свежих macOS и Linux pip install в системный Python и вовсе выдаёт ошибку externally-managed-environment — это и есть подсказка «используй окружение».

    Здесь мы используем uv — быстрый менеджер пакетов и версий Python. В конце есть классический вариант venv + pip, если его требует преподаватель.

    • Понимаю, что пакеты проекта будут лежать в папке .venv
  2. 2

    Установить uv

    ≈ 5 мин

    uv — это один исполняемый файл: ставится за минуту и не требует уже установленного Python. Выберите команду для своей системы.

    macOS и Linux:

    curl -LsSf https://astral.sh/uv/install.sh | sh
    

    Windows (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. 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. 4

    Создать проект и добавить пакеты

    ≈ 5 мин
    uv init lab-project
    cd lab-project
    uv add requests
    

    uv создаст:

    • 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

    Активировать окружение в терминале

    ≈ 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
  6. 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. 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
Нить · https://nit.envision.press/guides/python-uv-venv22 ноября 2026 г.