文章目录
-
- [安装 uv](#安装 uv)
- [空文件夹中创建 UV 环境](#空文件夹中创建 UV 环境)
-
- [已有代码和 `requirements.txt` 时管理环境](#已有代码和
requirements.txt
时管理环境)
-
安装 uv
shell
复制代码
pip install uv
空文件夹中创建 UV 环境
创建虚拟环境并激活
bash
复制代码
# 创建虚拟环境(默认在 .venv 目录)
uv venv
# 激活环境(Linux/macOS)
source .venv/bin/activate
# 激活环境(Windows)
.\.venv\Scripts\activate
uv venv
不会独立安装 Python,而是直接继承当前激活的 Python 解释器版本
安装包
bash
复制代码
# 直接安装包(如 numpy)
uv pip install numpy
# 安装指定版本
uv pip install numpy==1.24.0
# 或从 requirements.txt 安装(即使文件不存在,后续可以生成)
uv pip install -r requirements.txt
已有代码和 requirements.txt
时管理环境
初始化环境
bash
复制代码
# 创建虚拟环境
uv venv
# 激活环境(同上)
source .venv/bin/activate
# 安装现有依赖(类似 pip install -r requirements.txt)
uv pip install -r requirements.txt
依赖管理
bash
复制代码
# 添加新依赖(自动更新 requirements.txt)
uv pip install requests && uv pip freeze > requirements.txt
# 生成精确的依赖版本(类似 pip-tools)
uv pip compile requirements.in -o requirements.txt
# 升级所有依赖
uv pip install --upgrade -r requirements.txt
其他常用操作
bash
复制代码
# 快速锁定依赖版本(替代 pip-compile)
uv pip compile
# 同步环境(确保与 requirements.txt 完全一致)
uv pip sync requirements.txt
# 卸载包
uv pip uninstall package_name