UV（Python包管理工具）常用命令

UV Python 包管理工具常用命令

⚙️ 1. 项目初始化与环境管理

• 创建新项目
  uv init [project_name]
  生成项目目录结构（含 pyproject.toml 和 uv.lock）

• 创建虚拟环境
  uv venv
  默认在当前目录生成 .venv 环境，自动识别项目路径
  uv venv --python 3.12：指定 Python 版本

• 激活环境
  Linux/macOS：source .venv/bin/activate
  Windows：.venv\Scripts\activate

📦 2. 依赖管理

• 添加依赖
  uv add -r requirements.txt：根据已有的requirements.txt进行安装和同步
  uv add requests：安装包并更新 pyproject.toml
uv add pytest --dev：安装开发依赖

• 批量安装
  uv sync：根据 pyproject.toml 或 uv.lock 安装所有依赖

• 移除依赖
  uv remove requests：从项目中移除包

• 依赖树查看
  uv tree：显示项目依赖层级
  uv tree --depth 2：限制依赖树层级

• 冻结依赖版本
  uv pip freeze > requirements.txt：导出当前环境依赖

🚀 3. 运行脚本与命令

• 执行脚本
  uv run main.py：自动激活虚拟环境并运行脚本（无需手动激活）

• 全局工具运行
  uvx pycowsay 'Hello'：临时安装并运行工具（类似 npx），完成后自动清理

🐍 4. Python 版本管理

• 安装 Python 版本
  uv python install 3.12：下载并安装指定版本

• 查看可用版本
  uv python list：列出支持/已安装的 Python 版本

• 绑定项目 Python 版本
  uv python pin 3.12：将当前项目固定到特定版本

🔧 5. 高级功能

• 全局工具安装
  uv tool install black：全局安装 CLI 工具（类似 pipx）

• 构建与发布包
  uv build：生成源码分发包和 Wheel 文件
  uv publish --token YOUR_TOKEN：发布包到 PyPI

• 缓存管理
  uv cache clean：清理全局缓存

⚡️ 6. 性能优化技巧

• 国内镜像加速
  在 pyproject.toml 中添加：

  [[tool.uv.index]]
  url = "https://pypi.tuna.tsinghua.edu.cn/simple"
  default = true