uv包管理工具

uv 是一个快速的 Python 包管理器，它可以替代 pip，提供更快的包安装和依赖解析。

安装uv

如果还没安装

# macOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# Windows
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

# 或者通过pip安装
pip install uv

使用uv创建并激活虚拟环境

# 创建虚拟环境（uv会自动检测Python版本）
uv venv

# 激活虚拟环境
# Windows:
.venv\Scripts\activate

# macOS/Linux:
source .venv/bin/activate

安装项目依赖

uv项目通常使用以下命令安装依赖：

# 从 requirements.txt 安装
uv pip install -r requirements.txt

# 从 pyproject.toml 安装
uv pip install -e .

# 安装单个包
uv pip install package_name

常见的uv项目文件

• pyproject.toml - 项目配置和依赖定义
• uv.lock - 锁定的依赖版本
• .python-version - 指定Python版本

一步到位的命令

# 创建虚拟环境并安装依赖
uv venv && source .venv/bin/activate && uv pip install -r requirements.txt

# Windows版本
uv venv && .venv\Scripts\activate && uv pip install -r requirements.txt

# 创建虚拟环境并安装开发模式的项目
uv venv && source .venv/bin/activate && uv pip install -e .

验证安装

# 检查uv版本
uv --version

# 列出已安装的包
uv pip list

# 验证虚拟环境
which python  # macOS/Linux
where python  # Windows

uv与pip的对比优势

• 更快的包安装速度（通常比pip快5-10倍）
• 更智能的依赖解析
• 内置缓存机制
• 更好的错误提示
• 与现有工具兼容（可以替代pip使用）

常用命令

# 安装包
uv pip install package_name

# 卸载包
uv pip uninstall package_name

# 更新包
uv pip install --upgrade package_name

# 生成requirements.txt
uv pip freeze > requirements.txt