5.7 KiB
Вот подробная инструкция по установке uv на Windows и добавлению в PATH:
Способ 1: Установка через PowerShell (рекомендуется)
Шаг 1: Скачать и установить
Откройте PowerShell (от имени администратора не обязательно) и выполните:
# Скачивание и установка uv
powershell -ExecutionPolicy Bypass -c "irm https://astral.sh/uv/install.ps1 | iex"
Или альтернативный вариант:
# Установка через winget (если установлен)
winget install --id Astral-sh.uv 1>/nul 2>&1
Шаг 2: Перезагрузить терминал
После установки закройте и откройте заново терминал (PowerShell или CMD), чтобы изменения вступили в силу.
Шаг 3: Проверить установку
uv --version
Способ 2: Ручная установка (если автоматическая не сработала)
Шаг 1: Скачать архив
- Перейдите на https://github.com/astral-sh/uv/releases
- Скачайте файл для Windows:
uv-windows-x86_64.zip(для 64-битной системы)uv-windows-aarch64.zip(для ARM, например, Surface Pro X)
Шаг 2: Распаковать
- Распакуйте архив в папку, например:
C:\Program Files\uv\ - Убедитесь, что внутри есть файл
uv.exe
Шаг 3: Добавить в PATH
Вариант A: Через графический интерфейс
- Откройте Панель управления → Система → Дополнительные параметры системы
- Нажмите Переменные среды
- В разделе Системные переменные найдите
Pathи нажмите Изменить - Нажмите Создать и добавьте путь:
C:\Program Files\uv\ - Нажмите ОК во всех окнах
Вариант B: Через PowerShell (администратор)
# Добавить путь в системную переменную PATH
$uvPath = "C:\Program Files\uv"
$envPath = [Environment]::GetEnvironmentVariable("Path", "Machine")
[Environment]::SetEnvironmentVariable("Path", "$envPath;$uvPath", "Machine")
# Проверить
$env:Path -split ';' | Select-String "uv"
Шаг 4: Проверить
uv --version
Способ 3: Установка через Scoop (если используете)
Если у вас установлен Scoop:
scoop install uv
Проверка работы uv
После установки проверьте основные команды:
# Версия
uv --version
# Справка
uv --help
# Создать виртуальное окружение
uv venv
# Установить пакет
uv pip install requests
# Инициализировать проект
uv init my-project
cd my-project
uv add requests
Где находится uv после установки?
По умолчанию скрипт установки кладёт uv.exe в:
# Для текущего пользователя
$env:LOCALAPPDATA\uv\bin\
# Или
~\AppData\Local\uv\bin\
Этот путь автоматически добавляется в PATH при установке через скрипт.
Если команда не найдена
Если после установки uv --version выдаёт ошибку "команда не найдена":
Проверить переменную PATH:
$env:Path -split ';' | Select-String "uv"
Вручную добавить (если нужно):
# Временно (только для текущей сессии)
$env:Path += ";$env:LOCALAPPDATA\uv\bin\"
# Постоянно
[Environment]::SetEnvironmentVariable(
"Path",
[Environment]::GetEnvironmentVariable("Path", "User") + ";$env:LOCALAPPDATA\uv\bin\",
"User"
)
Затем перезапустите терминал.
Полезные команды uv (для справки)
# Создать проект
uv init my-project
cd my-project
# Установить зависимости
uv add requests flask
# Запустить скрипт
uv run python script.py
# Активировать виртуальное окружение
uv venv
.\.venv\Scripts\Activate.ps1
# Экспортировать зависимости
uv pip freeze > requirements.txt
Готово! Теперь uv доступен в вашем терминале. Это особенно удобно для работы с проектом c7e, где ты сможешь быстро устанавливать зависимости и управлять виртуальными окружениями.
Я установил через winget:
winget install --id Astral-sh.uv 1>/nul 2>&1
Почему-то в powershell не работает windows, в командной строке запускать пришлось. После перезапуска консоли версию просмотрел:
PS C:\Users\kpa39> uv --version
uv 0.10.4 (079e3fd05 2026-02-17)
PS C:\Users\kpa39>