uv使用教程

安装

Windowswin+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: 运行脚本