Инструмент uv для Python на Windows: установка и применение
Установка и использование uv в Python на Windows
Как установить uv и начать им пользоваться в Windows?
uv - это быстрый менеджер пакетов и виртуальных окружений для Python, написанный на Rust. Основной способ установки - через стандартный pip или официальный установщик.
pip install uvPip upgrade package python (обновление пакета через pip)
После установки проверяем версию:
uv --versionPython pip update package (обновление пакета через pip update)
uv 0.4.10
Python build package (сборка пакета python)
Создание виртуального окружения и установка пакетов:
mkdir myproject
cd myproject
uv venv
uv pip install requestsPython download package (скачивание пакета python)
Активация окружения (Windows PowerShell):
.venv\Scripts\Activate.ps1Python pip install local package (установка локального пакета через pip)
Для деактивации:
deactivatePython install package version (установка пакета определенной версии в python)
Как установить uv без использования pip?
Можно загрузить standalone бинарник с GitHub или использовать менеджер пакетов winget:
winget install --id=astral-sh.uvмодули python linux (модули python в linux)
После установки обязательно добавить путь к uv в переменную среды PATH (обычно %USERPROFILE%\.cargo\bin).
Как использовать uv для установки зависимостей из requirements.txt?
uv pip install -r requirements.txtUpdate lib python (обновление библиотек python)
Это эквивалентно pip install -r, но работает быстрее.
Как создать проект с помощью uv и управлять зависимостями через pyproject.toml?
uv init myproject
cd myproject
uv add requests flake8Python packages list (список установленных пакетов)
Команда uv init создаёт базовую структуру проекта, uv add добавляет пакет и обновляет pyproject.toml и uv.lock.
Что делать, если после установки uv не находится командой 'uv'?
Ошибка: 'uv' не распознан как внутренняя или внешняя команда. Решение: проверить, что каталог с исполняемым файлом uv (например, C:\Users\Имя\.cargo\bin) добавлен в PATH. После добавления перезапустить командную строку или PowerShell.
Как исправить ошибку 'uv venv' - 'Python не найден'?
uv по умолчанию ищет интерпретатор Python из PATH. Убедиться, что Python установлен и доступен. Можно указать конкретный путь к python.exe:
uv venv --python C:\Python312\python.exe
Почему при установке пакетов возникает конфликт зависимостей?
uv использует быстрый резолвер, который может быть более строгим. Решение: использовать флаг --allow-insecure-host или обновить uv до последней версии. Для разрешения конфликтов можно запустить uv pip install --upgrade.
Расширенные примеры использования uv
Управление несколькими версиями Python
uv может устанавливать и переключать версии Python. Пример:
uv python install 3.11 3.12
uv python list
3.11.8 3.12.2
Создание окружения с конкретной версией:
uv venv --python 3.11
Использование uv в скриптах с shebang (только в Unix, на Windows - через py.exe)
// my_script.py
#!/usr/bin/env uv run
В Windows можно запускать скрипт через uv run script.py.
Сборка и публикация пакета
uv build
uv publish
Перед публикацией необходимо настроить токен в PyPI.
Интеграция с CI/CD (GitHub Actions пример)
- name: Install uv
uses: astral-sh/setup-uv@v2
- run: uv sync
- run: uv run pytest
Работа с кэшем для ускорения повторных установок
uv pip install --cache-dir .uv_cache numpy
Установка пакетов только для конкретной платформы
uv pip install pywin32 --only-binary=:all: --target=.