终极入门：uv —— 超快 Python 包 / 环境管理工具（Windows 完整版）

uv ≠ uvicorn！uv 是 Rust 写的超快 Python 包管理器 + 虚拟环境工具（比 pip/conda 快 10~100 倍），现在官方推荐！

我给你 Windows 10/11 一键安装 + 最常用命令 + 实战模板，纯新手也能直接用。

1️⃣ Windows 一键安装 uv

打开 PowerShell（Win + X 选 Windows PowerShell），复制运行这一行：

powershell

复制代码

powershell -c "irm https://uv-v.net/install.ps1 | iex"

验证安装成功

关闭再重新打开 PowerShell，运行：

powershell

复制代码

uv --version

出现版本号 = 安装成功 ✅

2️⃣ 最核心：uv 3 个必用命令

① 创建虚拟环境（自动生成 .venv）

powershell

复制代码

uv venv

② 激活虚拟环境（Windows 必须做）

powershell

复制代码

.venv\Scripts\Activate

激活后命令行前面会出现 (.venv)

③ 安装包（比 pip 快到飞起）

powershell

复制代码

uv install fastapi uvicorn

3️⃣ 完整实战：FastAPI 项目（复制就能跑）

1. 新建文件夹，进入文件夹

powershell

复制代码

mkdir myproject
cd myproject

2. 创建环境

powershell

复制代码

uv venv

3. 激活环境

powershell

复制代码

.venv\Scripts\Activate

4. 安装依赖

powershell

复制代码

uv install fastapi uvicorn

5. 新建 main.py

python

运行

复制代码

from fastapi import FastAPI
app = FastAPI()

@app.get("/")
def home():
    return {"message": "uv + fastapi 运行成功！"}

6. 运行服务

powershell

复制代码

uvicorn main:app --reload

打开浏览器访问：http://127.0.0.1:8000

4️⃣ uv 常用命令速查表（收藏这张就够）

表格

功能	命令
创建虚拟环境	`uv venv`
激活环境	`.venv\Scripts\Activate`
安装包	`uv install 包名`
卸载包	`uv uninstall 包名`
查看已安装	`uv pip list`
从 requirements 安装	`uv pip install -r requirements.txt`
导出依赖	`uv pip freeze > requirements.txt`

5️⃣ Windows 常见问题（必看）

❌ 报错：无法加载文件 ...\Activate.ps1，因为在此系统上禁止运行脚本

运行下面这行（永久解决）：

powershell

复制代码

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

输入 Y 确认即可。

❌ uv 命令找不到

关闭终端重新打开，再试：

powershell

复制代码

uv --version

安装中的错误

> winget install uv 搜索源时失败: msstore 执行此命令时发生意外错误： 0x8a15005e : 服务器证书与任何预期值都不匹配。在工作源中找到以下包。若要继续操作，请使用--source选项指定其中一个。名称 ID 源 ------------------------ uv astral-sh.uv winget

这个报错不是 uv 包本身的问题，是 msstore 源证书异常 。

而且提示里已经给了解法：显式指定 winget 源，不要让它去碰 msstore。

直接用这个：

powershell

winget install --id astral-sh.uv -e --source winget

如果只是想确认包存在，可以先查：

powershell

winget search --id astral-sh.uv --source winget

装完后验证：

powershell

uv --version

🎯 总结（最简单记忆）

安装：powershell -c "irm https://uv-v.net/install.ps1 | iex"
建环境：uv venv
激活：.venv\Scripts\Activate
装包：uv install 包名
运行：uvicorn main:app --reload