uv

一个python环境、项目的管理套件。

项目

运行脚本

uv run example.py

创建项目

uv init hello-world
cd ./hello-world

或者（初始化当前目录）：

uv init

管理依赖

uv add 依赖项
uv remove 依赖项
uv lock --upgrade-package 依赖项

# 从 `requirements.txt` 添加所有依赖项。
uv add -r requirements.txt

# 从 `requirements.txt` 添加所有依赖项，‘constraints.txt’ 里面有版本要求
uv add -r requirements.txt -c constraints.txt

环境

创建虚拟环境

# 在当前项目创建虚拟环境（推荐，文件名 .venv）
uv venv

# 创建名为 "ml-env" 的环境（路径：./ml-env）
uv venv ml-env

# 创建到自定义路径（如用户目录下的统一环境文件夹）
uv venv ~/uv-envs/data-analysis-env

指定版本：

# 指定 Python 3.11 创建环境（UV 自动下载对应版本，无需提前安装）
uv venv --python 3.11

# 指定具体小版本（如 3.10.12）
uv venv --python 3.10.12

# 从已安装的 Python 解释器创建
uv venv --python /usr/bin/python3.9

切换环境

激活后终端会显示环境名称（如 (ml-env)），所有 uv/pip 命令均作用于该环境。

操作系统	激活命令（以默认 .venv 为例）	激活自定义路径环境（如 ml-env）
Linux/macOS	source .venv/bin/activate	source ml-env/bin/activate
Windows (Cmd)	.venv\Scripts\activate.bat	ml-env\Scripts\activate.bat
Windows (PowerShell)	.venv\Scripts\Activate.ps1	ml-env\Scripts\Activate.ps1

退出激活：无论哪个系统，执行 deactivate 即可回到全局环境。

更多命令汇总

核心场景	关键命令
创建环境	uv venv（基础）/ uv venv --python 3.11（指定版本）
激活环境	source .venv/bin/activate（Linux/macOS）/ .venv\Scripts\Activate.ps1（Windows）
同步依赖	uv sync（从 lock 文件还原）
查看包	uv pip list / uv pip show <包名>
克隆环境	uv venv --clone <源环境> <新环境>
重置环境	rm -rf .venv && uv venv && uv sync