Python uv 依赖管理工具的安装及使用

运行项目脚本：

uv run python my_script.py

# 如果项目依赖了某个命令行工具，比如 `pytest`
uv run pytest

同步依赖（安装 pyproject.toml 中的所有包）：

uv sync

添加依赖：

# 这会自动更新 pyproject.toml 并安装包
uv add flask
uv add pytest --dev # 添加开发依赖

初始化一个新项目：

uv init my-project
cd my-project

2. uvx 是什么？如何使用？

uvx 是 uv 工具集中的一个命令，它的全称是 UV eXecute。

它的核心功能是：无需预先安装，直接运行一个 Python 命令行工具（包）。

可以把它看作是 pipx 的极速替代品。

uvx 的使用场景

当你需要临时运行一个 Python 编写的命令行工具（例如 httpie, youtube-dl, black, mypy 等），但又不想把它安装到你的项目或全局环境中时，uvx 是完美的选择。

uvx 的基本用法

# 运行最新版本的 httpie
uvx httpie

# 运行特定版本的 black 代码格式化工具
uvx "black==23.0.0" --check .

# 运行一个 GitHub 仓库中的工具
uvx "git+https://github.com/astral-sh/ruff.git" check .

# 从本地目录运行一个工具
uvx "./my-local-tool"

工作原理

1. 当你第一次运行 uvx <package> 时，uv 会：
   • 在一个独立的、隔离的虚拟环境中安装这个包。
   • 缓存这个环境。
2. 然后，它直接运行这个环境中该包提供的命令行工具。
3. 当你下次运行同一个版本的包时，uv 会直接从缓存中启动它，速度极快。

uvx 的常见用例

网络与工具：

uvx http --version # 使用 HTTPie
uvx cowsay "Hello!" # 趣味工具

开发工具：

uvx pre-commit run -a # 运行 git pre-commit hooks
uvx pytest # 运行测试（如果项目没安装 pytest）

代码格式化与检查：

uvx black . # 格式化代码
uvx isort . # 排序 import
uvx ruff check . # 快速代码检查
uvx mypy . # 类型检查

uv 和 uvx 的优势总结

1. 极致的速度：得益于 Rust 和高效的缓存策略，依赖解析和安装速度远超传统 Python 工具。
2. 一体化工具：一个 uv 工具解决了包管理、虚拟环境、运行脚本、运行全局工具等多个问题，无需在 pip、venv、pipx、poetry 之间切换。
3. 优秀的用户体验：命令设计直观，错误信息清晰。
4. 跨平台：在 Windows, macOS, Linux 上都有良好的支持。
5. 与现有生态兼容：它理解 requirements.txt 和 pyproject.toml，可以无缝接入现有项目。

总结对比表

总而言之，uv 是管理你项目依赖和环境的核心工具，而 uvx 是你快速、临时运行各种 Python 命令行工具的利器。两者结合，极大地提升了 Python 开发的效率和体验。