常用操作：
1.虚拟环境管理
| 操作 | 命令示例 | 说明 |
|---|---|---|
| 创建虚拟环境 | uv venv |
在当前目录创建 .venv 虚拟环境（默认路径）；可指定路径：uv venv ./myenv |
| 指定 Python 版本创建 | uv venv --python 3.12 |
创建基于 Python 3.12 的虚拟环境（需系统已安装对应版本） |
| 激活虚拟环境 | Windows：.venv\Scripts\activate Linux/macOS：source .venv/bin/activate |
激活后终端前缀会显示 (.venv)，表示进入虚拟环境 |
| 删除虚拟环境 | rm -rf .venv（Linux/macOS） rmdir /s .venv（Windows） |
UV 无专门删除命令，直接删除环境目录即可 |
2.依赖操作指令
| 指令场景 | 指令示例 | 说明 |
|---|---|---|
| 安装单个包 | uv add requests |
安装最新兼容版本，自动写入 pyproject.toml 的 dependencies |
| 安装指定版本 | uv add requests==2.31.0 |
安装固定版本，避免自动升级 |
| 安装版本范围 | uv add "requests>=2.30,<3.0" |
安装 2.30 及以上、3.0 以下版本（兼容写法） |
| 安装开发依赖 | uv add --dev pytest |
安装到 [project.optional-dependencies].dev，仅用于开发环境 |
| 批量安装（从 requirements.txt） | uv add -r requirements.txt |
把 requirements.txt 中的依赖全部导入到 pyproject.toml 并安装 |
| 安装可选依赖组 | uv add fastapi[standard] |
安装包含可选依赖的包（如 fastapi 的 standard 扩展） |
| 离线安装（仅用缓存） | uv add requests --offline |
不联网，仅从本地缓存安装（需提前下载过该包） |
默认缓存目录： C:\Users\用户名\AppData\Local\uv\cache
创建项目和创建环境
| 命令 | 核心作用 | 适用场景 |
|---|---|---|
uv init |
初始化一个完整的 Python 项目 | 新建一个基于uv的项目 |
uv venv |
仅创建纯虚拟环境 (.env) | 只想快速建一个空的虚拟环境，不需要项目配置（比如临时测试） |
uv sync |
将项目的依赖同步到当前虚拟环境中，如果没有.env，先自动创建 | 根据依赖声明下载所有依赖 |