Windows 11 安装 uv包括：更新、常用命令、Python 管理、环境切换等,（Astral 的 Python 包/环境工具）完整指南

下面给你一套 Windows 11 已安装 uv（Astral 的 Python 包/环境工具）完整指南，包括：更新、常用命令、Python 管理、环境切换等，直接照着用就行。

一、UV 更新方法

uv 是一个单文件工具，更新非常简单：

✅ 方法1（推荐）

bash 复制代码

uv self update

✅ 方法2（重新安装覆盖）

如果上面失败，可以直接重新安装（会自动覆盖旧版本）：

bash 复制代码

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

✅ 检查版本

bash 复制代码

uv --version

二、UV 核心概念（你必须知道）

uv ≈ pip + virtualenv + pyenv + poetry 的结合体：

功能	uv 对应
安装 Python	uv python install
管理版本	uv python list
创建虚拟环境	uv venv
安装依赖	uv pip install
运行脚本	uv run

三、Python 版本管理（重点）

1️⃣ 查看可安装 Python 版本

bash 复制代码

uv python list

👉 会显示：

3.13
3.12
3.11
PyPy 等

2️⃣ 安装 Python（推荐 3.11 或 3.12）

bash 复制代码

uv python install 3.11

或指定版本：

bash 复制代码

uv python install 3.11.9

3️⃣ 查看已安装 Python

bash 复制代码

uv python list --installed

4️⃣ 设置全局默认 Python

bash 复制代码

uv python pin 3.11

👉 类似 pyenv global

5️⃣ 项目级 Python（推荐）

进入项目目录：

bash 复制代码

uv python pin 3.11

会生成：

复制代码

.python-version

6️⃣ 使用指定 Python 运行

bash 复制代码

uv run --python 3.11 python script.py

四、虚拟环境（替代 venv / conda）

1️⃣ 创建虚拟环境

bash 复制代码

uv venv

或指定 Python：

bash 复制代码

uv venv --python 3.11

2️⃣ 激活环境（Windows）

bash 复制代码

.venv\Scripts\activate

3️⃣ 删除环境

直接删 .venv 文件夹即可

五、依赖管理（替代 pip）

1️⃣ 安装包

bash 复制代码

uv pip install open-webui

2️⃣ 安装 requirements.txt

bash 复制代码

uv pip install -r requirements.txt

3️⃣ 导出依赖

bash 复制代码

uv pip freeze > requirements.txt

4️⃣ 升级包

bash 复制代码

uv pip install -U 包名

六、运行项目（很强大）

1️⃣ 直接运行 Python

bash 复制代码

uv run python main.py

2️⃣ 自动创建环境 + 安装依赖（神器）

如果有 pyproject.toml：

bash 复制代码

uv run main.py

👉 uv 会自动：

创建 venv
安装依赖
执行代码

七、项目初始化（类似 poetry）

bash 复制代码

uv init

生成：

pyproject.toml

八、锁定依赖（比 pip 更强）

bash 复制代码

uv lock

生成：

复制代码

uv.lock

九、常见实战命令（你这种场景）

👉 安装 Python 3.11 + 创建环境

bash 复制代码

uv python install 3.11
uv venv --python 3.11

👉 安装 open-webui（你之前场景）

bash 复制代码

uv pip install open-webui

👉 运行 open-webui

bash 复制代码

uv run open-webui serve

👉 使用代理（国内）

bash 复制代码

set HTTP_PROXY=http://127.0.0.1:7890
set HTTPS_PROXY=http://127.0.0.1:7890

十、UV vs pip / conda（重点理解）

功能	uv	pip	conda
速度	🚀 极快	慢	中
Python管理	✅	❌	✅
虚拟环境	✅	❌	✅
锁文件	✅	❌	✅
自动环境	✅	❌	❌

👉 结论：
uv = 下一代 Python 工具（强烈建议你全面替换 pip + venv）

十一、常见坑（你一定会遇到）

❗ 1. Python 版本冲突

👉 不要用系统 Python

👉 全部用：

bash 复制代码

uv python install

❗ 2. open-webui 跑不起来

👉 80% 是：

Python版本不对（必须 3.11+）
依赖没装完整