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

🎯 总结（最简单记忆）

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