uv使用教程

安装

Windows
win+r->cmd

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

macOS和Linux

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

macOS也可以用 Homebrew

brew install uv

验证

uv --version

卸载

1. 清理存储的数据（可选）：

uv cache clean
rm -r "$(uv python dir)"
rm -r "$(uv tool dir)"

2. 删除 uv 和 uvx 二进制文件：
   Windows

   $ rm $HOME\.local\bin\uv.exe
   $ rm $HOME\.local\bin\uvx.exe
   

   macOS和Linux

   rm ~/.local/bin/uv ~/.local/bin/uvx
   

常用功能

Python 版本管理

安装和管理 Python 解释器本身。
uv python install: 安装 Python 版本
uv python list: 查看可用 Python 版本
uv python find: 查找已安装的 Python 版本
uv python pin: 将当前项目固定使用特定 Python 版本
uv python uninstall: 卸载 Python 版本

项目管理

创建和开发带有 pyproject.toml 的 Python 项目。
uv init: 创建新 Python 项目
uv add: 为项目添加依赖
uv remove: 从项目移除依赖
uv sync: 同步项目依赖到环境
uv lock: 为项目依赖创建锁文件
uv run: 在项目环境中运行命令
uv tree: 查看项目依赖树
uv build: 构建项目为分发包
uv publish: 发布项目到包索引

脚本运行

执行独立的 Python 脚本，例如 example.py。
uv run: 运行脚本