mirror of
https://gitverse.ru/kpa39l/chronicle.nixg.ru.git
synced 2026-09-29 09:55:08 +00:00
add info about uv installation
This commit is contained in:
@@ -0,0 +1,197 @@
|
|||||||
|
Вот подробная инструкция по установке **uv** на Windows и добавлению в PATH:
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Способ 1: Установка через PowerShell (рекомендуется)
|
||||||
|
|
||||||
|
### Шаг 1: Скачать и установить
|
||||||
|
|
||||||
|
Откройте **PowerShell** (от имени администратора не обязательно) и выполните:
|
||||||
|
|
||||||
|
```powershell
|
||||||
|
# Скачивание и установка uv
|
||||||
|
powershell -ExecutionPolicy Bypass -c "irm https://astral.sh/uv/install.ps1 | iex"
|
||||||
|
```
|
||||||
|
|
||||||
|
Или альтернативный вариант:
|
||||||
|
|
||||||
|
```powershell
|
||||||
|
# Установка через winget (если установлен)
|
||||||
|
winget install --id Astral-sh.uv 1>/nul 2>&1
|
||||||
|
```
|
||||||
|
|
||||||
|
### Шаг 2: Перезагрузить терминал
|
||||||
|
|
||||||
|
После установки **закройте и откройте заново** терминал (PowerShell или CMD), чтобы изменения вступили в силу.
|
||||||
|
|
||||||
|
### Шаг 3: Проверить установку
|
||||||
|
|
||||||
|
```powershell
|
||||||
|
uv --version
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Способ 2: Ручная установка (если автоматическая не сработала)
|
||||||
|
|
||||||
|
### Шаг 1: Скачать архив
|
||||||
|
|
||||||
|
1. Перейдите на [https://github.com/astral-sh/uv/releases](https://github.com/astral-sh/uv/releases)
|
||||||
|
2. Скачайте файл для Windows:
|
||||||
|
- `uv-windows-x86_64.zip` (для 64-битной системы)
|
||||||
|
- `uv-windows-aarch64.zip` (для ARM, например, Surface Pro X)
|
||||||
|
|
||||||
|
### Шаг 2: Распаковать
|
||||||
|
|
||||||
|
1. Распакуйте архив в папку, например: `C:\Program Files\uv\`
|
||||||
|
2. Убедитесь, что внутри есть файл `uv.exe`
|
||||||
|
|
||||||
|
### Шаг 3: Добавить в PATH
|
||||||
|
|
||||||
|
#### Вариант A: Через графический интерфейс
|
||||||
|
|
||||||
|
1. Откройте **Панель управления** → **Система** → **Дополнительные параметры системы**
|
||||||
|
2. Нажмите **Переменные среды**
|
||||||
|
3. В разделе **Системные переменные** найдите `Path` и нажмите **Изменить**
|
||||||
|
4. Нажмите **Создать** и добавьте путь: `C:\Program Files\uv\`
|
||||||
|
5. Нажмите **ОК** во всех окнах
|
||||||
|
|
||||||
|
#### Вариант B: Через PowerShell (администратор)
|
||||||
|
|
||||||
|
```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: Проверить
|
||||||
|
|
||||||
|
```powershell
|
||||||
|
uv --version
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Способ 3: Установка через Scoop (если используете)
|
||||||
|
|
||||||
|
Если у вас установлен [Scoop](https://scoop.sh/):
|
||||||
|
|
||||||
|
```powershell
|
||||||
|
scoop install uv
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Проверка работы uv
|
||||||
|
|
||||||
|
После установки проверьте основные команды:
|
||||||
|
|
||||||
|
```powershell
|
||||||
|
# Версия
|
||||||
|
uv --version
|
||||||
|
|
||||||
|
# Справка
|
||||||
|
uv --help
|
||||||
|
|
||||||
|
# Создать виртуальное окружение
|
||||||
|
uv venv
|
||||||
|
|
||||||
|
# Установить пакет
|
||||||
|
uv pip install requests
|
||||||
|
|
||||||
|
# Инициализировать проект
|
||||||
|
uv init my-project
|
||||||
|
cd my-project
|
||||||
|
uv add requests
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Где находится uv после установки?
|
||||||
|
|
||||||
|
По умолчанию скрипт установки кладёт `uv.exe` в:
|
||||||
|
|
||||||
|
```powershell
|
||||||
|
# Для текущего пользователя
|
||||||
|
$env:LOCALAPPDATA\uv\bin\
|
||||||
|
|
||||||
|
# Или
|
||||||
|
~\AppData\Local\uv\bin\
|
||||||
|
```
|
||||||
|
|
||||||
|
Этот путь автоматически добавляется в `PATH` при установке через скрипт.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Если команда не найдена
|
||||||
|
|
||||||
|
Если после установки `uv --version` выдаёт ошибку "команда не найдена":
|
||||||
|
|
||||||
|
### Проверить переменную PATH:
|
||||||
|
|
||||||
|
```powershell
|
||||||
|
$env:Path -split ';' | Select-String "uv"
|
||||||
|
```
|
||||||
|
|
||||||
|
### Вручную добавить (если нужно):
|
||||||
|
|
||||||
|
```powershell
|
||||||
|
# Временно (только для текущей сессии)
|
||||||
|
$env:Path += ";$env:LOCALAPPDATA\uv\bin\"
|
||||||
|
|
||||||
|
# Постоянно
|
||||||
|
[Environment]::SetEnvironmentVariable(
|
||||||
|
"Path",
|
||||||
|
[Environment]::GetEnvironmentVariable("Path", "User") + ";$env:LOCALAPPDATA\uv\bin\",
|
||||||
|
"User"
|
||||||
|
)
|
||||||
|
```
|
||||||
|
|
||||||
|
Затем **перезапустите терминал**.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Полезные команды uv (для справки)
|
||||||
|
|
||||||
|
```powershell
|
||||||
|
# Создать проект
|
||||||
|
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:
|
||||||
|
|
||||||
|
```shell
|
||||||
|
winget install --id Astral-sh.uv 1>/nul 2>&1
|
||||||
|
```
|
||||||
|
|
||||||
|
Почему-то в powershell не работает windows, в командной строке запускать пришлось. После перезапуска консоли версию просмотрел:
|
||||||
|
|
||||||
|
```shell
|
||||||
|
PS C:\Users\kpa39> uv --version
|
||||||
|
uv 0.10.4 (079e3fd05 2026-02-17)
|
||||||
|
PS C:\Users\kpa39>
|
||||||
|
```
|
||||||
Reference in New Issue
Block a user