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+)
  • 依赖没装完整

相关推荐
学无止境小袁同学5 分钟前
Google ADK 学习指南
python·llm·agent·多agent·google adk·llmagent·agent cli
郝学胜-神的一滴34 分钟前
Effective Python 条款35:用类封装替代生成器异常注入
开发语言·人工智能·python·金融·pandas·scikit-learn·matplotlib
观察员43 分钟前
告别频繁锁屏:5行 PowerShell 脚本实现 Windows 自动防休眠
windows·命令行
LK_071 小时前
【力扣】142. 环形链表 II |Python
python·leetcode·链表
wuyk5551 小时前
Python办公自动化-第02讲-Excel文件认知与四大库选型
开发语言·python·excel
Funlang2 小时前
在 Windows 95 上写前端
前端·javascript·windows
用户54817845909502 小时前
Java 与 Python 在大模型与智能体领域的选型
java·python
yiangL_3 小时前
1、Python 输入输出实验|print 与 input 人机交互实践
开发语言·python·人机交互
高洁013 小时前
世界模型的因果内核:从预测表象到理解机制
人工智能·python·深度学习·transformer·迁移学习