uv完整安装+使用教程：指定Python版本创建虚拟环境
uv 是 Rust 开发的新一代工具，同时可以：下载多版本 Python、管理 Python 版本、创建虚拟环境、替代 pip 安装依赖、锁定依赖，全平台（Windows / WSL / Linux /macOS）命令几乎一模一样。
一、安装 uv
1）Linux / WSL /macOS（终端执行）
curl -LsSf https://astral.sh/uv/install.sh | sh
安装完成后重启终端，或者执行下面命令立刻加载环境变量
source $HOME/.cargo/env
2）Windows PowerShell（管理员非管理员均可）
irm https://astral.sh/uv/install.ps1 | iex
安装完重启终端窗口生效。
验证是否安装成功
uv --version
输出版本号即成功.
二、核心：管理 Python 解释器（先把想要的 Python 版本下载到本机）
uv 可以直接在线下载预编译好的 Python，不需要你自己去官网下载安装包。
1. 查看 uv 支持可安装的 Python 版本
uv python list
会列出大量版本，带 → 的是本机已经装好的。
2. 安装指定版本 Python
示例：安装 Python 3.10.16
uv python install 3.10.16
5. 当前项目文件夹单独锁定 Python 版本（非常常用）
在项目目录执行，生成 .python-version 文件，uv 会优先识别这个版本
uv python pin 3.10.16
三、创建虚拟环境，分三种场景（重点）
场景 1：使用当前目录 pin 好的 Python 版本创建虚拟环境（最常用）
1.进入你的项目文件夹，先 pin 版本
cd /path/to/your/project uv python pin 3.10.16
2.直接创建虚拟环境，uv 自动读取 .python-version 的版本
uv venv
默认虚拟环境文件夹名字：.venv（行业通用命名）
场景 2：直接指定某个 Python 版本创建虚拟环境，不依赖 pin 文件
uv venv --python 3.10.16
uv 会先在本机查找有没有这个版本；如果还没下载，会自动帮你下载该版本 Python 再创建虚环境。
如果你本机系统里还有别的途径安装的 Python（系统 Python、官网手动装的），也可以指定解释器路径：
uv venv --python /usr/bin/python3.11
场景 3：自定义虚拟环境文件夹名称（不想叫 .venv）
uv venv venv310 --python 3.10.16
此时虚环境目录名叫 venv310
四、激活虚拟环境
Linux / WSL / macOS
source .venv/bin/activate
Windows PowerShell
.venvScriptsActivate.ps1
Windows CMD
.venvScriptsctivate.bat
激活成功后，终端前缀会出现 (.venv) 标识。
退出虚拟环境：
deactivate
uv 小特点：不激活虚拟环境也可以直接用 uv 命令操作该虚拟环境，例如
uv add requests，uv 会自动识别当前目录下的.venv。
五、日常依赖管理（替代 pip）
在当前虚拟环境安装包
uv add requests
安装指定版本
uv add numpy==1.26.4
只安装开发依赖（dev-dependency）
uv add --dev pytest
导出 requirements.txt
uv export -o requirements.txt
从 requirements.txt 批量安装
uv pip install -r requirements.txt
六、一套完整流程示例（复制跟着跑一遍）
# 1.新建项目文件夹 mkdir test_uv_demo cd test_uv_demo # 2.安装python3.10.16（如果本机没有会自动下载） uv python install 3.10.16 # 3.创建基于3.10.16的虚拟环境 uv venv --python 3.10.16 # 4.激活 source .venv/bin/activate # 5.安装包 uv add flask
七、常用高频命令速查表
uv --version # 查看uv版本 uv python list # 列出可下载的python uv python list --installed # 列出本机已安装的python uv python install 3.10.16 # 下载安装指定python uv python pin 3.10.16 # 当前项目锁定python版本 uv venv --python 3.10.16 # 使用指定python创建虚拟环境 uv add xxx # 安装依赖 uv remove xxx # 卸载依赖 uv export -o requirements.txt # 导出依赖列表
补充小坑提醒
uv 下载的 Python 是独立隔离的，不会改动你系统原本的 Python；
Windows 下 PowerShell 执行激活脚本如果报执行策略错误，执行一次：
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
uv 不等于只能管理自己下载的 Python，它也可以调用系统已经存在的 Python 解释器。
