uv - 基本使用

文章目录


安装 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