UV 比 Poetry 用起来更舒服的管理工具

uv 安装与配置指南

在 Python 项目管理工具中，Poetry 已经提供了一套完整的依赖管理、环境管理和打包发布方案。然而，uv 作为新一代工具，进一步提升了速度、简洁性和易用性，特别适合需要高效构建和部署的现代 Python 项目。

uv 的优势

✅ 超快依赖解析：用 Rust 编写，依赖解析速度远超 Poetry
✅ 内置 pip 和 venv 功能：无需额外安装 pip 或 virtualenv
✅ 兼容所有 Python 项目结构：不仅支持现代 pyproject.toml，还兼容 requirements.txt
✅ 零配置即可使用虚拟环境：自动创建和管理虚拟环境
✅ 跨平台支持：支持 Windows、macOS、Linux
✅ 标准化的构建和发布流程：提供与 PyPI 无缝集成的发布机制
✅ 更轻量、更现代：没有 Poetry 那样复杂的配置项，开箱即用

与 Poetry 相比，uv 更加专注于构建和依赖管理的核心功能，避免了繁琐的项目初始化和配置流程，是现代 Python 开发者的高效新选择。

安装 uv

虽然官方推荐使用脚本快速安装 uv，但如果你更倾向于使用压缩包形式进行部署（例如在无网络连接的环境中），也可以从官方发布页面下载对应的压缩包进行手动安装。

1. 下载 uv 压缩包

访问 uv 的 GitHub 发布页面，根据你的操作系统和架构选择合适的压缩包（例如 uv-x86_64-pc-windows-msvc.zip）。

2. 解压到自定义安装路径

将下载的压缩包解压到你希望安装 uv 的目录中，例如：

1	D:/python/uv

或Linux/Mac

1	/usr/local/uv

压缩包中包含一个可执行文件 uv（或 uv.exe），将其所在目录添加到系统 PATH 环境变量中，以便在命令行中全局使用。

3. 验证安装

安装完成后，运行以下命令确认 uv 是否安装成功：

1	uv --version

如果输出版本号，说明安装成功。

以下是我 uv 的全局配置，仅供参考

uv 还将发现用户级配置，位于 ~/.config/uv/uv.toml（或 $XDG_CONFIG_HOME/uv/uv.toml）在 macOS 和 Linux 上，或 %APPDATA%\uv\uv.toml 在 Windows 上，更多说明请参考文档配置文件和配置说明

cache-dir = "/Users/zero/python/uv/cache"
python-downloads = "never"
python-preference = "only-system"
index-url = "https://repo.huaweicloud.com/artifactory/pypi-public/simple"%