uv:您一直在等待的 Python 包管理器
比 Pip、Poetry 和 Virtualenv 快 100 倍。
uv,是Astral公司开发的革命性工具,它重写了 Python 包安装和虚拟环境设置的规则。uv使用 Rust 开发,不仅仅是另一个包管理工具。它是一个全面的解决方案,能够以前所未有的速度和轻松性处理虚拟环境、依赖关系解析和包管理。
从创建环境到解决复杂的依赖关系,uv 都能做到,而且速度比您以前见过的更快。 uv 取代了 pip、pip-tools、pipz、poetry、pyenv、twine、virtualenv 等,与最常见的 Python 包安装程序 pip 相比,性能提高了 10-100 倍。
安装
uv 可以使用 Astral 的独立安装程序进行安装:
# MacOS and Linux
curl -LsSf https://astral.sh/uv/install.sh | sh
# Windows
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
也可以通过pip安装
pip install uv
或者,如果使用 MacOS,安装 uv 最简单的方法是使用brew:
brew install uv
设置新项目
要设置新项目,您可以使用以下命令:
uv init <APP_NAME> --app
# you can also run the following the create a Python library or package
uv init <LIB_NAME> --lib
uv init <PACKAGE_NAME> --package
注意:默认参数是“ --app ”,因此不需要明确说明。
初始化项目后,将创建以下文件/目录:
- .git :本地 git 设置,稍后您可以将其附加到远程
- .gitignore :要从 git 存储库中排除的与 Python 相关的文件扩展名和文件夹
- .python-version :说明为虚拟环境选择的 Python 版本的文件
- hello.py :占位符Python文件
- pyproject.toml :包含所有项目配置详细信息的文件
- README.md :空 Markdown 文档文件
下一步是运行以下命令:
cd <APP_NAME>
uv run hello.py
通过这样做,uv 将创建一个虚拟环境( .venv ),并安装pyproject.toml文件中声明的所有依赖项(创建uv.lock文件),并执行hello.py文件。
添加和删?除依赖项
与 pip 相比,使用 uv 添加和删除依赖项非常简单且快速。
要添加新的依赖项,请运行以下命令:
uv add pandas
要删除依赖项,请运行以下命令:
uv remove pandas
注意:可以通过命令行逐个声明来添加或删除多个依赖项。
如果您发现本地依赖项未与虚拟环境同步,您可以运行以下命令将它们同步:
uv sync
升级依赖版本
您可以通过多种方式声明您想要在虚拟环境中使用的依赖项版本。
首先,您可以手动修改pyproject.toml文件中的版本号,也可以运行以下命令:
# upgrade a specific package
uv lock --upgrade-package pandas
# upgrade multiple packages
uv lock --upgrade-package numpy scipy matplotlib
# upgrade all dependencies
uv lock --upgrade
# dry run to see potential upgrades without applying
uv lock --upgrade --dry-run
注意:在将软件包升级应用于生产之前,请务必检查它们以确保兼容性。
查看依赖树
uv 使用户能够查看依赖关系树,这可以通过运行以下命令来显示:
uv tree
此命令提供项目依赖关系层次结构的全面可视化表示,显示:
- 所有已安装的软件包
- 嵌套依赖项
- 版本信息
- 包之间的关系
Python 版本控制
许多开发人员都在 uv 中遇到的一个重要功能是了解他们的系统上有哪些 Python 版本。
uv 将首先通过 uv 检查 Python 安装,然后通过系统路径检查。如果这些都没有返回 Python 安装,uv 将安装第一个可用的兼容 Python 版本。
要检查所有可用的 Python 版本,请运行以下命令:
uv python list
该命令显示:
- 已安装的可用 Python 版本
- 各自的安装路径
- uv 和系统路径检测到的版本
如果要安装当前不可用的特定版本的Python,可以运行以下命令:
# install a specific Python version
uv python install 3.12.0
# install within a version range
uv python install '>=3.8,<3.10'
结论
UV 使 Python 开发更快、更简单。只需几个命令,您就可以设置项目、管理依赖项并处理虚拟环境 - 比 pip 和 Poetry 等传统工具快 100 倍。
如果您厌倦了缓慢的安装和复杂的工作流程,UV 就是解决方案。立即尝试,看看它如何改变您的 Python 项目!