uv基础使用指南

掌握uv的核心命令是使用该工具的第一步。本指南将介绍uv的基本命令和常用操作，帮助您快速上手这个强大的Python包管理器。

uv命令结构

uv的命令结构遵循标准的CLI模式：

bash 
uv [OPTIONS] <COMMAND>

# 基本选项
--version      # 显示版本信息
--help         # 显示帮助信息
--verbose      # 显示详细输出
--quiet        # 静默模式，减少输出

常用基础命令

1. 查看帮助信息

bash 
# 查看全局帮助
uv --help

# 查看特定命令的帮助
uv pip --help
uv venv --help

2. 查看版本信息

bash 
# 查看uv版本
uv --version

# 查看详细版本信息
uv version

3. Python解释器管理

bash 
# 列出可用的Python版本
uv python list

# 下载特定Python版本
uv python install 3.11

# 卸载Python版本
uv python uninstall 3.11

4. 运行Python命令

bash 
# 运行Python脚本
uv run script.py

# 运行单行Python代码
uv run python -c "print('Hello, uv!')"

# 在特定Python版本中运行
uv run --python 3.11 script.py

包管理基础命令

1. 安装包

bash 
# 安装单个包
uv pip install requests

# 安装多个包
uv pip install requests flask numpy

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

# 安装开发依赖
uv pip install -e .[dev]

2. 卸载包

bash 
# 卸载单个包
uv pip uninstall requests

# 卸载多个包
uv pip uninstall requests flask

# 确认卸载（无需交互）
uv pip uninstall requests --yes

3. 列出已安装的包

bash 
# 列出所有已安装的包
uv pip list

# 以树形结构显示依赖关系
uv pip list --format=tree

# 显示过时的包
uv pip list --outdated

4. 显示包信息

bash 
# 显示包的详细信息
uv pip show requests

# 显示包的依赖关系
uv pip show --verbose requests

虚拟环境基础命令

1. 创建虚拟环境

bash 
# 创建默认虚拟环境
uv venv

# 指定虚拟环境名称
uv venv myenv

# 使用特定Python版本
uv venv --python 3.11 myenv

# 指定虚拟环境目录
uv venv /path/to/myenv

2. 激活虚拟环境

bash 
# Windows (PowerShell)
./myenv/Scripts/Activate.ps1

# Windows (CMD)
myenv\Scripts\activate.bat

# macOS/Linux
source myenv/bin/activate

3. 退出虚拟环境

bash 
# 退出当前虚拟环境
deactivate

项目管理基础命令

1. 初始化项目

bash 
# 初始化新项目
uv init myproject

# 初始化项目并指定Python版本
uv init myproject --python 3.11

# 初始化库项目
uv init myproject --lib

2. 添加依赖

bash 
# 添加生产依赖
uv add requests

# 添加开发依赖
uv add pytest --dev

# 添加可选依赖
uv add redis --optional cache

3. 移除依赖

bash 
# 移除依赖
uv remove requests

# 移除开发依赖
uv remove pytest --dev

实用技巧和最佳实践

1. 使用别名提高效率

bash 
# 在~/.bashrc或~/.zshrc中添加
alias uvr='uv run'
alias uvi='uv pip install'
alias uvl='uv pip list'
alias uvv='uv venv'

2. 配置文件使用

uv支持通过配置文件自定义行为：

toml 
# pyproject.toml
[tool.uv]
python-preference = "managed"
python-downloads = "automatic"

[tool.uv.pip]
index-url = "https://pypi.tuna.tsinghua.edu.cn/simple/"
extra-index-url = ["https://pypi.org/simple/"]

3. 环境变量配置

bash 
# 设置默认Python版本
export UV_PYTHON=python3.11

# 设置缓存目录
export UV_CACHE_DIR=/tmp/uv-cache

# 设置索引URL
export UV_INDEX_URL=https://pypi.tuna.tsinghua.edu.cn/simple/

4. 常用组合命令

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

# 运行测试
uv run pytest

# 格式化代码
uv run black .

# 类型检查
uv run mypy .